forked from AFPy/python-docs-fr
451 lines
12 KiB
Plaintext
451 lines
12 KiB
Plaintext
# 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 <julien@palard.fr>\n"
|
|
"Language-Team: FRENCH <traductions@lists.afpy.org>\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 <https://aiosmtpd.readthedocs.io/>`_ 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) <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 <socket.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_<command>`` 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 ""
|