forked from AFPy/python-docs-fr
446 lines
13 KiB
Plaintext
446 lines
13 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2001-2023, Python Software Foundation
|
|
# This file is distributed under the same license as the Python package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.11\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2023-07-21 14:55+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\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:11
|
|
msgid "**Source code:** :source:`Lib/smtpd.py`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:15
|
|
msgid "This module offers several classes to implement SMTP (email) servers."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:23
|
|
msgid ""
|
|
"The :mod:`smtpd` module is deprecated (see :pep:`PEP 594 <594#smtpd>` for "
|
|
"details). 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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:28
|
|
msgid ""
|
|
"Additionally the SMTPChannel may be extended to implement very specific "
|
|
"interaction behaviour with SMTP clients."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:31
|
|
msgid ""
|
|
"The code supports :RFC:`5321`, plus the :rfc:`1870` SIZE and :rfc:`6531` "
|
|
"SMTPUTF8 extensions."
|
|
msgstr ""
|
|
|
|
#: ../Doc/includes/wasm-notavail.rst:3
|
|
msgid ":ref:`Availability <availability>`: not Emscripten, not WASI."
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:37
|
|
msgid "SMTPServer Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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) <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:49 ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:93
|
|
msgid "*mail_options*:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:98
|
|
msgid "*rcpt_options*:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:109
|
|
msgid ""
|
|
"Override this in subclasses to use a custom :class:`SMTPChannel` for "
|
|
"managing SMTP clients."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:112
|
|
msgid "The *map* constructor argument."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:115
|
|
msgid "*localaddr* and *remoteaddr* may now contain IPv6 addresses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:123 ../Doc/library/smtpd.rst:181
|
|
msgid "*decode_data* is now ``False`` by default."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:128
|
|
msgid "DebuggingServer Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:138
|
|
msgid "PureProxy Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:149
|
|
msgid "SMTPChannel Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:154
|
|
msgid ""
|
|
"Create a new :class:`SMTPChannel` object which manages the communication "
|
|
"between the server and a single SMTP client."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:157
|
|
msgid "*conn* and *addr* are as per the instance variables described below."
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:168
|
|
msgid ""
|
|
"A dictionary can be specified in *map* to avoid using a global socket map."
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:178
|
|
msgid "The *decode_data* and *enable_SMTPUTF8* parameters were added."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:184
|
|
msgid "The :class:`SMTPChannel` has the following instance variables:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:188
|
|
msgid "Holds the :class:`SMTPServer` that spawned this channel."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:192
|
|
msgid "Holds the socket object connecting to the client."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:196
|
|
msgid ""
|
|
"Holds the address of the client, the second value returned by :func:`socket."
|
|
"accept <socket.socket.accept>`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:213
|
|
msgid ""
|
|
"Holds a string containing the greeting sent by the client in its \"HELO\"."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:217
|
|
msgid ""
|
|
"Holds a string containing the address identified in the \"MAIL FROM:\" line "
|
|
"from the client."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:222
|
|
msgid ""
|
|
"Holds a list of strings containing the addresses identified in the \"RCPT TO:"
|
|
"\" lines from the client."
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:232
|
|
msgid ""
|
|
"Holds the fully qualified domain name of the server as returned by :func:"
|
|
"`socket.getfqdn`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:237
|
|
msgid ""
|
|
"Holds the name of the client peer as returned by ``conn.getpeername()`` "
|
|
"where ``conn`` is :attr:`conn`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:240
|
|
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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:246
|
|
msgid "Command"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:246
|
|
msgid "Action taken"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:248
|
|
msgid "HELO"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:250
|
|
msgid "EHLO"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:252
|
|
msgid "NOOP"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:252
|
|
msgid "Takes no action."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:253
|
|
msgid "QUIT"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:253
|
|
msgid "Closes the connection cleanly."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:254
|
|
msgid "MAIL"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:258
|
|
msgid "RCPT"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:258
|
|
msgid ""
|
|
"Accepts the \"RCPT TO:\" syntax and stores the supplied addresses in the :"
|
|
"attr:`rcpttos` list."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:260
|
|
msgid "RSET"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:260
|
|
msgid ""
|
|
"Resets the :attr:`mailfrom`, :attr:`rcpttos`, and :attr:`received_data`, but "
|
|
"not the greeting."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:262
|
|
msgid "DATA"
|
|
msgstr ""
|
|
|
|
#: ../Doc/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 ""
|
|
|
|
#: ../Doc/library/smtpd.rst:265
|
|
msgid "HELP"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:265
|
|
msgid "Returns minimal information on command syntax"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:266
|
|
msgid "VRFY"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:266
|
|
msgid "Returns code 252 (the server doesn't know if the address is valid)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:267
|
|
msgid "EXPN"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtpd.rst:267
|
|
msgid "Reports that the command is not implemented."
|
|
msgstr ""
|