forked from AFPy/python-docs-fr
464 lines
16 KiB
Plaintext
464 lines
16 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 1990-2016, 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 2.7\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2016-10-30 10:44+0100\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/smtplib.rst:2
|
|
msgid ":mod:`smtplib` --- SMTP protocol client"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:13
|
|
msgid "**Source code:** :source:`Lib/smtplib.py`"
|
|
msgstr "**Code source :** :source:`Lib/smtplib.py`"
|
|
|
|
#: ../Doc/library/smtplib.rst:17
|
|
msgid ""
|
|
"The :mod:`smtplib` module defines an SMTP client session object that can be "
|
|
"used to send mail to any Internet machine with an SMTP or ESMTP listener "
|
|
"daemon. For details of SMTP and ESMTP operation, consult :rfc:`821` (Simple "
|
|
"Mail Transfer Protocol) and :rfc:`1869` (SMTP Service Extensions)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:25
|
|
msgid ""
|
|
"An :class:`SMTP` instance encapsulates an SMTP connection. It has methods "
|
|
"that support a full repertoire of SMTP and ESMTP operations. If the optional "
|
|
"host and port parameters are given, the SMTP :meth:`connect` method is "
|
|
"called with those parameters during initialization. If specified, "
|
|
"*local_hostname* is used as the FQDN of the local host in the HELO/EHLO "
|
|
"command. Otherwise, the local hostname is found using :func:`socket."
|
|
"getfqdn`. If the :meth:`connect` call returns anything other than a success "
|
|
"code, an :exc:`SMTPConnectError` is raised. The optional *timeout* parameter "
|
|
"specifies a timeout in seconds for blocking operations like the connection "
|
|
"attempt (if not specified, the global default timeout setting will be "
|
|
"used). If the timeout expires, :exc:`socket.timeout` is raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:38
|
|
msgid ""
|
|
"For normal use, you should only require the initialization/connect, :meth:"
|
|
"`sendmail`, and :meth:`~smtplib.quit` methods. An example is included below."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:42
|
|
msgid "*timeout* was added."
|
|
msgstr "Ajout de *timeout*."
|
|
|
|
#: ../Doc/library/smtplib.rst:48
|
|
msgid ""
|
|
"An :class:`SMTP_SSL` instance behaves exactly the same as instances of :"
|
|
"class:`SMTP`. :class:`SMTP_SSL` should be used for situations where SSL is "
|
|
"required from the beginning of the connection and using :meth:`starttls` is "
|
|
"not appropriate. If *host* is not specified, the local host is used. If "
|
|
"*port* is omitted, the standard SMTP-over-SSL port (465) is used. "
|
|
"*local_hostname* has the same meaning as it does for the :class:`SMTP` "
|
|
"class. *keyfile* and *certfile* are also optional, and can contain a PEM "
|
|
"formatted private key and certificate chain file for the SSL connection. The "
|
|
"optional *timeout* parameter specifies a timeout in seconds for blocking "
|
|
"operations like the connection attempt (if not specified, the global default "
|
|
"timeout setting will be used). If the timeout expires, :exc:`socket."
|
|
"timeout` is raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:66
|
|
msgid ""
|
|
"The LMTP protocol, which is very similar to ESMTP, is heavily based on the "
|
|
"standard SMTP client. It's common to use Unix sockets for LMTP, so our :meth:"
|
|
"`connect` method must support that as well as a regular host:port server. "
|
|
"*local_hostname* has the same meaning as it does for the :class:`SMTP` "
|
|
"class. To specify a Unix socket, you must use an absolute path for *host*, "
|
|
"starting with a '/'."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:73
|
|
msgid ""
|
|
"Authentication is supported, using the regular SMTP mechanism. When using a "
|
|
"Unix socket, LMTP generally don't support or require any authentication, but "
|
|
"your mileage might vary."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:79
|
|
msgid "A nice selection of exceptions is defined as well:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:84
|
|
msgid ""
|
|
"The base exception class for all the other exceptions provided by this "
|
|
"module."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:90
|
|
msgid ""
|
|
"This exception is raised when the server unexpectedly disconnects, or when "
|
|
"an attempt is made to use the :class:`SMTP` instance before connecting it to "
|
|
"a server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:97
|
|
msgid ""
|
|
"Base class for all exceptions that include an SMTP error code. These "
|
|
"exceptions are generated in some instances when the SMTP server returns an "
|
|
"error code. The error code is stored in the :attr:`smtp_code` attribute of "
|
|
"the error, and the :attr:`smtp_error` attribute is set to the error message."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:105
|
|
msgid ""
|
|
"Sender address refused. In addition to the attributes set by on all :exc:"
|
|
"`SMTPResponseException` exceptions, this sets 'sender' to the string that "
|
|
"the SMTP server refused."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:112
|
|
msgid ""
|
|
"All recipient addresses refused. The errors for each recipient are "
|
|
"accessible through the attribute :attr:`recipients`, which is a dictionary "
|
|
"of exactly the same sort as :meth:`SMTP.sendmail` returns."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:119
|
|
msgid "The SMTP server refused to accept the message data."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:124
|
|
msgid "Error occurred during establishment of a connection with the server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:129
|
|
msgid "The server refused our ``HELO`` message."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:134
|
|
msgid ""
|
|
"SMTP authentication went wrong. Most probably the server didn't accept the "
|
|
"username/password combination provided."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:142
|
|
msgid ":rfc:`821` - Simple Mail Transfer Protocol"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:141
|
|
msgid ""
|
|
"Protocol definition for SMTP. This document covers the model, operating "
|
|
"procedure, and protocol details for SMTP."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:146
|
|
msgid ":rfc:`1869` - SMTP Service Extensions"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:145
|
|
msgid ""
|
|
"Definition of the ESMTP extensions for SMTP. This describes a framework for "
|
|
"extending SMTP with new commands, supporting dynamic discovery of the "
|
|
"commands provided by the server, and defines a few additional commands."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:153
|
|
msgid "SMTP Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:155
|
|
msgid "An :class:`SMTP` instance has the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:160
|
|
msgid ""
|
|
"Set the debug output level. A true value for *level* results in debug "
|
|
"messages for connection and for all messages sent to and received from the "
|
|
"server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:166
|
|
msgid ""
|
|
"Send a command *cmd* to the server. The optional argument *argstring* is "
|
|
"simply concatenated to the command, separated by a space."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:169
|
|
msgid ""
|
|
"This returns a 2-tuple composed of a numeric response code and the actual "
|
|
"response line (multiline responses are joined into one long line.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:172
|
|
msgid ""
|
|
"In normal operation it should not be necessary to call this method "
|
|
"explicitly. It is used to implement other methods and may be useful for "
|
|
"testing private extensions."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:176
|
|
msgid ""
|
|
"If the connection to the server is lost while waiting for the reply, :exc:"
|
|
"`SMTPServerDisconnected` will be raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:182
|
|
msgid ""
|
|
"Connect to a host on a given port. The defaults are to connect to the local "
|
|
"host at the standard SMTP port (25). If the hostname ends with a colon "
|
|
"(``':'``) followed by a number, that suffix will be stripped off and the "
|
|
"number interpreted as the port number to use. This method is automatically "
|
|
"invoked by the constructor if a host is specified during instantiation. "
|
|
"Returns a 2-tuple of the response code and message sent by the server in its "
|
|
"connection response."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:193
|
|
msgid ""
|
|
"Identify yourself to the SMTP server using ``HELO``. The hostname argument "
|
|
"defaults to the fully qualified domain name of the local host. The message "
|
|
"returned by the server is stored as the :attr:`helo_resp` attribute of the "
|
|
"object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:198
|
|
msgid ""
|
|
"In normal operation it should not be necessary to call this method "
|
|
"explicitly. It will be implicitly called by the :meth:`sendmail` when "
|
|
"necessary."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:204
|
|
msgid ""
|
|
"Identify yourself to an ESMTP server using ``EHLO``. The hostname argument "
|
|
"defaults to the fully qualified domain name of the local host. Examine the "
|
|
"response for ESMTP option and store them for use by :meth:`has_extn`. Also "
|
|
"sets several informational attributes: the message returned by the server is "
|
|
"stored as the :attr:`ehlo_resp` attribute, :attr:`does_esmtp` is set to true "
|
|
"or false depending on whether the server supports ESMTP, and :attr:"
|
|
"`esmtp_features` will be a dictionary containing the names of the SMTP "
|
|
"service extensions this server supports, and their parameters (if any)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:214
|
|
msgid ""
|
|
"Unless you wish to use :meth:`has_extn` before sending mail, it should not "
|
|
"be necessary to call this method explicitly. It will be implicitly called "
|
|
"by :meth:`sendmail` when necessary."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:220
|
|
msgid ""
|
|
"This method call :meth:`ehlo` and or :meth:`helo` if there has been no "
|
|
"previous ``EHLO`` or ``HELO`` command this session. It tries ESMTP ``EHLO`` "
|
|
"first."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:225 ../Doc/library/smtplib.rst:256
|
|
#: ../Doc/library/smtplib.rst:280 ../Doc/library/smtplib.rst:330
|
|
msgid ":exc:`SMTPHeloError`"
|
|
msgstr ":exc:`SMTPHeloError`"
|
|
|
|
#: ../Doc/library/smtplib.rst:225 ../Doc/library/smtplib.rst:256
|
|
#: ../Doc/library/smtplib.rst:280 ../Doc/library/smtplib.rst:330
|
|
msgid "The server didn't reply properly to the ``HELO`` greeting."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:231
|
|
msgid ""
|
|
"Return :const:`True` if *name* is in the set of SMTP service extensions "
|
|
"returned by the server, :const:`False` otherwise. Case is ignored."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:237
|
|
msgid ""
|
|
"Check the validity of an address on this server using SMTP ``VRFY``. Returns "
|
|
"a tuple consisting of code 250 and a full :rfc:`822` address (including "
|
|
"human name) if the user address is valid. Otherwise returns an SMTP error "
|
|
"code of 400 or greater and an error string."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:244
|
|
msgid "Many sites disable SMTP ``VRFY`` in order to foil spammers."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:249
|
|
msgid ""
|
|
"Log in on an SMTP server that requires authentication. The arguments are the "
|
|
"username and the password to authenticate with. If there has been no "
|
|
"previous ``EHLO`` or ``HELO`` command this session, this method tries ESMTP "
|
|
"``EHLO`` first. This method will return normally if the authentication was "
|
|
"successful, or may raise the following exceptions:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:259
|
|
msgid ":exc:`SMTPAuthenticationError`"
|
|
msgstr ":exc:`SMTPAuthenticationError`"
|
|
|
|
#: ../Doc/library/smtplib.rst:259
|
|
msgid "The server didn't accept the username/password combination."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:261 ../Doc/library/smtplib.rst:283
|
|
msgid ":exc:`SMTPException`"
|
|
msgstr ":exc:`SMTPException`"
|
|
|
|
#: ../Doc/library/smtplib.rst:262
|
|
msgid "No suitable authentication method was found."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:267
|
|
msgid ""
|
|
"Put the SMTP connection in TLS (Transport Layer Security) mode. All SMTP "
|
|
"commands that follow will be encrypted. You should then call :meth:`ehlo` "
|
|
"again."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:271
|
|
msgid ""
|
|
"If *keyfile* and *certfile* are provided, these are passed to the :mod:"
|
|
"`socket` module's :func:`ssl` function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:274
|
|
msgid ""
|
|
"If there has been no previous ``EHLO`` or ``HELO`` command this session, "
|
|
"this method tries ESMTP ``EHLO`` first."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:283
|
|
msgid "The server does not support the STARTTLS extension."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:287
|
|
msgid ":exc:`RuntimeError`"
|
|
msgstr ":exc:`RuntimeError`"
|
|
|
|
#: ../Doc/library/smtplib.rst:288
|
|
msgid "SSL/TLS support is not available to your Python interpreter."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:293
|
|
msgid ""
|
|
"Send mail. The required arguments are an :rfc:`822` from-address string, a "
|
|
"list of :rfc:`822` to-address strings (a bare string will be treated as a "
|
|
"list with 1 address), and a message string. The caller may pass a list of "
|
|
"ESMTP options (such as ``8bitmime``) to be used in ``MAIL FROM`` commands as "
|
|
"*mail_options*. ESMTP options (such as ``DSN`` commands) that should be used "
|
|
"with all ``RCPT`` commands can be passed as *rcpt_options*. (If you need to "
|
|
"use different ESMTP options to different recipients you have to use the low-"
|
|
"level methods such as :meth:`mail`, :meth:`rcpt` and :meth:`data` to send "
|
|
"the message.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:304
|
|
msgid ""
|
|
"The *from_addr* and *to_addrs* parameters are used to construct the message "
|
|
"envelope used by the transport agents. The :class:`SMTP` does not modify the "
|
|
"message headers in any way."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:308
|
|
msgid ""
|
|
"If there has been no previous ``EHLO`` or ``HELO`` command this session, "
|
|
"this method tries ESMTP ``EHLO`` first. If the server does ESMTP, message "
|
|
"size and each of the specified options will be passed to it (if the option "
|
|
"is in the feature set the server advertises). If ``EHLO`` fails, ``HELO`` "
|
|
"will be tried and ESMTP options suppressed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:314
|
|
msgid ""
|
|
"This method will return normally if the mail is accepted for at least one "
|
|
"recipient. Otherwise it will raise an exception. That is, if this method "
|
|
"does not raise an exception, then someone should get your mail. If this "
|
|
"method does not raise an exception, it returns a dictionary, with one entry "
|
|
"for each recipient that was refused. Each entry contains a tuple of the "
|
|
"SMTP error code and the accompanying error message sent by the server."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:321
|
|
msgid "This method may raise the following exceptions:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:327
|
|
msgid ":exc:`SMTPRecipientsRefused`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:324
|
|
msgid ""
|
|
"All recipients were refused. Nobody got the mail. The :attr:`recipients` "
|
|
"attribute of the exception object is a dictionary with information about the "
|
|
"refused recipients (like the one returned when at least one recipient was "
|
|
"accepted)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:333
|
|
msgid ":exc:`SMTPSenderRefused`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:333
|
|
msgid "The server didn't accept the *from_addr*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:337
|
|
msgid ":exc:`SMTPDataError`"
|
|
msgstr ":exc:`SMTPDataError`"
|
|
|
|
#: ../Doc/library/smtplib.rst:336
|
|
msgid ""
|
|
"The server replied with an unexpected error code (other than a refusal of a "
|
|
"recipient)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:339
|
|
msgid ""
|
|
"Unless otherwise noted, the connection will be open even after an exception "
|
|
"is raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:345
|
|
msgid ""
|
|
"Terminate the SMTP session and close the connection. Return the result of "
|
|
"the SMTP ``QUIT`` command."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:348
|
|
msgid "Return a value."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:352
|
|
msgid ""
|
|
"Low-level methods corresponding to the standard SMTP/ESMTP commands "
|
|
"``HELP``, ``RSET``, ``NOOP``, ``MAIL``, ``RCPT``, and ``DATA`` are also "
|
|
"supported. Normally these do not need to be called directly, so they are not "
|
|
"documented here. For details, consult the module code."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:361
|
|
msgid "SMTP Example"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:363
|
|
msgid ""
|
|
"This example prompts the user for addresses needed in the message envelope "
|
|
"('To' and 'From' addresses), and the message to be delivered. Note that the "
|
|
"headers to be included with the message must be included in the message as "
|
|
"entered; this example doesn't do any processing of the :rfc:`822` headers. "
|
|
"In particular, the 'To' and 'From' addresses must be included in the message "
|
|
"headers explicitly. ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/smtplib.rst:399
|
|
msgid ""
|
|
"In general, you will want to use the :mod:`email` package's features to "
|
|
"construct an email message, which you can then convert to a string and send "
|
|
"via :meth:`sendmail`; see :ref:`email-examples`."
|
|
msgstr ""
|