# SOME DESCRIPTIVE TITLE. # Copyright (C) 1990-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , 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 \n" "Language-Team: LANGUAGE \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 ""