# Copyright (C) 2001-2018, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2017-08-10 00:49+0200\n" "PO-Revision-Date: 2018-07-03 10:55+0200\n" "Last-Translator: Julien Palard \n" "Language-Team: LANGUAGE \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/smtpd.rst:2 msgid ":mod:`smtpd` --- SMTP Server" msgstr "" #: ../Doc/library/smtpd.rst:10 msgid "**Source code:** :source:`Lib/smtpd.py`" msgstr "**Code source :** :source:`Lib/smtpd.py`" #: ../Doc/library/smtpd.rst:14 msgid "This module offers several classes to implement SMTP (email) servers." msgstr "" #: ../Doc/library/smtpd.rst:18 msgid "" "The `aiosmtpd `_ package is a recommended " "replacement for this module. It is based on :mod:`asyncio` and provides a " "more straightforward API. :mod:`smtpd` should be considered deprecated." msgstr "" #: ../Doc/library/smtpd.rst:22 msgid "" "Several server implementations are present; one is a generic do-nothing " "implementation, which can be overridden, while the other two offer specific " "mail-sending strategies." msgstr "" #: ../Doc/library/smtpd.rst:26 msgid "" "Additionally the SMTPChannel may be extended to implement very specific " "interaction behaviour with SMTP clients." msgstr "" #: ../Doc/library/smtpd.rst:29 msgid "" "The code supports :RFC:`5321`, plus the :rfc:`1870` SIZE and :rfc:`6531` " "SMTPUTF8 extensions." msgstr "" #: ../Doc/library/smtpd.rst:34 msgid "SMTPServer Objects" msgstr "" #: ../Doc/library/smtpd.rst:40 msgid "" "Create a new :class:`SMTPServer` object, which binds to local address " "*localaddr*. It will treat *remoteaddr* as an upstream SMTP relayer. Both " "*localaddr* and *remoteaddr* should be a :ref:`(host, port) ` " "tuple. The object inherits from :class:`asyncore.dispatcher`, and so will " "insert itself into :mod:`asyncore`'s event loop on instantiation." msgstr "" #: ../Doc/library/smtpd.rst:46 ../Doc/library/smtpd.rst:168 msgid "" "*data_size_limit* specifies the maximum number of bytes that will be " "accepted in a ``DATA`` command. A value of ``None`` or ``0`` means no limit." msgstr "" #: ../Doc/library/smtpd.rst:50 msgid "" "*map* is the socket map to use for connections (an initially empty " "dictionary is a suitable value). If not specified the :mod:`asyncore` " "global socket map is used." msgstr "" #: ../Doc/library/smtpd.rst:54 msgid "" "*enable_SMTPUTF8* determines whether the ``SMTPUTF8`` extension (as defined " "in :RFC:`6531`) should be enabled. The default is ``False``. When ``True``, " "``SMTPUTF8`` is accepted as a parameter to the ``MAIL`` command and when " "present is passed to :meth:`process_message` in the " "``kwargs['mail_options']`` list. *decode_data* and *enable_SMTPUTF8* cannot " "be set to ``True`` at the same time." msgstr "" #: ../Doc/library/smtpd.rst:61 msgid "" "*decode_data* specifies whether the data portion of the SMTP transaction " "should be decoded using UTF-8. When *decode_data* is ``False`` (the " "default), the server advertises the ``8BITMIME`` extension (:rfc:`6152`), " "accepts the ``BODY=8BITMIME`` parameter to the ``MAIL`` command, and when " "present passes it to :meth:`process_message` in the " "``kwargs['mail_options']`` list. *decode_data* and *enable_SMTPUTF8* cannot " "be set to ``True`` at the same time." msgstr "" #: ../Doc/library/smtpd.rst:71 msgid "" "Raise a :exc:`NotImplementedError` exception. Override this in subclasses to " "do something useful with this message. Whatever was passed in the " "constructor as *remoteaddr* will be available as the :attr:`_remoteaddr` " "attribute. *peer* is the remote host's address, *mailfrom* is the envelope " "originator, *rcpttos* are the envelope recipients and *data* is a string " "containing the contents of the e-mail (which should be in :rfc:`5321` " "format)." msgstr "" #: ../Doc/library/smtpd.rst:79 msgid "" "If the *decode_data* constructor keyword is set to ``True``, the *data* " "argument will be a unicode string. If it is set to ``False``, it will be a " "bytes object." msgstr "" #: ../Doc/library/smtpd.rst:83 msgid "" "*kwargs* is a dictionary containing additional information. It is empty if " "``decode_data=True`` was given as an init argument, otherwise it contains " "the following keys:" msgstr "" #: ../Doc/library/smtpd.rst:90 msgid "*mail_options*:" msgstr "" #: ../Doc/library/smtpd.rst:88 msgid "" "a list of all received parameters to the ``MAIL`` command (the elements are " "uppercase strings; example: ``['BODY=8BITMIME', 'SMTPUTF8']``)." msgstr "" #: ../Doc/library/smtpd.rst:95 msgid "*rcpt_options*:" msgstr "" #: ../Doc/library/smtpd.rst:93 msgid "" "same as *mail_options* but for the ``RCPT`` command. Currently no ``RCPT " "TO`` options are supported, so for now this will always be an empty list." msgstr "" #: ../Doc/library/smtpd.rst:97 msgid "" "Implementations of ``process_message`` should use the ``**kwargs`` signature " "to accept arbitrary keyword arguments, since future feature enhancements may " "add keys to the kwargs dictionary." msgstr "" #: ../Doc/library/smtpd.rst:101 msgid "" "Return ``None`` to request a normal ``250 Ok`` response; otherwise return " "the desired response string in :RFC:`5321` format." msgstr "" #: ../Doc/library/smtpd.rst:106 msgid "" "Override this in subclasses to use a custom :class:`SMTPChannel` for " "managing SMTP clients." msgstr "" #: ../Doc/library/smtpd.rst:109 msgid "The *map* constructor argument." msgstr "" #: ../Doc/library/smtpd.rst:112 msgid "*localaddr* and *remoteaddr* may now contain IPv6 addresses." msgstr "" #: ../Doc/library/smtpd.rst:115 msgid "" "The *decode_data* and *enable_SMTPUTF8* constructor parameters, and the " "*kwargs* parameter to :meth:`process_message` when *decode_data* is " "``False``." msgstr "" #: ../Doc/library/smtpd.rst:120 ../Doc/library/smtpd.rst:190 msgid "*decode_data* is now ``False`` by default." msgstr "" #: ../Doc/library/smtpd.rst:125 msgid "DebuggingServer Objects" msgstr "" #: ../Doc/library/smtpd.rst:130 msgid "" "Create a new debugging server. Arguments are as per :class:`SMTPServer`. " "Messages will be discarded, and printed on stdout." msgstr "" #: ../Doc/library/smtpd.rst:135 msgid "PureProxy Objects" msgstr "" #: ../Doc/library/smtpd.rst:140 msgid "" "Create a new pure proxy server. Arguments are as per :class:`SMTPServer`. " "Everything will be relayed to *remoteaddr*. Note that running this has a " "good chance to make you into an open relay, so please be careful." msgstr "" #: ../Doc/library/smtpd.rst:146 msgid "MailmanProxy Objects" msgstr "" #: ../Doc/library/smtpd.rst:151 msgid "" "Create a new pure proxy server. Arguments are as per :class:`SMTPServer`. " "Everything will be relayed to *remoteaddr*, unless local mailman " "configurations knows about an address, in which case it will be handled via " "mailman. Note that running this has a good chance to make you into an open " "relay, so please be careful." msgstr "" #: ../Doc/library/smtpd.rst:158 msgid "SMTPChannel Objects" msgstr "" #: ../Doc/library/smtpd.rst:163 msgid "" "Create a new :class:`SMTPChannel` object which manages the communication " "between the server and a single SMTP client." msgstr "" #: ../Doc/library/smtpd.rst:166 msgid "*conn* and *addr* are as per the instance variables described below." msgstr "" #: ../Doc/library/smtpd.rst:172 msgid "" "*enable_SMTPUTF8* determines whether the ``SMTPUTF8`` extension (as defined " "in :RFC:`6531`) should be enabled. The default is ``False``. *decode_data* " "and *enable_SMTPUTF8* cannot be set to ``True`` at the same time." msgstr "" #: ../Doc/library/smtpd.rst:177 msgid "" "A dictionary can be specified in *map* to avoid using a global socket map." msgstr "" #: ../Doc/library/smtpd.rst:179 msgid "" "*decode_data* specifies whether the data portion of the SMTP transaction " "should be decoded using UTF-8. The default is ``False``. *decode_data* and " "*enable_SMTPUTF8* cannot be set to ``True`` at the same time." msgstr "" #: ../Doc/library/smtpd.rst:184 msgid "" "To use a custom SMTPChannel implementation you need to override the :attr:" "`SMTPServer.channel_class` of your :class:`SMTPServer`." msgstr "" #: ../Doc/library/smtpd.rst:187 msgid "The *decode_data* and *enable_SMTPUTF8* parameters were added." msgstr "" #: ../Doc/library/smtpd.rst:193 msgid "The :class:`SMTPChannel` has the following instance variables:" msgstr "" #: ../Doc/library/smtpd.rst:197 msgid "Holds the :class:`SMTPServer` that spawned this channel." msgstr "" #: ../Doc/library/smtpd.rst:201 msgid "Holds the socket object connecting to the client." msgstr "" #: ../Doc/library/smtpd.rst:205 msgid "" "Holds the address of the client, the second value returned by :func:`socket." "accept `" msgstr "" #: ../Doc/library/smtpd.rst:210 msgid "" "Holds a list of the line strings (decoded using UTF-8) received from the " "client. The lines have their ``\"\\r\\n\"`` line ending translated to ``\"\\n" "\"``." msgstr "" #: ../Doc/library/smtpd.rst:216 msgid "" "Holds the current state of the channel. This will be either :attr:`COMMAND` " "initially and then :attr:`DATA` after the client sends a \"DATA\" line." msgstr "" #: ../Doc/library/smtpd.rst:222 msgid "" "Holds a string containing the greeting sent by the client in its \"HELO\"." msgstr "" #: ../Doc/library/smtpd.rst:226 msgid "" "Holds a string containing the address identified in the \"MAIL FROM:\" line " "from the client." msgstr "" #: ../Doc/library/smtpd.rst:231 msgid "" "Holds a list of strings containing the addresses identified in the \"RCPT TO:" "\" lines from the client." msgstr "" #: ../Doc/library/smtpd.rst:236 msgid "" "Holds a string containing all of the data sent by the client during the DATA " "state, up to but not including the terminating ``\"\\r\\n.\\r\\n\"``." msgstr "" #: ../Doc/library/smtpd.rst:241 msgid "" "Holds the fully-qualified domain name of the server as returned by :func:" "`socket.getfqdn`." msgstr "" #: ../Doc/library/smtpd.rst:246 msgid "" "Holds the name of the client peer as returned by ``conn.getpeername()`` " "where ``conn`` is :attr:`conn`." msgstr "" #: ../Doc/library/smtpd.rst:249 msgid "" "The :class:`SMTPChannel` operates by invoking methods named " "``smtp_`` upon reception of a command line from the client. Built " "into the base :class:`SMTPChannel` class are methods for handling the " "following commands (and responding to them appropriately):" msgstr "" #: ../Doc/library/smtpd.rst:255 msgid "Command" msgstr "Commande" #: ../Doc/library/smtpd.rst:255 msgid "Action taken" msgstr "" #: ../Doc/library/smtpd.rst:257 msgid "HELO" msgstr "HELO" #: ../Doc/library/smtpd.rst:257 msgid "" "Accepts the greeting from the client and stores it in :attr:" "`seen_greeting`. Sets server to base command mode." msgstr "" #: ../Doc/library/smtpd.rst:259 msgid "EHLO" msgstr "EHLO" #: ../Doc/library/smtpd.rst:259 msgid "" "Accepts the greeting from the client and stores it in :attr:" "`seen_greeting`. Sets server to extended command mode." msgstr "" #: ../Doc/library/smtpd.rst:261 msgid "NOOP" msgstr "NOOP" #: ../Doc/library/smtpd.rst:261 msgid "Takes no action." msgstr "" #: ../Doc/library/smtpd.rst:262 msgid "QUIT" msgstr "QUIT" #: ../Doc/library/smtpd.rst:262 msgid "Closes the connection cleanly." msgstr "" #: ../Doc/library/smtpd.rst:263 msgid "MAIL" msgstr "MAIL" #: ../Doc/library/smtpd.rst:263 msgid "" "Accepts the \"MAIL FROM:\" syntax and stores the supplied address as :attr:" "`mailfrom`. In extended command mode, accepts the :rfc:`1870` SIZE " "attribute and responds appropriately based on the value of *data_size_limit*." msgstr "" #: ../Doc/library/smtpd.rst:267 msgid "RCPT" msgstr "RCPT" #: ../Doc/library/smtpd.rst:267 msgid "" "Accepts the \"RCPT TO:\" syntax and stores the supplied addresses in the :" "attr:`rcpttos` list." msgstr "" #: ../Doc/library/smtpd.rst:269 msgid "RSET" msgstr "RSET" #: ../Doc/library/smtpd.rst:269 msgid "" "Resets the :attr:`mailfrom`, :attr:`rcpttos`, and :attr:`received_data`, but " "not the greeting." msgstr "" #: ../Doc/library/smtpd.rst:271 msgid "DATA" msgstr "DATA" #: ../Doc/library/smtpd.rst:271 msgid "" "Sets the internal state to :attr:`DATA` and stores remaining lines from the " "client in :attr:`received_data` until the terminator ``\"\\r\\n.\\r\\n\"`` " "is received." msgstr "" #: ../Doc/library/smtpd.rst:274 msgid "HELP" msgstr "HELP" #: ../Doc/library/smtpd.rst:274 msgid "Returns minimal information on command syntax" msgstr "" #: ../Doc/library/smtpd.rst:275 msgid "VRFY" msgstr "VRFY" #: ../Doc/library/smtpd.rst:275 msgid "Returns code 252 (the server doesn't know if the address is valid)" msgstr "" #: ../Doc/library/smtpd.rst:276 msgid "EXPN" msgstr "EXPN" #: ../Doc/library/smtpd.rst:276 msgid "Reports that the command is not implemented." msgstr ""