forked from AFPy/python-docs-fr
424 lines
16 KiB
Plaintext
424 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/rfc822.rst:3
|
|
msgid ":mod:`rfc822` --- Parse RFC 2822 mail headers"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:10
|
|
msgid ""
|
|
"The :mod:`email` package should be used in preference to the :mod:`rfc822` "
|
|
"module. This module is present only to maintain backward compatibility, and "
|
|
"has been removed in Python 3."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:15
|
|
msgid ""
|
|
"This module defines a class, :class:`Message`, which represents an \"email "
|
|
"message\" as defined by the Internet standard :rfc:`2822`. [#]_ Such "
|
|
"messages consist of a collection of message headers, and a message body. "
|
|
"This module also defines a helper class :class:`AddressList` for parsing :"
|
|
"rfc:`2822` addresses. Please refer to the RFC for information on the "
|
|
"specific syntax of :rfc:`2822` messages."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:24
|
|
msgid ""
|
|
"The :mod:`mailbox` module provides classes to read mailboxes produced by "
|
|
"various end-user mail programs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:30
|
|
msgid ""
|
|
"A :class:`Message` instance is instantiated with an input object as "
|
|
"parameter. Message relies only on the input object having a :meth:`readline` "
|
|
"method; in particular, ordinary file objects qualify. Instantiation reads "
|
|
"headers from the input object up to a delimiter line (normally a blank line) "
|
|
"and stores them in the instance. The message body, following the headers, "
|
|
"is not consumed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:36
|
|
msgid ""
|
|
"This class can work with any input object that supports a :meth:`readline` "
|
|
"method. If the input object has seek and tell capability, the :meth:"
|
|
"`rewindbody` method will work; also, illegal lines will be pushed back onto "
|
|
"the input stream. If the input object lacks seek but has an :meth:`unread` "
|
|
"method that can push back a line of input, :class:`Message` will use that to "
|
|
"push back illegal lines. Thus this class can be used to parse messages "
|
|
"coming from a buffered stream."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:44
|
|
msgid ""
|
|
"The optional *seekable* argument is provided as a workaround for certain "
|
|
"stdio libraries in which :c:func:`tell` discards buffered data before "
|
|
"discovering that the :c:func:`lseek` system call doesn't work. For maximum "
|
|
"portability, you should set the seekable argument to zero to prevent that "
|
|
"initial :meth:`tell` when passing in an unseekable object such as a file "
|
|
"object created from a socket object."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:51
|
|
msgid ""
|
|
"Input lines as read from the file may either be terminated by CR-LF or by a "
|
|
"single linefeed; a terminating CR-LF is replaced by a single linefeed before "
|
|
"the line is stored."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:55
|
|
msgid ""
|
|
"All header matching is done independent of upper or lower case; e.g. "
|
|
"``m['From']``, ``m['from']`` and ``m['FROM']`` all yield the same result."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:61
|
|
msgid ""
|
|
"You may instantiate the :class:`AddressList` helper class using a single "
|
|
"string parameter, a comma-separated list of :rfc:`2822` addresses to be "
|
|
"parsed. (The parameter ``None`` yields an empty list.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:68
|
|
msgid ""
|
|
"Return a new string with backslashes in *str* replaced by two backslashes "
|
|
"and double quotes replaced by backslash-double quote."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:74
|
|
msgid ""
|
|
"Return a new string which is an *unquoted* version of *str*. If *str* ends "
|
|
"and begins with double quotes, they are stripped off. Likewise if *str* "
|
|
"ends and begins with angle brackets, they are stripped off."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:81
|
|
msgid ""
|
|
"Parse *address*, which should be the value of some address-containing field "
|
|
"such as :mailheader:`To` or :mailheader:`Cc`, into its constituent \"realname"
|
|
"\" and \"email address\" parts. Returns a tuple of that information, unless "
|
|
"the parse fails, in which case a 2-tuple ``(None, None)`` is returned."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:89
|
|
msgid ""
|
|
"The inverse of :meth:`parseaddr`, this takes a 2-tuple of the form "
|
|
"``(realname, email_address)`` and returns the string value suitable for a :"
|
|
"mailheader:`To` or :mailheader:`Cc` header. If the first element of *pair* "
|
|
"is false, then the second element is returned unmodified."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:97
|
|
msgid ""
|
|
"Attempts to parse a date according to the rules in :rfc:`2822`. however, "
|
|
"some mailers don't follow that format as specified, so :func:`parsedate` "
|
|
"tries to guess correctly in such cases. *date* is a string containing an :"
|
|
"rfc:`2822` date, such as ``'Mon, 20 Nov 1995 19:12:08 -0500'``. If it "
|
|
"succeeds in parsing the date, :func:`parsedate` returns a 9-tuple that can "
|
|
"be passed directly to :func:`time.mktime`; otherwise ``None`` will be "
|
|
"returned. Note that indexes 6, 7, and 8 of the result tuple are not usable."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:108
|
|
msgid ""
|
|
"Performs the same function as :func:`parsedate`, but returns either ``None`` "
|
|
"or a 10-tuple; the first 9 elements make up a tuple that can be passed "
|
|
"directly to :func:`time.mktime`, and the tenth is the offset of the date's "
|
|
"timezone from UTC (which is the official term for Greenwich Mean Time). "
|
|
"(Note that the sign of the timezone offset is the opposite of the sign of "
|
|
"the ``time.timezone`` variable for the same timezone; the latter variable "
|
|
"follows the POSIX standard while this module follows :rfc:`2822`.) If the "
|
|
"input string has no timezone, the last element of the tuple returned is "
|
|
"``None``. Note that indexes 6, 7, and 8 of the result tuple are not usable."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:121
|
|
msgid ""
|
|
"Turn a 10-tuple as returned by :func:`parsedate_tz` into a UTC timestamp. "
|
|
"If the timezone item in the tuple is ``None``, assume local time. Minor "
|
|
"deficiency: this first interprets the first 8 elements as a local time and "
|
|
"then compensates for the timezone difference; this may yield a slight error "
|
|
"around daylight savings time switch dates. Not enough to worry about for "
|
|
"common use."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:131
|
|
msgid "Module :mod:`email`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:131
|
|
msgid ""
|
|
"Comprehensive email handling package; supersedes the :mod:`rfc822` module."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:134
|
|
msgid "Module :mod:`mailbox`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:134
|
|
msgid ""
|
|
"Classes to read various mailbox formats produced by end-user mail programs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:136
|
|
msgid "Module :mod:`mimetools`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:137
|
|
msgid "Subclass of :class:`rfc822.Message` that handles MIME encoded messages."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:143
|
|
msgid "Message Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:145
|
|
msgid "A :class:`Message` instance has the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:150
|
|
msgid ""
|
|
"Seek to the start of the message body. This only works if the file object "
|
|
"is seekable."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:156
|
|
msgid ""
|
|
"Returns a line's canonicalized fieldname (the dictionary key that will be "
|
|
"used to index it) if the line is a legal :rfc:`2822` header; otherwise "
|
|
"returns ``None`` (implying that parsing should stop here and the line be "
|
|
"pushed back on the input stream). It is sometimes useful to override this "
|
|
"method in a subclass."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:165
|
|
msgid ""
|
|
"Return true if the given line is a delimiter on which Message should stop. "
|
|
"The delimiter line is consumed, and the file object's read location "
|
|
"positioned immediately after it. By default this method just checks that "
|
|
"the line is blank, but you can override it in a subclass."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:173
|
|
msgid ""
|
|
"Return ``True`` if the given line should be ignored entirely, just skipped. "
|
|
"By default this is a stub that always returns ``False``, but you can "
|
|
"override it in a subclass."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:180
|
|
msgid ""
|
|
"Return a list of lines consisting of all headers matching *name*, if any. "
|
|
"Each physical line, whether it is a continuation line or not, is a separate "
|
|
"list item. Return the empty list if no header matches *name*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:187
|
|
msgid ""
|
|
"Return a list of lines comprising the first header matching *name*, and its "
|
|
"continuation line(s), if any. Return ``None`` if there is no header "
|
|
"matching *name*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:194
|
|
msgid ""
|
|
"Return a single string consisting of the text after the colon in the first "
|
|
"header matching *name*. This includes leading whitespace, the trailing "
|
|
"linefeed, and internal linefeeds and whitespace if there any continuation "
|
|
"line(s) were present. Return ``None`` if there is no header matching *name*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:202
|
|
msgid ""
|
|
"Return a single string consisting of the last header matching *name*, but "
|
|
"strip leading and trailing whitespace. Internal whitespace is not stripped. "
|
|
"The optional *default* argument can be used to specify a different default "
|
|
"to be returned when there is no header matching *name*; it defaults to "
|
|
"``None``. This is the preferred way to get parsed headers."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:212
|
|
msgid ""
|
|
"An alias for :meth:`getheader`, to make the interface more compatible with "
|
|
"regular dictionaries."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:218
|
|
msgid ""
|
|
"Return a pair ``(full name, email address)`` parsed from the string returned "
|
|
"by ``getheader(name)``. If no header matching *name* exists, return "
|
|
"``(None, None)``; otherwise both the full name and the address are (possibly "
|
|
"empty) strings."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:223
|
|
msgid ""
|
|
"Example: If *m*'s first :mailheader:`From` header contains the string "
|
|
"``'jack@cwi.nl (Jack Jansen)'``, then ``m.getaddr('From')`` will yield the "
|
|
"pair ``('Jack Jansen', 'jack@cwi.nl')``. If the header contained ``'Jack "
|
|
"Jansen <jack@cwi.nl>'`` instead, it would yield the exact same result."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:231
|
|
msgid ""
|
|
"This is similar to ``getaddr(list)``, but parses a header containing a list "
|
|
"of email addresses (e.g. a :mailheader:`To` header) and returns a list of "
|
|
"``(full name, email address)`` pairs (even if there was only one address in "
|
|
"the header). If there is no header matching *name*, return an empty list."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:236
|
|
msgid ""
|
|
"If multiple headers exist that match the named header (e.g. if there are "
|
|
"several :mailheader:`Cc` headers), all are parsed for addresses. Any "
|
|
"continuation lines the named headers contain are also parsed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:243
|
|
msgid ""
|
|
"Retrieve a header using :meth:`getheader` and parse it into a 9-tuple "
|
|
"compatible with :func:`time.mktime`; note that fields 6, 7, and 8 are not "
|
|
"usable. If there is no header matching *name*, or it is unparsable, return "
|
|
"``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:247
|
|
msgid ""
|
|
"Date parsing appears to be a black art, and not all mailers adhere to the "
|
|
"standard. While it has been tested and found correct on a large collection "
|
|
"of email from many sources, it is still possible that this function may "
|
|
"occasionally yield an incorrect result."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:255
|
|
msgid ""
|
|
"Retrieve a header using :meth:`getheader` and parse it into a 10-tuple; the "
|
|
"first 9 elements will make a tuple compatible with :func:`time.mktime`, and "
|
|
"the 10th is a number giving the offset of the date's timezone from UTC. "
|
|
"Note that fields 6, 7, and 8 are not usable. Similarly to :meth:`getdate`, "
|
|
"if there is no header matching *name*, or it is unparsable, return ``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:261
|
|
msgid ""
|
|
":class:`Message` instances also support a limited mapping interface. In "
|
|
"particular: ``m[name]`` is like ``m.getheader(name)`` but raises :exc:"
|
|
"`KeyError` if there is no matching header; and ``len(m)``, ``m.get(name[, "
|
|
"default])``, ``name in m``, ``m.keys()``, ``m.values()`` ``m.items()``, and "
|
|
"``m.setdefault(name[, default])`` act as expected, with the one difference "
|
|
"that :meth:`setdefault` uses an empty string as the default value. :class:"
|
|
"`Message` instances also support the mapping writable interface ``m[name] = "
|
|
"value`` and ``del m[name]``. :class:`Message` objects do not support the :"
|
|
"meth:`clear`, :meth:`copy`, :meth:`popitem`, or :meth:`update` methods of "
|
|
"the mapping interface. (Support for :meth:`get` and :meth:`setdefault` was "
|
|
"only added in Python 2.2.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:273
|
|
msgid ""
|
|
"Finally, :class:`Message` instances have some public instance variables:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:278
|
|
msgid ""
|
|
"A list containing the entire set of header lines, in the order in which they "
|
|
"were read (except that setitem calls may disturb this order). Each line "
|
|
"contains a trailing newline. The blank line terminating the headers is not "
|
|
"contained in the list."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:286
|
|
msgid ""
|
|
"The file or file-like object passed at instantiation time. This can be used "
|
|
"to read the message content."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:292
|
|
msgid ""
|
|
"The Unix ``From`` line, if the message had one, or an empty string. This is "
|
|
"needed to regenerate the message in some contexts, such as an ``mbox``\\ -"
|
|
"style mailbox file."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:300
|
|
msgid "AddressList Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:302
|
|
msgid "An :class:`AddressList` instance has the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:307
|
|
msgid "Return the number of addresses in the address list."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:312
|
|
msgid ""
|
|
"Return a canonicalized string representation of the address list. Addresses "
|
|
"are rendered in \"name\" <host@domain> form, comma-separated."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:318
|
|
msgid ""
|
|
"Return a new :class:`AddressList` instance that contains all addresses in "
|
|
"both :class:`AddressList` operands, with duplicates removed (set union)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:324
|
|
msgid ""
|
|
"In-place version of :meth:`__add__`; turns this :class:`AddressList` "
|
|
"instance into the union of itself and the right-hand instance, *alist*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:330
|
|
msgid ""
|
|
"Return a new :class:`AddressList` instance that contains every address in "
|
|
"the left-hand :class:`AddressList` operand that is not present in the right-"
|
|
"hand address operand (set difference)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:337
|
|
msgid ""
|
|
"In-place version of :meth:`__sub__`, removing addresses in this list which "
|
|
"are also in *alist*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:340
|
|
msgid ""
|
|
"Finally, :class:`AddressList` instances have one public instance variable:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:345
|
|
msgid ""
|
|
"A list of tuple string pairs, one per address. In each member, the first is "
|
|
"the canonicalized name part, the second is the actual route-address (``'@'``"
|
|
"\\ -separated username-host.domain pair)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/rfc822.rst:350
|
|
msgid "Footnotes"
|
|
msgstr "Notes"
|
|
|
|
#: ../Doc/library/rfc822.rst:351
|
|
msgid ""
|
|
"This module originally conformed to :rfc:`822`, hence the name. Since "
|
|
"then, :rfc:`2822` has been released as an update to :rfc:`822`. This module "
|
|
"should be considered :rfc:`2822`\\ -conformant, especially in cases where "
|
|
"the syntax or semantics have changed since :rfc:`822`."
|
|
msgstr ""
|