# 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: 2023-01-15 22:33+0100\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:11 msgid "**Source code:** :source:`Lib/smtpd.py`" msgstr "**Code source :** :source:`Lib/smtpd.py`" #: library/smtpd.rst:15 msgid "This module offers several classes to implement SMTP (email) servers." msgstr "" #: library/smtpd.rst:23 msgid "" "The :mod:`smtpd` module is deprecated (see :pep:`PEP 594 <594#smtpd>` for " "details). 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:24 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:28 msgid "" "Additionally the SMTPChannel may be extended to implement very specific " "interaction behaviour with SMTP clients." msgstr "" #: library/smtpd.rst:31 msgid "" "The code supports :RFC:`5321`, plus the :rfc:`1870` SIZE and :rfc:`6531` " "SMTPUTF8 extensions." msgstr "" #: includes/wasm-notavail.rst:None msgid ":ref:`Availability `: not Emscripten, not WASI." msgstr "" #: includes/wasm-notavail.rst:5 msgid "" "This module does not work or is not available on WebAssembly platforms " "``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " "more information." msgstr "" #: library/smtpd.rst:37 msgid "SMTPServer Objects" msgstr "" #: library/smtpd.rst:43 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:159 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:53 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:57 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:64 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:74 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:82 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:86 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:93 msgid "*mail_options*:" msgstr "" #: library/smtpd.rst:91 msgid "" "a list of all received parameters to the ``MAIL`` command (the elements are " "uppercase strings; example: ``['BODY=8BITMIME', 'SMTPUTF8']``)." msgstr "" #: library/smtpd.rst:98 msgid "*rcpt_options*:" msgstr "" #: library/smtpd.rst:96 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:100 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:104 msgid "" "Return ``None`` to request a normal ``250 Ok`` response; otherwise return " "the desired response string in :RFC:`5321` format." msgstr "" #: library/smtpd.rst:109 msgid "" "Override this in subclasses to use a custom :class:`SMTPChannel` for " "managing SMTP clients." msgstr "" #: library/smtpd.rst:112 msgid "The *map* constructor argument." msgstr "" #: library/smtpd.rst:115 msgid "*localaddr* and *remoteaddr* may now contain IPv6 addresses." msgstr "" #: library/smtpd.rst:118 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:181 msgid "*decode_data* is now ``False`` by default." msgstr "" #: library/smtpd.rst:128 msgid "DebuggingServer Objects" msgstr "" #: library/smtpd.rst:133 msgid "" "Create a new debugging server. Arguments are as per :class:`SMTPServer`. " "Messages will be discarded, and printed on stdout." msgstr "" #: library/smtpd.rst:138 msgid "PureProxy Objects" msgstr "" #: library/smtpd.rst:143 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:149 msgid "SMTPChannel Objects" msgstr "" #: library/smtpd.rst:154 msgid "" "Create a new :class:`SMTPChannel` object which manages the communication " "between the server and a single SMTP client." msgstr "" #: library/smtpd.rst:157 msgid "*conn* and *addr* are as per the instance variables described below." msgstr "" #: library/smtpd.rst:163 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:168 msgid "" "A dictionary can be specified in *map* to avoid using a global socket map." msgstr "" #: library/smtpd.rst:170 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:175 msgid "" "To use a custom SMTPChannel implementation you need to override the :attr:" "`SMTPServer.channel_class` of your :class:`SMTPServer`." msgstr "" #: library/smtpd.rst:178 msgid "The *decode_data* and *enable_SMTPUTF8* parameters were added." msgstr "" #: library/smtpd.rst:184 msgid "The :class:`SMTPChannel` has the following instance variables:" msgstr "" #: library/smtpd.rst:188 msgid "Holds the :class:`SMTPServer` that spawned this channel." msgstr "" #: library/smtpd.rst:192 msgid "Holds the socket object connecting to the client." msgstr "" #: library/smtpd.rst:196 msgid "" "Holds the address of the client, the second value returned by :func:`socket." "accept `" msgstr "" #: library/smtpd.rst:201 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:207 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:213 msgid "" "Holds a string containing the greeting sent by the client in its \"HELO\"." msgstr "" #: library/smtpd.rst:217 msgid "" "Holds a string containing the address identified in the \"MAIL FROM:\" line " "from the client." msgstr "" #: library/smtpd.rst:222 msgid "" "Holds a list of strings containing the addresses identified in the \"RCPT TO:" "\" lines from the client." msgstr "" #: library/smtpd.rst:227 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:232 msgid "" "Holds the fully qualified domain name of the server as returned by :func:" "`socket.getfqdn`." msgstr "" #: library/smtpd.rst:237 msgid "" "Holds the name of the client peer as returned by ``conn.getpeername()`` " "where ``conn`` is :attr:`conn`." msgstr "" #: library/smtpd.rst:240 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:246 msgid "Command" msgstr "Commande" #: library/smtpd.rst:246 msgid "Action taken" msgstr "" #: library/smtpd.rst:248 msgid "HELO" msgstr "HELO" #: library/smtpd.rst:248 msgid "" "Accepts the greeting from the client and stores it in :attr:" "`seen_greeting`. Sets server to base command mode." msgstr "" #: library/smtpd.rst:250 msgid "EHLO" msgstr "EHLO" #: library/smtpd.rst:250 msgid "" "Accepts the greeting from the client and stores it in :attr:" "`seen_greeting`. Sets server to extended command mode." msgstr "" #: library/smtpd.rst:252 msgid "NOOP" msgstr "NOOP" #: library/smtpd.rst:252 msgid "Takes no action." msgstr "" #: library/smtpd.rst:253 msgid "QUIT" msgstr "QUIT" #: library/smtpd.rst:253 msgid "Closes the connection cleanly." msgstr "" #: library/smtpd.rst:254 msgid "MAIL" msgstr "MAIL" #: library/smtpd.rst:254 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:258 msgid "RCPT" msgstr "RCPT" #: library/smtpd.rst:258 msgid "" "Accepts the \"RCPT TO:\" syntax and stores the supplied addresses in the :" "attr:`rcpttos` list." msgstr "" #: library/smtpd.rst:260 msgid "RSET" msgstr "RSET" #: library/smtpd.rst:260 msgid "" "Resets the :attr:`mailfrom`, :attr:`rcpttos`, and :attr:`received_data`, but " "not the greeting." msgstr "" #: library/smtpd.rst:262 msgid "DATA" msgstr "DATA" #: library/smtpd.rst:262 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:265 msgid "HELP" msgstr "HELP" #: library/smtpd.rst:265 msgid "Returns minimal information on command syntax" msgstr "" #: library/smtpd.rst:266 msgid "VRFY" msgstr "VRFY" #: library/smtpd.rst:266 msgid "Returns code 252 (the server doesn't know if the address is valid)" msgstr "" #: library/smtpd.rst:267 msgid "EXPN" msgstr "EXPN" #: library/smtpd.rst:267 msgid "Reports that the command is not implemented." msgstr ""