# Copyright (C) 2001-2018, Python Software Foundation # For licence information, see README file. # msgid "" msgstr "" "Project-Id-Version: Python 3\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2021-09-23 16:16+0200\n" "PO-Revision-Date: 2018-07-03 10:55+0200\n" "Last-Translator: Julien Palard \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: library/smtpd.rst:2 msgid ":mod:`smtpd` --- SMTP Server" msgstr "" #: library/smtpd.rst:10 msgid "**Source code:** :source:`Lib/smtpd.py`" msgstr "**Code source :** :source:`Lib/smtpd.py`" #: library/smtpd.rst:14 msgid "This module offers several classes to implement SMTP (email) servers." msgstr "" #: library/smtpd.rst:16 msgid "" "The `aiosmtpd `_ package is a recommended " "replacement for this module. It is based on :mod:`asyncio` and provides a " "more straightforward API." msgstr "" #: library/smtpd.rst:21 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 "" #: library/smtpd.rst:25 msgid "" "Additionally the SMTPChannel may be extended to implement very specific " "interaction behaviour with SMTP clients." msgstr "" #: library/smtpd.rst:28 msgid "" "The code supports :RFC:`5321`, plus the :rfc:`1870` SIZE and :rfc:`6531` " "SMTPUTF8 extensions." msgstr "" #: library/smtpd.rst:33 msgid "SMTPServer Objects" msgstr "" #: library/smtpd.rst:39 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 "" #: library/smtpd.rst:173 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 "" #: library/smtpd.rst:49 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 "" #: library/smtpd.rst:53 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 "" #: library/smtpd.rst:60 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 "" #: library/smtpd.rst:70 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 "" #: library/smtpd.rst:78 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 "" #: library/smtpd.rst:82 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 "" #: library/smtpd.rst:89 msgid "*mail_options*:" msgstr "" #: library/smtpd.rst:87 msgid "" "a list of all received parameters to the ``MAIL`` command (the elements are " "uppercase strings; example: ``['BODY=8BITMIME', 'SMTPUTF8']``)." msgstr "" #: library/smtpd.rst:94 msgid "*rcpt_options*:" msgstr "" #: library/smtpd.rst:92 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 "" #: library/smtpd.rst:96 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 "" #: library/smtpd.rst:100 msgid "" "Return ``None`` to request a normal ``250 Ok`` response; otherwise return " "the desired response string in :RFC:`5321` format." msgstr "" #: library/smtpd.rst:105 msgid "" "Override this in subclasses to use a custom :class:`SMTPChannel` for " "managing SMTP clients." msgstr "" #: library/smtpd.rst:108 msgid "The *map* constructor argument." msgstr "" #: library/smtpd.rst:111 msgid "*localaddr* and *remoteaddr* may now contain IPv6 addresses." msgstr "" #: library/smtpd.rst:114 msgid "" "The *decode_data* and *enable_SMTPUTF8* constructor parameters, and the " "*kwargs* parameter to :meth:`process_message` when *decode_data* is " "``False``." msgstr "" #: library/smtpd.rst:195 msgid "*decode_data* is now ``False`` by default." msgstr "" #: library/smtpd.rst:124 msgid "DebuggingServer Objects" msgstr "" #: library/smtpd.rst:129 msgid "" "Create a new debugging server. Arguments are as per :class:`SMTPServer`. " "Messages will be discarded, and printed on stdout." msgstr "" #: library/smtpd.rst:134 msgid "PureProxy Objects" msgstr "" #: library/smtpd.rst:139 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 "" #: library/smtpd.rst:145 msgid "MailmanProxy Objects" msgstr "" #: library/smtpd.rst:152 msgid "" ":class:`MailmanProxy` is deprecated, it depends on a ``Mailman`` module " "which no longer exists and therefore is already broken." msgstr "" #: library/smtpd.rst:156 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 "" #: library/smtpd.rst:163 msgid "SMTPChannel Objects" msgstr "" #: library/smtpd.rst:168 msgid "" "Create a new :class:`SMTPChannel` object which manages the communication " "between the server and a single SMTP client." msgstr "" #: library/smtpd.rst:171 msgid "*conn* and *addr* are as per the instance variables described below." msgstr "" #: library/smtpd.rst:177 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 "" #: library/smtpd.rst:182 msgid "" "A dictionary can be specified in *map* to avoid using a global socket map." msgstr "" #: library/smtpd.rst:184 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 "" #: library/smtpd.rst:189 msgid "" "To use a custom SMTPChannel implementation you need to override the :attr:" "`SMTPServer.channel_class` of your :class:`SMTPServer`." msgstr "" #: library/smtpd.rst:192 msgid "The *decode_data* and *enable_SMTPUTF8* parameters were added." msgstr "" #: library/smtpd.rst:198 msgid "The :class:`SMTPChannel` has the following instance variables:" msgstr "" #: library/smtpd.rst:202 msgid "Holds the :class:`SMTPServer` that spawned this channel." msgstr "" #: library/smtpd.rst:206 msgid "Holds the socket object connecting to the client." msgstr "" #: library/smtpd.rst:210 msgid "" "Holds the address of the client, the second value returned by :func:`socket." "accept `" msgstr "" #: library/smtpd.rst:215 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 "" #: library/smtpd.rst:221 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 "" #: library/smtpd.rst:227 msgid "" "Holds a string containing the greeting sent by the client in its \"HELO\"." msgstr "" #: library/smtpd.rst:231 msgid "" "Holds a string containing the address identified in the \"MAIL FROM:\" line " "from the client." msgstr "" #: library/smtpd.rst:236 msgid "" "Holds a list of strings containing the addresses identified in the \"RCPT TO:" "\" lines from the client." msgstr "" #: library/smtpd.rst:241 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 "" #: library/smtpd.rst:246 msgid "" "Holds the fully-qualified domain name of the server as returned by :func:" "`socket.getfqdn`." msgstr "" #: library/smtpd.rst:251 msgid "" "Holds the name of the client peer as returned by ``conn.getpeername()`` " "where ``conn`` is :attr:`conn`." msgstr "" #: library/smtpd.rst:254 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 "" #: library/smtpd.rst:260 msgid "Command" msgstr "Commande" #: library/smtpd.rst:260 msgid "Action taken" msgstr "" #: library/smtpd.rst:262 msgid "HELO" msgstr "HELO" #: library/smtpd.rst:262 msgid "" "Accepts the greeting from the client and stores it in :attr:" "`seen_greeting`. Sets server to base command mode." msgstr "" #: library/smtpd.rst:264 msgid "EHLO" msgstr "EHLO" #: library/smtpd.rst:264 msgid "" "Accepts the greeting from the client and stores it in :attr:" "`seen_greeting`. Sets server to extended command mode." msgstr "" #: library/smtpd.rst:266 msgid "NOOP" msgstr "NOOP" #: library/smtpd.rst:266 msgid "Takes no action." msgstr "" #: library/smtpd.rst:267 msgid "QUIT" msgstr "QUIT" #: library/smtpd.rst:267 msgid "Closes the connection cleanly." msgstr "" #: library/smtpd.rst:268 msgid "MAIL" msgstr "MAIL" #: library/smtpd.rst:268 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 "" #: library/smtpd.rst:272 msgid "RCPT" msgstr "RCPT" #: library/smtpd.rst:272 msgid "" "Accepts the \"RCPT TO:\" syntax and stores the supplied addresses in the :" "attr:`rcpttos` list." msgstr "" #: library/smtpd.rst:274 msgid "RSET" msgstr "RSET" #: library/smtpd.rst:274 msgid "" "Resets the :attr:`mailfrom`, :attr:`rcpttos`, and :attr:`received_data`, but " "not the greeting." msgstr "" #: library/smtpd.rst:276 msgid "DATA" msgstr "DATA" #: library/smtpd.rst:276 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 "" #: library/smtpd.rst:279 msgid "HELP" msgstr "HELP" #: library/smtpd.rst:279 msgid "Returns minimal information on command syntax" msgstr "" #: library/smtpd.rst:280 msgid "VRFY" msgstr "VRFY" #: library/smtpd.rst:280 msgid "Returns code 252 (the server doesn't know if the address is valid)" msgstr "" #: library/smtpd.rst:281 msgid "EXPN" msgstr "EXPN" #: library/smtpd.rst:281 msgid "Reports that the command is not implemented." msgstr ""