# 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: 2020-08-24 09:01+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: library/email.charset.rst:2 msgid ":mod:`email.charset`: Representing character sets" msgstr "" #: library/email.charset.rst:7 #, fuzzy msgid "**Source code:** :source:`Lib/email/charset.py`" msgstr "**Code source :** :source:`Lib/email/parser.py`" #: library/email.charset.rst:11 msgid "" "This module is part of the legacy (``Compat32``) email API. In the new API " "only the aliases table is used." msgstr "" #: library/email.charset.rst:14 msgid "" "The remaining text in this section is the original documentation of the " "module." msgstr "" "Le texte restant de cette section est la documentation originale de ce " "module." #: library/email.charset.rst:16 msgid "" "This module provides a class :class:`Charset` for representing character " "sets and character set conversions in email messages, as well as a character " "set registry and several convenience methods for manipulating this registry. " "Instances of :class:`Charset` are used in several other modules within the :" "mod:`email` package." msgstr "" #: library/email.charset.rst:22 msgid "Import this class from the :mod:`email.charset` module." msgstr "" #: library/email.charset.rst:27 msgid "Map character sets to their email properties." msgstr "" #: library/email.charset.rst:29 msgid "" "This class provides information about the requirements imposed on email for " "a specific character set. It also provides convenience routines for " "converting between character sets, given the availability of the applicable " "codecs. Given a character set, it will do its best to provide information " "on how to use that character set in an email message in an RFC-compliant way." msgstr "" #: library/email.charset.rst:35 msgid "" "Certain character sets must be encoded with quoted-printable or base64 when " "used in email headers or bodies. Certain character sets must be converted " "outright, and are not allowed in email." msgstr "" #: library/email.charset.rst:39 msgid "" "Optional *input_charset* is as described below; it is always coerced to " "lower case. After being alias normalized it is also used as a lookup into " "the registry of character sets to find out the header encoding, body " "encoding, and output conversion codec to be used for the character set. For " "example, if *input_charset* is ``iso-8859-1``, then headers and bodies will " "be encoded using quoted-printable and no output conversion codec is " "necessary. If *input_charset* is ``euc-jp``, then headers will be encoded " "with base64, bodies will not be encoded, but output text will be converted " "from the ``euc-jp`` character set to the ``iso-2022-jp`` character set." msgstr "" #: library/email.charset.rst:49 msgid ":class:`Charset` instances have the following data attributes:" msgstr "" #: library/email.charset.rst:53 msgid "" "The initial character set specified. Common aliases are converted to their " "*official* email names (e.g. ``latin_1`` is converted to ``iso-8859-1``). " "Defaults to 7-bit ``us-ascii``." msgstr "" #: library/email.charset.rst:60 msgid "" "If the character set must be encoded before it can be used in an email " "header, this attribute will be set to ``Charset.QP`` (for quoted-printable), " "``Charset.BASE64`` (for base64 encoding), or ``Charset.SHORTEST`` for the " "shortest of QP or BASE64 encoding. Otherwise, it will be ``None``." msgstr "" #: library/email.charset.rst:69 msgid "" "Same as *header_encoding*, but describes the encoding for the mail message's " "body, which indeed may be different than the header encoding. ``Charset." "SHORTEST`` is not allowed for *body_encoding*." msgstr "" #: library/email.charset.rst:76 msgid "" "Some character sets must be converted before they can be used in email " "headers or bodies. If the *input_charset* is one of them, this attribute " "will contain the name of the character set output will be converted to. " "Otherwise, it will be ``None``." msgstr "" #: library/email.charset.rst:84 msgid "" "The name of the Python codec used to convert the *input_charset* to " "Unicode. If no conversion codec is necessary, this attribute will be " "``None``." msgstr "" #: library/email.charset.rst:91 msgid "" "The name of the Python codec used to convert Unicode to the " "*output_charset*. If no conversion codec is necessary, this attribute will " "have the same value as the *input_codec*." msgstr "" #: library/email.charset.rst:96 msgid ":class:`Charset` instances also have the following methods:" msgstr "" #: library/email.charset.rst:100 msgid "Return the content transfer encoding used for body encoding." msgstr "" #: library/email.charset.rst:102 msgid "" "This is either the string ``quoted-printable`` or ``base64`` depending on " "the encoding used, or it is a function, in which case you should call the " "function with a single argument, the Message object being encoded. The " "function should then set the :mailheader:`Content-Transfer-Encoding` header " "itself to whatever is appropriate." msgstr "" #: library/email.charset.rst:108 msgid "" "Returns the string ``quoted-printable`` if *body_encoding* is ``QP``, " "returns the string ``base64`` if *body_encoding* is ``BASE64``, and returns " "the string ``7bit`` otherwise." msgstr "" #: library/email.charset.rst:115 msgid "Return the output character set." msgstr "" #: library/email.charset.rst:117 msgid "" "This is the *output_charset* attribute if that is not ``None``, otherwise it " "is *input_charset*." msgstr "" #: library/email.charset.rst:123 msgid "Header-encode the string *string*." msgstr "" #: library/email.charset.rst:125 msgid "" "The type of encoding (base64 or quoted-printable) will be based on the " "*header_encoding* attribute." msgstr "" #: library/email.charset.rst:131 msgid "Header-encode a *string* by converting it first to bytes." msgstr "" #: library/email.charset.rst:133 msgid "" "This is similar to :meth:`header_encode` except that the string is fit into " "maximum line lengths as given by the argument *maxlengths*, which must be an " "iterator: each element returned from this iterator will provide the next " "maximum line length." msgstr "" #: library/email.charset.rst:141 msgid "Body-encode the string *string*." msgstr "" #: library/email.charset.rst:143 msgid "" "The type of encoding (base64 or quoted-printable) will be based on the " "*body_encoding* attribute." msgstr "" #: library/email.charset.rst:146 msgid "" "The :class:`Charset` class also provides a number of methods to support " "standard operations and built-in functions." msgstr "" #: library/email.charset.rst:152 msgid "" "Returns *input_charset* as a string coerced to lower case. :meth:`__repr__` " "is an alias for :meth:`__str__`." msgstr "" #: library/email.charset.rst:158 msgid "" "This method allows you to compare two :class:`Charset` instances for " "equality." msgstr "" #: library/email.charset.rst:164 msgid "" "This method allows you to compare two :class:`Charset` instances for " "inequality." msgstr "" #: library/email.charset.rst:167 msgid "" "The :mod:`email.charset` module also provides the following functions for " "adding new entries to the global character set, alias, and codec registries:" msgstr "" #: library/email.charset.rst:173 msgid "Add character properties to the global registry." msgstr "" #: library/email.charset.rst:175 msgid "" "*charset* is the input character set, and must be the canonical name of a " "character set." msgstr "" #: library/email.charset.rst:178 msgid "" "Optional *header_enc* and *body_enc* is either ``Charset.QP`` for quoted-" "printable, ``Charset.BASE64`` for base64 encoding, ``Charset.SHORTEST`` for " "the shortest of quoted-printable or base64 encoding, or ``None`` for no " "encoding. ``SHORTEST`` is only valid for *header_enc*. The default is " "``None`` for no encoding." msgstr "" #: library/email.charset.rst:184 msgid "" "Optional *output_charset* is the character set that the output should be in. " "Conversions will proceed from input charset, to Unicode, to the output " "charset when the method :meth:`Charset.convert` is called. The default is " "to output in the same character set as the input." msgstr "" #: library/email.charset.rst:189 msgid "" "Both *input_charset* and *output_charset* must have Unicode codec entries in " "the module's character set-to-codec mapping; use :func:`add_codec` to add " "codecs the module does not know about. See the :mod:`codecs` module's " "documentation for more information." msgstr "" #: library/email.charset.rst:194 msgid "" "The global character set registry is kept in the module global dictionary " "``CHARSETS``." msgstr "" #: library/email.charset.rst:200 msgid "" "Add a character set alias. *alias* is the alias name, e.g. ``latin-1``. " "*canonical* is the character set's canonical name, e.g. ``iso-8859-1``." msgstr "" #: library/email.charset.rst:203 msgid "" "The global charset alias registry is kept in the module global dictionary " "``ALIASES``." msgstr "" #: library/email.charset.rst:209 msgid "" "Add a codec that map characters in the given character set to and from " "Unicode." msgstr "" #: library/email.charset.rst:211 msgid "" "*charset* is the canonical name of a character set. *codecname* is the name " "of a Python codec, as appropriate for the second argument to the :class:" "`str`'s :meth:`~str.encode` method." msgstr ""