ArmandS/python-docs-fr
Fork 0
forked from AFPy/python-docs-fr
Code Pull requests Activity

Make merge (#1695)

Browse source 
* Make merge * FIX: spelling for pospell. * Uniformisation des entêtes po.
This commit is contained in:
Julien Palard 2021-09-24 10:20:01 +02:00 • committed by GitHub
commit 17d5f9cebe
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
257 changed files with 43019 additions and 31747 deletions
Download patch file Download diff file Expand all files Collapse all files

186
c-api/apiabiversion.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -20,101 +20,181 @@ msgstr "Version des API et ABI"
#: c-api/apiabiversion.rst:9
msgid ""
"``PY_VERSION_HEX`` is the Python version number encoded in a single integer."
"CPython exposes its version number in the following macros. Note that these "
"correspond to the version code is **built** with, not necessarily the "
"version used at **run time**."
msgstr ""
#: c-api/apiabiversion.rst:13
msgid ""
"See :ref:`stable` for a discussion of API and ABI stability across versions."
msgstr ""
#: c-api/apiabiversion.rst:17
#, fuzzy
msgid "The ``3`` in ``3.4.1a2``."
msgstr "``PY_MAJOR_VERSION`` (le ``3`` dans ``3.4.1a2``)"
#: c-api/apiabiversion.rst:21
#, fuzzy
msgid "The ``4`` in ``3.4.1a2``."
msgstr "``PY_MINOR_VERSION`` (le ``4`` dans ``3.4.1a2``)"
#: c-api/apiabiversion.rst:25
#, fuzzy
msgid "The ``1`` in ``3.4.1a2``."
msgstr "``PY_MICRO_VERSION`` (le ``1`` dans ``3.4.1a2``)"
#: c-api/apiabiversion.rst:29
#, fuzzy
msgid ""
"The ``a`` in ``3.4.1a2``. This can be ``0xA`` for alpha, ``0xB`` for beta, "
"``0xC`` for release candidate or ``0xF`` for final."
msgstr ""
"``PY_RELEASE_LEVEL`` (``0xA`` pour alpha, ``0xB`` pour bêta, ``0xC`` pour "
"une version candidate et ``0xF`` pour final), dans ce cas c'est alpha."
#: c-api/apiabiversion.rst:35
#, fuzzy
msgid "The ``2`` in ``3.4.1a2``. Zero for final releases."
msgstr ""
"``PY_RELEASE_SERIAL`` (le ``2`` au ``3.4.1a2``, zéro pour des versions "
"finales)"
#: c-api/apiabiversion.rst:39
#, fuzzy
msgid "The Python version number encoded in a single integer."
msgstr ""
"``PY_VERSION_HEX`` est le numéro de version de Python encodé en un seul "
"entier."
#: c-api/apiabiversion.rst:11
#: c-api/apiabiversion.rst:41
#, fuzzy
msgid ""
"For example if the ``PY_VERSION_HEX`` is set to ``0x030401a2``, the "
"underlying version information can be found by treating it as a 32 bit "
"The underlying version information can be found by treating it as a 32 bit "
"number in the following manner:"
msgstr ""
"Par exemple si le ``PY_VERSION_HEX` est défini à ``0x030401a2``, la "
"version d'information sous-jacente peut être trouvée en la traitant comme un "
"nombre sous 32 bits de la manière suivante:"
#: c-api/apiabiversion.rst:16
#: c-api/apiabiversion.rst:45
msgid "Bytes"
msgstr "Bytes"
#: c-api/apiabiversion.rst:16
#: c-api/apiabiversion.rst:45
msgid "Bits (big endian order)"
msgstr "Bits (ordre gros-boutiste)"
#: c-api/apiabiversion.rst:16
#: c-api/apiabiversion.rst:45
msgid "Meaning"
msgstr "Signification"
#: c-api/apiabiversion.rst:18
msgid "``1``"
msgstr "``1``"
#: c-api/apiabiversion.rst:45
msgid "Value for ``3.4.1a2``"
msgstr ""
#: c-api/apiabiversion.rst:18
msgid "``1-8``"
#: c-api/apiabiversion.rst:47
msgid "1"
msgstr ""
#: c-api/apiabiversion.rst:47
#, fuzzy
msgid "1-8"
msgstr "``1-8``"
#: c-api/apiabiversion.rst:18
msgid "``PY_MAJOR_VERSION`` (the ``3`` in ``3.4.1a2``)"
msgstr "``PY_MAJOR_VERSION`` (le ``3`` dans ``3.4.1a2``)"
#: c-api/apiabiversion.rst:47
msgid "``PY_MAJOR_VERSION``"
msgstr ""
#: c-api/apiabiversion.rst:21
msgid "``2``"
msgstr "``2``"
#: c-api/apiabiversion.rst:47
msgid "``0x03``"
msgstr ""
#: c-api/apiabiversion.rst:21
msgid "``9-16``"
#: c-api/apiabiversion.rst:49
msgid "2"
msgstr ""
#: c-api/apiabiversion.rst:49
#, fuzzy
msgid "9-16"
msgstr "``9-16``"
#: c-api/apiabiversion.rst:21
msgid "``PY_MINOR_VERSION`` (the ``4`` in ``3.4.1a2``)"
msgstr "``PY_MINOR_VERSION`` (le ``4`` dans ``3.4.1a2``)"
#: c-api/apiabiversion.rst:49
msgid "``PY_MINOR_VERSION``"
msgstr ""
#: c-api/apiabiversion.rst:24
msgid "``3``"
msgstr "``3``"
#: c-api/apiabiversion.rst:49
msgid "``0x04``"
msgstr ""
#: c-api/apiabiversion.rst:24
msgid "``17-24``"
#: c-api/apiabiversion.rst:51
msgid "3"
msgstr ""
#: c-api/apiabiversion.rst:51
#, fuzzy
msgid "17-24"
msgstr "``17-24``"
#: c-api/apiabiversion.rst:24
msgid "``PY_MICRO_VERSION`` (the ``1`` in ``3.4.1a2``)"
msgstr "``PY_MICRO_VERSION`` (le ``1`` dans ``3.4.1a2``)"
#: c-api/apiabiversion.rst:51
msgid "``PY_MICRO_VERSION``"
msgstr ""
#: c-api/apiabiversion.rst:27
msgid "``4``"
msgstr "``4``"
#: c-api/apiabiversion.rst:51
msgid "``0x01``"
msgstr ""
#: c-api/apiabiversion.rst:27
msgid "``25-28``"
#: c-api/apiabiversion.rst:53
msgid "4"
msgstr ""
#: c-api/apiabiversion.rst:53
#, fuzzy
msgid "25-28"
msgstr "``25-28``"
#: c-api/apiabiversion.rst:27
msgid ""
"``PY_RELEASE_LEVEL`` (``0xA`` for alpha, ``0xB`` for beta, ``0xC`` for "
"release candidate and ``0xF`` for final), in this case it is alpha."
#: c-api/apiabiversion.rst:53
msgid "``PY_RELEASE_LEVEL``"
msgstr ""
"``PY_RELEASE_LEVEL`` (``0xA`` pour alpha, ``0xB`` pour bêta, ``0xC`` pour "
"une version candidate et ``0xF`` pour final), dans ce cas c'est alpha."
#: c-api/apiabiversion.rst:32
msgid "``29-32``"
#: c-api/apiabiversion.rst:53
msgid "``0xA``"
msgstr ""
#: c-api/apiabiversion.rst:55
#, fuzzy
msgid "29-32"
msgstr "``29-32``"
#: c-api/apiabiversion.rst:32
msgid ""
"``PY_RELEASE_SERIAL`` (the ``2`` in ``3.4.1a2``, zero for final releases)"
#: c-api/apiabiversion.rst:55
msgid "``PY_RELEASE_SERIAL``"
msgstr ""
"``PY_RELEASE_SERIAL`` (le ``2`` au ``3.4.1a2``, zéro pour des versions "
"finales)"
#: c-api/apiabiversion.rst:36
msgid "Thus ``3.4.1a2`` is hexversion ``0x030401a2``."
#: c-api/apiabiversion.rst:55
msgid "``0x2``"
msgstr ""
#: c-api/apiabiversion.rst:58
#, fuzzy
msgid ""
"Thus ``3.4.1a2`` is hexversion ``0x030401a2`` and ``3.10.0`` is hexversion "
"``0x030a00f0``."
msgstr "Ainsi ``3.4.1a2`` est une hexane-version ``0x030401a2``."
#: c-api/apiabiversion.rst:38
#: c-api/apiabiversion.rst:62
msgid "All the given macros are defined in :source:`Include/patchlevel.h`."
msgstr ""
"Toutes les macros données sont définies dans :source:`Include/patchlevel.h`."
#~ msgid "``1``"
#~ msgstr "``1``"
#~ msgid "``2``"
#~ msgstr "``2``"
#~ msgid "``3``"
#~ msgstr "``3``"
#~ msgid "``4``"
#~ msgstr "``4``"

444
c-api/arg.po
View file

File diff suppressed because it is too large Load diff

16
c-api/code.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-27 19:26+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2018-02-15 00:30+0100\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -82,3 +82,17 @@ msgstr ""
"Renvoie un nouvel objet *code* avec le nom de fichier, le nom de fonction, "
"et le numéro de première ligne donnés. Il n'est pas permis d'utiliser :func:"
"`exec` ou :func:`eval` sur l'objet renvoyé."
#: c-api/code.rst:57
msgid ""
"Return the line number of the instruction that occurs on or before "
"``byte_offset`` and ends after it. If you just need the line number of a "
"frame, use :c:func:`PyFrame_GetLineNumber` instead."
msgstr ""
#: c-api/code.rst:60
msgid ""
"For efficiently iterating over the line numbers in a code object, use `the "
"API described in PEP 626 <https://www.python.org/dev/peps/pep-0626/#out-of-"
"process-debuggers-and-profilers>`_."
msgstr ""

55
c-api/codec.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -30,15 +30,22 @@ msgstr ""
#: c-api/codec.rst:15
msgid ""
"Unregister a codec search function and clear the registry's cache. If the "
"search function is not registered, do nothing. Return 0 on success. Raise an "
"exception and return -1 on error."
msgstr ""
#: c-api/codec.rst:23
msgid ""
"Return ``1`` or ``0`` depending on whether there is a registered codec for "
"the given *encoding*. This function always succeeds."
msgstr ""
#: c-api/codec.rst:20
#: c-api/codec.rst:28
msgid "Generic codec based encoding API."
msgstr ""
#: c-api/codec.rst:22
#: c-api/codec.rst:30
msgid ""
"*object* is passed through the encoder function found for the given "
"*encoding* using the error handling method defined by *errors*. *errors* "
@ -46,11 +53,11 @@ msgid ""
"exc:`LookupError` if no encoder can be found."
msgstr ""
#: c-api/codec.rst:29
#: c-api/codec.rst:37
msgid "Generic codec based decoding API."
msgstr ""
#: c-api/codec.rst:31
#: c-api/codec.rst:39
msgid ""
"*object* is passed through the decoder function found for the given "
"*encoding* using the error handling method defined by *errors*. *errors* "
@ -58,11 +65,11 @@ msgid ""
"exc:`LookupError` if no encoder can be found."
msgstr ""
#: c-api/codec.rst:38
#: c-api/codec.rst:46
msgid "Codec lookup API"
msgstr ""
#: c-api/codec.rst:40
#: c-api/codec.rst:48
msgid ""
"In the following functions, the *encoding* string is looked up converted to "
"all lower-case characters, which makes encodings looked up through this "
@ -70,41 +77,41 @@ msgid ""
"`KeyError` is set and ``NULL`` returned."
msgstr ""
#: c-api/codec.rst:47
#: c-api/codec.rst:55
msgid "Get an encoder function for the given *encoding*."
msgstr ""
#: c-api/codec.rst:51
#: c-api/codec.rst:59
msgid "Get a decoder function for the given *encoding*."
msgstr ""
#: c-api/codec.rst:55
#: c-api/codec.rst:63
msgid ""
"Get an :class:`~codecs.IncrementalEncoder` object for the given *encoding*."
msgstr ""
#: c-api/codec.rst:59
#: c-api/codec.rst:67
msgid ""
"Get an :class:`~codecs.IncrementalDecoder` object for the given *encoding*."
msgstr ""
#: c-api/codec.rst:63
#: c-api/codec.rst:71
msgid ""
"Get a :class:`~codecs.StreamReader` factory function for the given "
"*encoding*."
msgstr ""
#: c-api/codec.rst:67
#: c-api/codec.rst:75
msgid ""
"Get a :class:`~codecs.StreamWriter` factory function for the given "
"*encoding*."
msgstr ""
#: c-api/codec.rst:71
#: c-api/codec.rst:79
msgid "Registry API for Unicode encoding error handlers"
msgstr ""
#: c-api/codec.rst:75
#: c-api/codec.rst:83
msgid ""
"Register the error handling callback function *error* under the given "
"*name*. This callback function will be called by a codec when it encounters "
@ -112,7 +119,7 @@ msgid ""
"error parameter in the call to the encode/decode function."
msgstr ""
#: c-api/codec.rst:80
#: c-api/codec.rst:88
msgid ""
"The callback gets a single argument, an instance of :exc:"
"`UnicodeEncodeError`, :exc:`UnicodeDecodeError` or :exc:"
@ -125,39 +132,39 @@ msgid ""
"should be resumed."
msgstr ""
#: c-api/codec.rst:90
#: c-api/codec.rst:98
msgid "Return ``0`` on success, ``-1`` on error."
msgstr ""
#: c-api/codec.rst:94
#: c-api/codec.rst:102
msgid ""
"Lookup the error handling callback function registered under *name*. As a "
"special case ``NULL`` can be passed, in which case the error handling "
"callback for \"strict\" will be returned."
msgstr ""
#: c-api/codec.rst:100
#: c-api/codec.rst:108
msgid "Raise *exc* as an exception."
msgstr ""
#: c-api/codec.rst:104
#: c-api/codec.rst:112
msgid "Ignore the unicode error, skipping the faulty input."
msgstr ""
#: c-api/codec.rst:108
#: c-api/codec.rst:116
msgid "Replace the unicode encode error with ``?`` or ``U+FFFD``."
msgstr ""
#: c-api/codec.rst:112
#: c-api/codec.rst:120
msgid "Replace the unicode encode error with XML character references."
msgstr ""
#: c-api/codec.rst:116
#: c-api/codec.rst:124
msgid ""
"Replace the unicode encode error with backslash escapes (``\\x``, ``\\u`` "
"and ``\\U``)."
msgstr ""
#: c-api/codec.rst:121
#: c-api/codec.rst:129
msgid "Replace the unicode encode error with ``\\N{...}`` escapes."
msgstr ""

51
c-api/conversion.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-02-24 17:33+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -50,50 +50,43 @@ msgstr ""
msgid ""
"The wrappers ensure that ``str[size-1]`` is always ``'\\0'`` upon return. "
"They never write more than *size* bytes (including the trailing ``'\\0'``) "
"into str. Both functions require that ``str != NULL``, ``size > 0`` and "
"``format != NULL``."
"into str. Both functions require that ``str != NULL``, ``size > 0``, "
"``format != NULL`` and ``size < INT_MAX``."
msgstr ""
#: c-api/conversion.rst:33
msgid ""
"If the platform doesn't have :c:func:`vsnprintf` and the buffer size needed "
"to avoid truncation exceeds *size* by more than 512 bytes, Python aborts "
"with a :c:func:`Py_FatalError`."
msgstr ""
#: c-api/conversion.rst:37
msgid ""
"The return value (*rv*) for these functions should be interpreted as follows:"
msgstr ""
#: c-api/conversion.rst:39
#: c-api/conversion.rst:35
msgid ""
"When ``0 <= rv < size``, the output conversion was successful and *rv* "
"characters were written to *str* (excluding the trailing ``'\\0'`` byte at "
"``str[rv]``)."
msgstr ""
#: c-api/conversion.rst:43
#: c-api/conversion.rst:39
msgid ""
"When ``rv >= size``, the output conversion was truncated and a buffer with "
"``rv + 1`` bytes would have been needed to succeed. ``str[size-1]`` is "
"``'\\0'`` in this case."
msgstr ""
#: c-api/conversion.rst:47
#: c-api/conversion.rst:43
msgid ""
"When ``rv < 0``, \"something bad happened.\" ``str[size-1]`` is ``'\\0'`` in "
"this case too, but the rest of *str* is undefined. The exact cause of the "
"error depends on the underlying platform."
msgstr ""
#: c-api/conversion.rst:51
#: c-api/conversion.rst:48
msgid ""
"The following functions provide locale-independent string to number "
"conversions."
msgstr ""
#: c-api/conversion.rst:56
#: c-api/conversion.rst:52
msgid ""
"Convert a string ``s`` to a :c:type:`double`, raising a Python exception on "
"failure. The set of accepted strings corresponds to the set of strings "
@ -102,14 +95,14 @@ msgid ""
"current locale."
msgstr ""
#: c-api/conversion.rst:62
#: c-api/conversion.rst:58
msgid ""
"If ``endptr`` is ``NULL``, convert the whole string. Raise :exc:"
"`ValueError` and return ``-1.0`` if the string is not a valid representation "
"of a floating-point number."
msgstr ""
#: c-api/conversion.rst:66
#: c-api/conversion.rst:62
msgid ""
"If endptr is not ``NULL``, convert as much of the string as possible and set "
"``*endptr`` to point to the first unconverted character. If no initial "
@ -118,7 +111,7 @@ msgid ""
"ValueError, and return ``-1.0``."
msgstr ""
#: c-api/conversion.rst:73
#: c-api/conversion.rst:69
msgid ""
"If ``s`` represents a value that is too large to store in a float (for "
"example, ``\"1e500\"`` is such a string on many platforms) then if "
@ -129,50 +122,50 @@ msgid ""
"the first character after the converted value."
msgstr ""
#: c-api/conversion.rst:81
#: c-api/conversion.rst:77
msgid ""
"If any other error occurs during the conversion (for example an out-of-"
"memory error), set the appropriate Python exception and return ``-1.0``."
msgstr ""
#: c-api/conversion.rst:90
#: c-api/conversion.rst:86
msgid ""
"Convert a :c:type:`double` *val* to a string using supplied *format_code*, "
"*precision*, and *flags*."
msgstr ""
#: c-api/conversion.rst:93
#: c-api/conversion.rst:89
msgid ""
"*format_code* must be one of ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, "
"``'G'`` or ``'r'``. For ``'r'``, the supplied *precision* must be 0 and is "
"ignored. The ``'r'`` format code specifies the standard :func:`repr` format."
msgstr ""
#: c-api/conversion.rst:98
#: c-api/conversion.rst:94
msgid ""
"*flags* can be zero or more of the values ``Py_DTSF_SIGN``, "
"``Py_DTSF_ADD_DOT_0``, or ``Py_DTSF_ALT``, or-ed together:"
msgstr ""
#: c-api/conversion.rst:101
#: c-api/conversion.rst:97
msgid ""
"``Py_DTSF_SIGN`` means to always precede the returned string with a sign "
"character, even if *val* is non-negative."
msgstr ""
#: c-api/conversion.rst:104
#: c-api/conversion.rst:100
msgid ""
"``Py_DTSF_ADD_DOT_0`` means to ensure that the returned string will not look "
"like an integer."
msgstr ""
#: c-api/conversion.rst:107
#: c-api/conversion.rst:103
msgid ""
"``Py_DTSF_ALT`` means to apply \"alternate\" formatting rules. See the "
"documentation for the :c:func:`PyOS_snprintf` ``'#'`` specifier for details."
msgstr ""
#: c-api/conversion.rst:111
#: c-api/conversion.rst:107
msgid ""
"If *ptype* is non-``NULL``, then the value it points to will be set to one "
"of ``Py_DTST_FINITE``, ``Py_DTST_INFINITE``, or ``Py_DTST_NAN``, signifying "
@ -180,20 +173,20 @@ msgid ""
"respectively."
msgstr ""
#: c-api/conversion.rst:115
#: c-api/conversion.rst:111
msgid ""
"The return value is a pointer to *buffer* with the converted string or "
"``NULL`` if the conversion failed. The caller is responsible for freeing the "
"returned string by calling :c:func:`PyMem_Free`."
msgstr ""
#: c-api/conversion.rst:124
#: c-api/conversion.rst:120
msgid ""
"Case insensitive comparison of strings. The function works almost "
"identically to :c:func:`strcmp` except that it ignores the case."
msgstr ""
#: c-api/conversion.rst:130
#: c-api/conversion.rst:126
msgid ""
"Case insensitive comparison of strings. The function works almost "
"identically to :c:func:`strncmp` except that it ignores the case."

30
c-api/datetime.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-27 19:26+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2020-06-28 15:17+0200\n"
"Last-Translator: Jules Lasne <jules.lasne@gmail.com>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -259,23 +259,27 @@ msgstr ""
"une instance de :c:data:`PyDateTime_DateTime` ou une sous-classe de celle-"
"ci. L'argument ne doit pas être *NULL*, et le type n'est pas vérifié :"
#: c-api/datetime.rst:200
#: c-api/datetime.rst:205
msgid "Return the hour, as an int from 0 through 23."
msgstr "Renvoie l'heure, sous forme d'entier allant de 0 à 23."
#: c-api/datetime.rst:205
#: c-api/datetime.rst:210
msgid "Return the minute, as an int from 0 through 59."
msgstr "Renvoie la minute, sous forme d'entier allant de 0 à 59."
#: c-api/datetime.rst:210
#: c-api/datetime.rst:215
msgid "Return the second, as an int from 0 through 59."
msgstr "Renvoie la seconde, sous forme d'entier allant de 0 à 59."
#: c-api/datetime.rst:215
#: c-api/datetime.rst:220
msgid "Return the microsecond, as an int from 0 through 999999."
msgstr "Renvoie la microseconde, sous forme d'entier allant de 0 à 999999."
#: c-api/datetime.rst:194
#: c-api/datetime.rst:224
msgid "Return the tzinfo (which may be ``None``)."
msgstr ""
#: c-api/datetime.rst:199
#, fuzzy
msgid ""
"Macros to extract fields from time objects. The argument must be an "
@ -286,7 +290,7 @@ msgstr ""
"instance de :c:data:`PyDateTime_Time` ou une sous-classe de celle-ci. "
"L'argument ne doit pas être *NULL*, et le type n'est pas vérifié :"
#: c-api/datetime.rst:218
#: c-api/datetime.rst:229
#, fuzzy
msgid ""
"Macros to extract fields from time delta objects. The argument must be an "
@ -297,26 +301,26 @@ msgstr ""
"être une instance de :c:data:`PyDateTime_Delta` ou une sous-classe de celle-"
"ci. L'argument ne doit pas être *NULL*, et le type n'est pas vérifié :"
#: c-api/datetime.rst:224
#: c-api/datetime.rst:235
msgid "Return the number of days, as an int from -999999999 to 999999999."
msgstr ""
"Renvoie le nombre de jours, sous forme d'entier allant de ``-999999999`` à "
"``999999999``."
#: c-api/datetime.rst:231
#: c-api/datetime.rst:242
msgid "Return the number of seconds, as an int from 0 through 86399."
msgstr "Renvoie le nombre de secondes sous forme d'entier allant de 0 à 86399."
#: c-api/datetime.rst:238
#: c-api/datetime.rst:249
msgid "Return the number of microseconds, as an int from 0 through 999999."
msgstr ""
"Renvoie le nombre de microsecondes, sous forme d'entier allant de 0 à 999999."
#: c-api/datetime.rst:243
#: c-api/datetime.rst:254
msgid "Macros for the convenience of modules implementing the DB API:"
msgstr "Macros de confort pour les modules implémentant l'API DB :"
#: c-api/datetime.rst:247
#: c-api/datetime.rst:258
msgid ""
"Create and return a new :class:`datetime.datetime` object given an argument "
"tuple suitable for passing to :meth:`datetime.datetime.fromtimestamp()`."
@ -324,7 +328,7 @@ msgstr ""
"Crée et renvoie un nouvel objet :class:`datetime.datetime` à partir d'un n-"
"uplet qui peut être passé à :meth:`datetime.datetime.fromtimestamp()`."
#: c-api/datetime.rst:253
#: c-api/datetime.rst:264
msgid ""
"Create and return a new :class:`datetime.date` object given an argument "
"tuple suitable for passing to :meth:`datetime.date.fromtimestamp()`."

12
c-api/decimal.po
View file

@ -1,17 +1,15 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2021, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.10\n"
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-03-18 17:40+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"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

9
c-api/descriptor.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2018-02-15 00:32+0100\n"
"Last-Translator: Julien Palard <julien@palard.fr>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -31,10 +31,11 @@ msgid "The type object for the built-in descriptor types."
msgstr "L'objet *type* des descripteurs natifs."
#: c-api/descriptor.rst:35
#, fuzzy
msgid ""
"Return true if the descriptor objects *descr* describes a data attribute, or "
"false if it describes a method. *descr* must be a descriptor object; there "
"is no error checking."
"Return non-zero if the descriptor objects *descr* describes a data "
"attribute, or ``0`` if it describes a method. *descr* must be a descriptor "
"object; there is no error checking."
msgstr ""
"Renvoie vrai si le descripteur *descr* décrit un attribut de donnée, ou faux "
"s'il décrit une méthode. *descr* doit être un objet descripteur. Il n'y a "

36
c-api/dict.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-27 19:26+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2018-07-03 11:36+0200\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -116,27 +116,33 @@ msgid ""
"`PyDict_GetItemWithError()` instead."
msgstr ""
#: c-api/dict.rst:108
#: c-api/dict.rst:105
msgid ""
"Calling this API without :term:`GIL` held had been allowed for historical "
"reason. It is no longer allowed."
msgstr ""
#: c-api/dict.rst:112
msgid ""
"Variant of :c:func:`PyDict_GetItem` that does not suppress exceptions. "
"Return ``NULL`` **with** an exception set if an exception occurred. Return "
"``NULL`` **without** an exception set if the key wasn't present."
msgstr ""
#: c-api/dict.rst:116
#: c-api/dict.rst:120
msgid ""
"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:"
"type:`const char*`, rather than a :c:type:`PyObject*`."
msgstr ""
#: c-api/dict.rst:119
#: c-api/dict.rst:123
msgid ""
"Note that exceptions which occur while calling :meth:`__hash__` and :meth:"
"`__eq__` methods and creating a temporary string object will get suppressed. "
"To get error reporting use :c:func:`PyDict_GetItemWithError()` instead."
msgstr ""
#: c-api/dict.rst:127
#: c-api/dict.rst:131
msgid ""
"This is the same as the Python-level :meth:`dict.setdefault`. If present, "
"it returns the value corresponding to *key* from the dictionary *p*. If the "
@ -146,29 +152,29 @@ msgid ""
"the insertion."
msgstr ""
#: c-api/dict.rst:137
#: c-api/dict.rst:141
msgid ""
"Return a :c:type:`PyListObject` containing all the items from the dictionary."
msgstr ""
#: c-api/dict.rst:142
#: c-api/dict.rst:146
msgid ""
"Return a :c:type:`PyListObject` containing all the keys from the dictionary."
msgstr ""
#: c-api/dict.rst:147
#: c-api/dict.rst:151
msgid ""
"Return a :c:type:`PyListObject` containing all the values from the "
"dictionary *p*."
msgstr ""
#: c-api/dict.rst:155
#: c-api/dict.rst:159
msgid ""
"Return the number of items in the dictionary. This is equivalent to "
"``len(p)`` on a dictionary."
msgstr ""
#: c-api/dict.rst:161
#: c-api/dict.rst:165
msgid ""
"Iterate over all key-value pairs in the dictionary *p*. The :c:type:"
"`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` prior to the "
@ -182,18 +188,18 @@ msgid ""
"structure is sparse, the offsets are not consecutive."
msgstr ""
#: c-api/dict.rst:172
#: c-api/dict.rst:176
msgid "For example::"
msgstr "Par exemple ::"
#: c-api/dict.rst:182
#: c-api/dict.rst:186
msgid ""
"The dictionary *p* should not be mutated during iteration. It is safe to "
"modify the values of the keys as you iterate over the dictionary, but only "
"so long as the set of keys does not change. For example::"
msgstr ""
#: c-api/dict.rst:207
#: c-api/dict.rst:211
msgid ""
"Iterate over mapping object *b* adding key-value pairs to dictionary *a*. "
"*b* may be a dictionary, or any object supporting :c:func:`PyMapping_Keys` "
@ -203,7 +209,7 @@ msgid ""
"or ``-1`` if an exception was raised."
msgstr ""
#: c-api/dict.rst:217
#: c-api/dict.rst:221
msgid ""
"This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to ``a."
"update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall back "
@ -212,7 +218,7 @@ msgid ""
"exception was raised."
msgstr ""
#: c-api/dict.rst:226
#: c-api/dict.rst:230
msgid ""
"Update or merge into dictionary *a*, from the key-value pairs in *seq2*. "
"*seq2* must be an iterable object producing iterable objects of length 2, "

486
c-api/exceptions.po
View file

File diff suppressed because it is too large Load diff

27
c-api/function.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-27 19:26+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -73,46 +73,51 @@ msgstr ""
#: c-api/function.rst:64
msgid ""
"Return the *__module__* attribute of the function object *op*. This is "
"normally a string containing the module name, but can be set to any other "
"object by Python code."
"Return a :term:`borrowed reference` to the *__module__* attribute of the "
"function object *op*. It can be *NULL*."
msgstr ""
#: c-api/function.rst:71
#: c-api/function.rst:67
msgid ""
"This is normally a string containing the module name, but can be set to any "
"other object by Python code."
msgstr ""
#: c-api/function.rst:73
msgid ""
"Return the argument default values of the function object *op*. This can be "
"a tuple of arguments or ``NULL``."
msgstr ""
#: c-api/function.rst:77
#: c-api/function.rst:79
msgid ""
"Set the argument default values for the function object *op*. *defaults* "
"must be ``Py_None`` or a tuple."
msgstr ""
#: c-api/function.rst:94 c-api/function.rst:108
#: c-api/function.rst:96 c-api/function.rst:110
msgid "Raises :exc:`SystemError` and returns ``-1`` on failure."
msgstr ""
#: c-api/function.rst:85
#: c-api/function.rst:87
msgid ""
"Return the closure associated with the function object *op*. This can be "
"``NULL`` or a tuple of cell objects."
msgstr ""
#: c-api/function.rst:91
#: c-api/function.rst:93
msgid ""
"Set the closure associated with the function object *op*. *closure* must be "
"``Py_None`` or a tuple of cell objects."
msgstr ""
#: c-api/function.rst:99
#: c-api/function.rst:101
msgid ""
"Return the annotations of the function object *op*. This can be a mutable "
"dictionary or ``NULL``."
msgstr ""
#: c-api/function.rst:105
#: c-api/function.rst:107
msgid ""
"Set the annotations for the function object *op*. *annotations* must be a "
"dictionary or ``Py_None``."

44
c-api/gcsupport.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-05-29 16:33+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -239,3 +239,45 @@ msgid ""
"collector will call this method if it detects that this object is involved "
"in a reference cycle."
msgstr ""
#: c-api/gcsupport.rst:191
msgid "Controlling the Garbage Collector State"
msgstr ""
#: c-api/gcsupport.rst:193
msgid ""
"The C-API provides the following functions for controlling garbage "
"collection runs."
msgstr ""
#: c-api/gcsupport.rst:198
msgid ""
"Perform a full garbage collection, if the garbage collector is enabled. "
"(Note that :func:`gc.collect` runs it unconditionally.)"
msgstr ""
#: c-api/gcsupport.rst:201
msgid ""
"Returns the number of collected + unreachable objects which cannot be "
"collected. If the garbage collector is disabled or already collecting, "
"returns ``0`` immediately. Errors during garbage collection are passed to :"
"data:`sys.unraisablehook`. This function does not raise exceptions."
msgstr ""
#: c-api/gcsupport.rst:211
msgid ""
"Enable the garbage collector: similar to :func:`gc.enable`. Returns the "
"previous state, 0 for disabled and 1 for enabled."
msgstr ""
#: c-api/gcsupport.rst:219
msgid ""
"Disable the garbage collector: similar to :func:`gc.disable`. Returns the "
"previous state, 0 for disabled and 1 for enabled."
msgstr ""
#: c-api/gcsupport.rst:227
msgid ""
"Query the state of the garbage collector: similar to :func:`gc.isenabled`. "
"Returns the current state, 0 for disabled and 1 for enabled."
msgstr ""

11
c-api/import.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-10-01 16:00+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -311,6 +311,13 @@ msgid ""
"`name` field; failure to provide the sentinel value can result in a memory "
"fault. Returns ``0`` on success or ``-1`` if insufficient memory could be "
"allocated to extend the internal table. In the event of failure, no modules "
"are added to the internal table. This should be called before :c:func:"
"are added to the internal table. This must be called before :c:func:"
"`Py_Initialize`."
msgstr ""
#: c-api/import.rst:304
msgid ""
"If Python is initialized multiple times, :c:func:`PyImport_AppendInittab` "
"or :c:func:`PyImport_ExtendInittab` must be called before each Python "
"initialization."
msgstr ""

535
c-api/init.po
View file

File diff suppressed because it is too large Load diff

1879
c-api/init_config.po
View file

File diff suppressed because it is too large Load diff

83
c-api/intro.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-10-01 16:00+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -386,8 +386,8 @@ msgid ""
"passing on this responsibility (usually to its caller). When a function "
"passes ownership of a reference on to its caller, the caller is said to "
"receive a *new* reference. When no ownership is transferred, the caller is "
"said to *borrow* the reference. Nothing needs to be done for a borrowed "
"reference."
"said to *borrow* the reference. Nothing needs to be done for a :term:"
"`borrowed reference`."
msgstr ""
#: c-api/intro.rst:331
@ -704,78 +704,31 @@ msgstr ""
#: c-api/intro.rst:744
msgid ""
"Compiling the interpreter with the :c:macro:`Py_DEBUG` macro defined "
"produces what is generally meant by \"a debug build\" of Python. :c:macro:"
"`Py_DEBUG` is enabled in the Unix build by adding ``--with-pydebug`` to the :"
"file:`./configure` command. It is also implied by the presence of the not-"
"Python-specific :c:macro:`_DEBUG` macro. When :c:macro:`Py_DEBUG` is "
"enabled in the Unix build, compiler optimization is disabled."
"produces what is generally meant by :ref:`a debug build of Python <debug-"
"build>`. :c:macro:`Py_DEBUG` is enabled in the Unix build by adding :option:"
"`--with-pydebug` to the :file:`./configure` command. It is also implied by "
"the presence of the not-Python-specific :c:macro:`_DEBUG` macro. When :c:"
"macro:`Py_DEBUG` is enabled in the Unix build, compiler optimization is "
"disabled."
msgstr ""
#: c-api/intro.rst:751
#: c-api/intro.rst:752
msgid ""
"In addition to the reference count debugging described below, the following "
"extra checks are performed:"
"In addition to the reference count debugging described below, extra checks "
"are performed, see :ref:`Python Debug Build <debug-build>`."
msgstr ""
#: c-api/intro.rst:754
msgid "Extra checks are added to the object allocator."
msgstr ""
#: c-api/intro.rst:756
msgid "Extra checks are added to the parser and compiler."
msgstr ""
#: c-api/intro.rst:758
#: c-api/intro.rst:755
msgid ""
"Downcasts from wide types to narrow types are checked for loss of "
"information."
msgstr ""
#: c-api/intro.rst:760
msgid ""
"A number of assertions are added to the dictionary and set implementations. "
"In addition, the set object acquires a :meth:`test_c_api` method."
msgstr ""
#: c-api/intro.rst:763
msgid "Sanity checks of the input arguments are added to frame creation."
msgstr ""
#: c-api/intro.rst:765
msgid ""
"The storage for ints is initialized with a known invalid pattern to catch "
"reference to uninitialized digits."
msgstr ""
#: c-api/intro.rst:768
msgid ""
"Low-level tracing and extra exception checking are added to the runtime "
"virtual machine."
msgstr ""
#: c-api/intro.rst:771
msgid "Extra checks are added to the memory arena implementation."
msgstr ""
#: c-api/intro.rst:773
msgid "Extra debugging is added to the thread module."
msgstr ""
#: c-api/intro.rst:775
msgid "There may be additional checks not mentioned here."
msgstr ""
#: c-api/intro.rst:777
msgid ""
"Defining :c:macro:`Py_TRACE_REFS` enables reference tracing. When defined, "
"a circular doubly linked list of active objects is maintained by adding two "
"Defining :c:macro:`Py_TRACE_REFS` enables reference tracing (see the :option:"
"`configure --with-trace-refs option <--with-trace-refs>`). When defined, a "
"circular doubly linked list of active objects is maintained by adding two "
"extra fields to every :c:type:`PyObject`. Total allocations are tracked as "
"well. Upon exit, all existing references are printed. (In interactive mode "
"this happens after every statement run by the interpreter.) Implied by :c:"
"macro:`Py_DEBUG`."
"this happens after every statement run by the interpreter.)"
msgstr ""
#: c-api/intro.rst:783
#: c-api/intro.rst:762
msgid ""
"Please refer to :file:`Misc/SpecialBuilds.txt` in the Python source "
"distribution for more detailed information."

42
c-api/iter.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-27 19:26+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2018-02-15 00:33+0100\n"
"Last-Translator: Julien Palard <julien@palard.fr>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -25,11 +25,18 @@ msgstr "Il existe deux fonctions dédiées à l'interaction avec les itérateurs
#: c-api/iter.rst:12
#, fuzzy
msgid ""
"Return true if the object *o* supports the iterator protocol. This function "
"always succeeds."
"Return non-zero if the object *o* supports the iterator protocol, and ``0`` "
"otherwise. This function always succeeds."
msgstr "Renvoie vrai si l'objet *o* supporte le protocole d'itération."
#: c-api/iter.rst:18
#: c-api/iter.rst:17
#, fuzzy
msgid ""
"Returns non-zero if the object 'obj' provides :class:`AsyncIterator` "
"protocols, and ``0`` otherwise. This function always succeeds."
msgstr "Renvoie vrai si l'objet *o* supporte le protocole d'itération."
#: c-api/iter.rst:24
#, fuzzy
msgid ""
"Return the next value from the iteration *o*. The object must be an "
@ -43,10 +50,35 @@ msgstr ""
"déclarant une exception si une erreur survient lors de la récupération d'un "
"élément."
#: c-api/iter.rst:23
#: c-api/iter.rst:29
msgid ""
"To write a loop which iterates over an iterator, the C code should look "
"something like this::"
msgstr ""
"Pour écrire une boucle itérant un itérateur, le code C devrait ressembler "
"à ::"
#: c-api/iter.rst:58
msgid ""
"The enum value used to represent different results of :c:func:`PyIter_Send`."
msgstr ""
#: c-api/iter.rst:65
msgid "Sends the *arg* value into the iterator *iter*. Returns:"
msgstr ""
#: c-api/iter.rst:67
msgid ""
"``PYGEN_RETURN`` if iterator returns. Return value is returned via *presult*."
msgstr ""
#: c-api/iter.rst:68
msgid ""
"``PYGEN_NEXT`` if iterator yields. Yielded value is returned via *presult*."
msgstr ""
#: c-api/iter.rst:69
msgid ""
"``PYGEN_ERROR`` if iterator has raised and exception. *presult* is set to "
"``NULL``."
msgstr ""

95
c-api/long.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-27 19:26+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -126,53 +126,43 @@ msgid ""
msgstr ""
#: c-api/long.rst:99
msgid "Convert a sequence of Unicode digits to a Python integer value."
msgstr ""
#: c-api/long.rst:103
msgid ""
"Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:"
"func:`PyLong_FromUnicodeObject`."
msgstr ""
#: c-api/long.rst:108
msgid ""
"Convert a sequence of Unicode digits in the string *u* to a Python integer "
"value."
msgstr ""
#: c-api/long.rst:116
#: c-api/long.rst:107
msgid ""
"Create a Python integer from the pointer *p*. The pointer value can be "
"retrieved from the resulting value using :c:func:`PyLong_AsVoidPtr`."
msgstr ""
#: c-api/long.rst:146
#: c-api/long.rst:136
msgid ""
"Return a C :c:type:`long` representation of *obj*. If *obj* is not an "
"instance of :c:type:`PyLongObject`, first call its :meth:`__index__` or :"
"meth:`__int__` method (if present) to convert it to a :c:type:`PyLongObject`."
"instance of :c:type:`PyLongObject`, first call its :meth:`__index__` method "
"(if present) to convert it to a :c:type:`PyLongObject`."
msgstr ""
#: c-api/long.rst:132
#: c-api/long.rst:122
msgid ""
"Raise :exc:`OverflowError` if the value of *obj* is out of range for a :c:"
"type:`long`."
msgstr ""
#: c-api/long.rst:156 c-api/long.rst:199 c-api/long.rst:222
#: c-api/long.rst:145 c-api/long.rst:186 c-api/long.rst:209
msgid "Returns ``-1`` on error. Use :c:func:`PyErr_Occurred` to disambiguate."
msgstr ""
#: c-api/long.rst:158 c-api/long.rst:203 c-api/long.rst:308
#: c-api/long.rst:147 c-api/long.rst:190 c-api/long.rst:294
msgid "Use :meth:`__index__` if available."
msgstr ""
#: c-api/long.rst:161 c-api/long.rst:206 c-api/long.rst:311
msgid "Using :meth:`__int__` is deprecated."
#: c-api/long.rst:150 c-api/long.rst:193 c-api/long.rst:297
msgid "This function will no longer use :meth:`__int__`."
msgstr ""
#: c-api/long.rst:151
#: c-api/long.rst:140
msgid ""
"If the value of *obj* is greater than :const:`LONG_MAX` or less than :const:"
"`LONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and return "
@ -180,20 +170,20 @@ msgid ""
"occurs set *\\*overflow* to ``0`` and return ``-1`` as usual."
msgstr ""
#: c-api/long.rst:189
#: c-api/long.rst:177
msgid ""
"Return a C :c:type:`long long` representation of *obj*. If *obj* is not an "
"instance of :c:type:`PyLongObject`, first call its :meth:`__index__` or :"
"meth:`__int__` method (if present) to convert it to a :c:type:`PyLongObject`."
"instance of :c:type:`PyLongObject`, first call its :meth:`__index__` method "
"(if present) to convert it to a :c:type:`PyLongObject`."
msgstr ""
#: c-api/long.rst:175
#: c-api/long.rst:163
msgid ""
"Raise :exc:`OverflowError` if the value of *obj* is out of range for a :c:"
"type:`long long`."
msgstr ""
#: c-api/long.rst:194
#: c-api/long.rst:181
msgid ""
"If the value of *obj* is greater than :const:`LLONG_MAX` or less than :const:"
"`LLONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and return "
@ -201,134 +191,133 @@ msgid ""
"occurs set *\\*overflow* to ``0`` and return ``-1`` as usual."
msgstr ""
#: c-api/long.rst:216
#: c-api/long.rst:203
msgid ""
"Return a C :c:type:`Py_ssize_t` representation of *pylong*. *pylong* must "
"be an instance of :c:type:`PyLongObject`."
msgstr ""
#: c-api/long.rst:219
#: c-api/long.rst:206
msgid ""
"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:"
"type:`Py_ssize_t`."
msgstr ""
#: c-api/long.rst:231
#: c-api/long.rst:218
msgid ""
"Return a C :c:type:`unsigned long` representation of *pylong*. *pylong* "
"must be an instance of :c:type:`PyLongObject`."
msgstr ""
#: c-api/long.rst:234
#: c-api/long.rst:221
msgid ""
"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:"
"type:`unsigned long`."
msgstr ""
#: c-api/long.rst:237
#: c-api/long.rst:224
msgid ""
"Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to "
"disambiguate."
msgstr ""
#: c-api/long.rst:247
#: c-api/long.rst:234
msgid ""
"Return a C :c:type:`size_t` representation of *pylong*. *pylong* must be an "
"instance of :c:type:`PyLongObject`."
msgstr ""
#: c-api/long.rst:250
#: c-api/long.rst:237
msgid ""
"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:"
"type:`size_t`."
msgstr ""
#: c-api/long.rst:253
#: c-api/long.rst:240
msgid ""
"Returns ``(size_t)-1`` on error. Use :c:func:`PyErr_Occurred` to "
"disambiguate."
msgstr ""
#: c-api/long.rst:262
#: c-api/long.rst:249
msgid ""
"Return a C :c:type:`unsigned long long` representation of *pylong*. "
"*pylong* must be an instance of :c:type:`PyLongObject`."
msgstr ""
#: c-api/long.rst:265
#: c-api/long.rst:252
msgid ""
"Raise :exc:`OverflowError` if the value of *pylong* is out of range for an :"
"c:type:`unsigned long long`."
msgstr ""
#: c-api/long.rst:268
#: c-api/long.rst:255
msgid ""
"Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` to "
"disambiguate."
msgstr ""
#: c-api/long.rst:271
#: c-api/long.rst:258
msgid ""
"A negative *pylong* now raises :exc:`OverflowError`, not :exc:`TypeError`."
msgstr ""
#: c-api/long.rst:277
#: c-api/long.rst:264
msgid ""
"Return a C :c:type:`unsigned long` representation of *obj*. If *obj* is not "
"an instance of :c:type:`PyLongObject`, first call its :meth:`__index__` or :"
"meth:`__int__` method (if present) to convert it to a :c:type:`PyLongObject`."
"an instance of :c:type:`PyLongObject`, first call its :meth:`__index__` "
"method (if present) to convert it to a :c:type:`PyLongObject`."
msgstr ""
#: c-api/long.rst:282
#: c-api/long.rst:268
msgid ""
"If the value of *obj* is out of range for an :c:type:`unsigned long`, return "
"the reduction of that value modulo ``ULONG_MAX + 1``."
msgstr ""
#: c-api/long.rst:285
#: c-api/long.rst:271
msgid ""
"Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to "
"disambiguate."
msgstr ""
#: c-api/long.rst:297
#: c-api/long.rst:283
msgid ""
"Return a C :c:type:`unsigned long long` representation of *obj*. If *obj* "
"is not an instance of :c:type:`PyLongObject`, first call its :meth:"
"`__index__` or :meth:`__int__` method (if present) to convert it to a :c:"
"type:`PyLongObject`."
"`__index__` method (if present) to convert it to a :c:type:`PyLongObject`."
msgstr ""
#: c-api/long.rst:302
#: c-api/long.rst:288
msgid ""
"If the value of *obj* is out of range for an :c:type:`unsigned long long`, "
"return the reduction of that value modulo ``ULLONG_MAX + 1``."
msgstr ""
#: c-api/long.rst:305
#: c-api/long.rst:291
msgid ""
"Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` "
"to disambiguate."
msgstr ""
#: c-api/long.rst:317
#: c-api/long.rst:303
msgid ""
"Return a C :c:type:`double` representation of *pylong*. *pylong* must be an "
"instance of :c:type:`PyLongObject`."
msgstr ""
#: c-api/long.rst:320
#: c-api/long.rst:306
msgid ""
"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:"
"type:`double`."
msgstr ""
#: c-api/long.rst:323
#: c-api/long.rst:309
msgid ""
"Returns ``-1.0`` on error. Use :c:func:`PyErr_Occurred` to disambiguate."
msgstr ""
#: c-api/long.rst:328
#: c-api/long.rst:314
msgid ""
"Convert a Python integer *pylong* to a C :c:type:`void` pointer. If *pylong* "
"cannot be converted, an :exc:`OverflowError` will be raised. This is only "
@ -336,7 +325,7 @@ msgid ""
"c:func:`PyLong_FromVoidPtr`."
msgstr ""
#: c-api/long.rst:333
#: c-api/long.rst:319
msgid ""
"Returns ``NULL`` on error. Use :c:func:`PyErr_Occurred` to disambiguate."
msgstr ""

537
c-api/memory.po
View file

File diff suppressed because it is too large Load diff

174
c-api/module.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-27 19:26+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -213,7 +213,7 @@ msgid ""
"``NULL`` if not needed."
msgstr ""
#: c-api/module.rst:217 c-api/module.rst:232
#: c-api/module.rst:217 c-api/module.rst:238
msgid ""
"This function is not called if the module state was requested but is not "
"allocated yet. This is the case immediately after the module is created and "
@ -223,7 +223,7 @@ msgid ""
"``NULL``."
msgstr ""
#: c-api/module.rst:224 c-api/module.rst:239
#: c-api/module.rst:230 c-api/module.rst:245
msgid "No longer called before the module state is allocated."
msgstr ""
@ -233,55 +233,64 @@ msgid ""
"``NULL`` if not needed."
msgstr ""
#: c-api/module.rst:229
#: c-api/module.rst:224
msgid ""
"Like :c:member:`PyTypeObject.tp_clear`, this function is not *always* called "
"before a module is deallocated. For example, when reference counting is "
"enough to determine that an object is no longer used, the cyclic garbage "
"collector is not involved and :c:member:`~PyModuleDef.m_free` is called "
"directly."
msgstr ""
#: c-api/module.rst:235
msgid ""
"A function to call during deallocation of the module object, or ``NULL`` if "
"not needed."
msgstr ""
#: c-api/module.rst:243
#: c-api/module.rst:249
msgid "Single-phase initialization"
msgstr ""
#: c-api/module.rst:245
#: c-api/module.rst:251
msgid ""
"The module initialization function may create and return the module object "
"directly. This is referred to as \"single-phase initialization\", and uses "
"one of the following two module creation functions:"
msgstr ""
#: c-api/module.rst:251
#: c-api/module.rst:257
msgid ""
"Create a new module object, given the definition in *def*. This behaves "
"like :c:func:`PyModule_Create2` with *module_api_version* set to :const:"
"`PYTHON_API_VERSION`."
msgstr ""
#: c-api/module.rst:258
#: c-api/module.rst:264
msgid ""
"Create a new module object, given the definition in *def*, assuming the API "
"version *module_api_version*. If that version does not match the version of "
"the running interpreter, a :exc:`RuntimeWarning` is emitted."
msgstr ""
#: c-api/module.rst:264
#: c-api/module.rst:270
msgid ""
"Most uses of this function should be using :c:func:`PyModule_Create` "
"instead; only use this if you are sure you need it."
msgstr ""
#: c-api/module.rst:267
#: c-api/module.rst:273
msgid ""
"Before it is returned from in the initialization function, the resulting "
"module object is typically populated using functions like :c:func:"
"`PyModule_AddObject`."
"`PyModule_AddObjectRef`."
msgstr ""
#: c-api/module.rst:273
#: c-api/module.rst:279
msgid "Multi-phase initialization"
msgstr ""
#: c-api/module.rst:275
#: c-api/module.rst:281
msgid ""
"An alternate way to specify extensions is to request \"multi-phase "
"initialization\". Extension modules created this way behave more like Python "
@ -291,7 +300,7 @@ msgid ""
"methods of classes."
msgstr ""
#: c-api/module.rst:282
#: c-api/module.rst:288
msgid ""
"Unlike modules created using single-phase initialization, these modules are "
"not singletons: if the *sys.modules* entry is removed and the module is re-"
@ -304,14 +313,14 @@ msgid ""
"or individual classes created with :c:func:`PyType_FromSpec`)."
msgstr ""
#: c-api/module.rst:292
#: c-api/module.rst:298
msgid ""
"All modules created using multi-phase initialization are expected to "
"support :ref:`sub-interpreters <sub-interpreter-support>`. Making sure "
"multiple modules are independent is typically enough to achieve this."
msgstr ""
#: c-api/module.rst:296
#: c-api/module.rst:302
msgid ""
"To request multi-phase initialization, the initialization function "
"(PyInit_modulename) returns a :c:type:`PyModuleDef` instance with non-empty :"
@ -319,65 +328,65 @@ msgid ""
"instance must be initialized with the following function:"
msgstr ""
#: c-api/module.rst:303
#: c-api/module.rst:309
msgid ""
"Ensures a module definition is a properly initialized Python object that "
"correctly reports its type and reference count."
msgstr ""
#: c-api/module.rst:306
#: c-api/module.rst:312
msgid "Returns *def* cast to ``PyObject*``, or ``NULL`` if an error occurred."
msgstr ""
#: c-api/module.rst:310
#: c-api/module.rst:316
msgid ""
"The *m_slots* member of the module definition must point to an array of "
"``PyModuleDef_Slot`` structures:"
msgstr ""
#: c-api/module.rst:317
#: c-api/module.rst:323
msgid "A slot ID, chosen from the available values explained below."
msgstr ""
#: c-api/module.rst:321
#: c-api/module.rst:327
msgid "Value of the slot, whose meaning depends on the slot ID."
msgstr ""
#: c-api/module.rst:325
#: c-api/module.rst:331
msgid "The *m_slots* array must be terminated by a slot with id 0."
msgstr ""
#: c-api/module.rst:327
#: c-api/module.rst:333
msgid "The available slot types are:"
msgstr ""
#: c-api/module.rst:331
#: c-api/module.rst:337
msgid ""
"Specifies a function that is called to create the module object itself. The "
"*value* pointer of this slot must point to a function of the signature:"
msgstr ""
#: c-api/module.rst:336
#: c-api/module.rst:342
msgid ""
"The function receives a :py:class:`~importlib.machinery.ModuleSpec` "
"instance, as defined in :PEP:`451`, and the module definition. It should "
"return a new module object, or set an error and return ``NULL``."
msgstr ""
#: c-api/module.rst:341
#: c-api/module.rst:347
msgid ""
"This function should be kept minimal. In particular, it should not call "
"arbitrary Python code, as trying to import the same module again may result "
"in an infinite loop."
msgstr ""
#: c-api/module.rst:345
#: c-api/module.rst:351
msgid ""
"Multiple ``Py_mod_create`` slots may not be specified in one module "
"definition."
msgstr ""
#: c-api/module.rst:348
#: c-api/module.rst:354
msgid ""
"If ``Py_mod_create`` is not specified, the import machinery will create a "
"normal module object using :c:func:`PyModule_New`. The name is taken from "
@ -386,7 +395,7 @@ msgid ""
"through symlinks, all while sharing a single module definition."
msgstr ""
#: c-api/module.rst:354
#: c-api/module.rst:360
msgid ""
"There is no requirement for the returned object to be an instance of :c:type:"
"`PyModule_Type`. Any type can be used, as long as it supports setting and "
@ -396,7 +405,7 @@ msgid ""
"``Py_mod_create``."
msgstr ""
#: c-api/module.rst:363
#: c-api/module.rst:369
msgid ""
"Specifies a function that is called to *execute* the module. This is "
"equivalent to executing the code of a Python module: typically, this "
@ -404,21 +413,21 @@ msgid ""
"function is:"
msgstr ""
#: c-api/module.rst:370
#: c-api/module.rst:376
msgid ""
"If multiple ``Py_mod_exec`` slots are specified, they are processed in the "
"order they appear in the *m_slots* array."
msgstr ""
#: c-api/module.rst:373
#: c-api/module.rst:379
msgid "See :PEP:`489` for more details on multi-phase initialization."
msgstr ""
#: c-api/module.rst:376
#: c-api/module.rst:382
msgid "Low-level module creation functions"
msgstr ""
#: c-api/module.rst:378
#: c-api/module.rst:384
msgid ""
"The following functions are called under the hood when using multi-phase "
"initialization. They can be used directly, for example when creating module "
@ -426,14 +435,14 @@ msgid ""
"``PyModule_ExecDef`` must be called to fully initialize a module."
msgstr ""
#: c-api/module.rst:385
#: c-api/module.rst:391
msgid ""
"Create a new module object, given the definition in *module* and the "
"ModuleSpec *spec*. This behaves like :c:func:`PyModule_FromDefAndSpec2` "
"with *module_api_version* set to :const:`PYTHON_API_VERSION`."
msgstr ""
#: c-api/module.rst:393
#: c-api/module.rst:399
msgid ""
"Create a new module object, given the definition in *module* and the "
"ModuleSpec *spec*, assuming the API version *module_api_version*. If that "
@ -441,24 +450,24 @@ msgid ""
"`RuntimeWarning` is emitted."
msgstr ""
#: c-api/module.rst:400
#: c-api/module.rst:406
msgid ""
"Most uses of this function should be using :c:func:`PyModule_FromDefAndSpec` "
"instead; only use this if you are sure you need it."
msgstr ""
#: c-api/module.rst:407
#: c-api/module.rst:413
msgid "Process any execution slots (:c:data:`Py_mod_exec`) given in *def*."
msgstr ""
#: c-api/module.rst:413
#: c-api/module.rst:419
msgid ""
"Set the docstring for *module* to *docstring*. This function is called "
"automatically when creating a module from ``PyModuleDef``, using either "
"``PyModule_Create`` or ``PyModule_FromDefAndSpec``."
msgstr ""
#: c-api/module.rst:422
#: c-api/module.rst:428
msgid ""
"Add the functions from the ``NULL`` terminated *functions* array to "
"*module*. Refer to the :c:type:`PyMethodDef` documentation for details on "
@ -470,11 +479,11 @@ msgid ""
"``PyModule_FromDefAndSpec``."
msgstr ""
#: c-api/module.rst:434
#: c-api/module.rst:440
msgid "Support functions"
msgstr ""
#: c-api/module.rst:436
#: c-api/module.rst:442
msgid ""
"The module initialization function (if using single phase initialization) or "
"a function called from a module execution slot (if using multi-phase "
@ -482,40 +491,79 @@ msgid ""
"module state:"
msgstr ""
#: c-api/module.rst:443
#: c-api/module.rst:449
msgid ""
"Add an object to *module* as *name*. This is a convenience function which "
"can be used from the module's initialization function. This steals a "
"reference to *value* on success. Return ``-1`` on error, ``0`` on success."
"can be used from the module's initialization function."
msgstr ""
#: c-api/module.rst:449
#: c-api/module.rst:452
msgid ""
"On success, return ``0``. On error, raise an exception and return ``-1``."
msgstr ""
#: c-api/module.rst:454
msgid ""
"Return ``NULL`` if *value* is ``NULL``. It must be called with an exception "
"raised in this case."
msgstr ""
#: c-api/module.rst:506
msgid "Example usage::"
msgstr ""
#: c-api/module.rst:524
msgid ""
"The example can also be written without checking explicitly if *obj* is "
"``NULL``::"
msgstr ""
#: c-api/module.rst:540
msgid ""
"Note that ``Py_XDECREF()`` should be used instead of ``Py_DECREF()`` in this "
"case, since *obj* can be ``NULL``."
msgstr ""
#: c-api/module.rst:491
msgid ""
"Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to "
"*value* on success (if it returns ``0``)."
msgstr ""
#: c-api/module.rst:494
msgid ""
"The new :c:func:`PyModule_AddObjectRef` function is recommended, since it is "
"easy to introduce reference leaks by misusing the :c:func:"
"`PyModule_AddObject` function."
msgstr ""
#: c-api/module.rst:500
msgid ""
"Unlike other functions that steal references, ``PyModule_AddObject()`` only "
"decrements the reference count of *value* **on success**."
msgstr ""
#: c-api/module.rst:452
#: c-api/module.rst:503
msgid ""
"This means that its return value must be checked, and calling code must :c:"
"func:`Py_DECREF` *value* manually on error. Example usage::"
"func:`Py_DECREF` *value* manually on error."
msgstr ""
#: c-api/module.rst:464
#: c-api/module.rst:546
msgid ""
"Add an integer constant to *module* as *name*. This convenience function "
"can be used from the module's initialization function. Return ``-1`` on "
"error, ``0`` on success."
msgstr ""
#: c-api/module.rst:471
#: c-api/module.rst:553
msgid ""
"Add a string constant to *module* as *name*. This convenience function can "
"be used from the module's initialization function. The string *value* must "
"be ``NULL``-terminated. Return ``-1`` on error, ``0`` on success."
msgstr ""
#: c-api/module.rst:478
#: c-api/module.rst:560
msgid ""
"Add an int constant to *module*. The name and the value are taken from "
"*macro*. For example ``PyModule_AddIntMacro(module, AF_INET)`` adds the int "
@ -523,11 +571,11 @@ msgid ""
"error, ``0`` on success."
msgstr ""
#: c-api/module.rst:486
#: c-api/module.rst:568
msgid "Add a string constant to *module*."
msgstr ""
#: c-api/module.rst:490
#: c-api/module.rst:572
msgid ""
"Add a type object to *module*. The type object is finalized by calling "
"internally :c:func:`PyType_Ready`. The name of the type object is taken from "
@ -535,25 +583,25 @@ msgid ""
"``-1`` on error, ``0`` on success."
msgstr ""
#: c-api/module.rst:500
#: c-api/module.rst:582
msgid "Module lookup"
msgstr ""
#: c-api/module.rst:502
#: c-api/module.rst:584
msgid ""
"Single-phase initialization creates singleton modules that can be looked up "
"in the context of the current interpreter. This allows the module object to "
"be retrieved later with only a reference to the module definition."
msgstr ""
#: c-api/module.rst:506
#: c-api/module.rst:588
msgid ""
"These functions will not work on modules created using multi-phase "
"initialization, since multiple such modules can be created from a single "
"definition."
msgstr ""
#: c-api/module.rst:511
#: c-api/module.rst:593
msgid ""
"Returns the module object that was created from *def* for the current "
"interpreter. This method requires that the module object has been attached "
@ -562,18 +610,18 @@ msgid ""
"to the interpreter state yet, it returns ``NULL``."
msgstr ""
#: c-api/module.rst:518
#: c-api/module.rst:600
msgid ""
"Attaches the module object passed to the function to the interpreter state. "
"This allows the module object to be accessible via :c:func:"
"`PyState_FindModule`."
msgstr ""
#: c-api/module.rst:521
#: c-api/module.rst:603
msgid "Only effective on modules created using single-phase initialization."
msgstr ""
#: c-api/module.rst:523
#: c-api/module.rst:605
msgid ""
"Python calls ``PyState_AddModule`` automatically after importing a module, "
"so it is unnecessary (but harmless) to call it from module initialization "
@ -584,15 +632,15 @@ msgid ""
"state updates)."
msgstr ""
#: c-api/module.rst:542
#: c-api/module.rst:624
msgid "The caller must hold the GIL."
msgstr ""
#: c-api/module.rst:533
#: c-api/module.rst:615
msgid "Return 0 on success or -1 on failure."
msgstr ""
#: c-api/module.rst:539
#: c-api/module.rst:621
msgid ""
"Removes the module object created from *def* from the interpreter state. "
"Return 0 on success or -1 on failure."

16
c-api/number.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -256,7 +256,13 @@ msgid ""
"`TypeError` exception raised on failure."
msgstr ""
#: c-api/number.rst:262
#: c-api/number.rst:259
msgid ""
"The result always has exact type :class:`int`. Previously, the result could "
"have been an instance of a subclass of ``int``."
msgstr ""
#: c-api/number.rst:266
msgid ""
"Returns the integer *n* converted to base *base* as a string. The *base* "
"argument must be one of 2, 8, 10, or 16. For base 2, 8, or 16, the returned "
@ -265,13 +271,13 @@ msgid ""
"`PyNumber_Index` first."
msgstr ""
#: c-api/number.rst:271
#: c-api/number.rst:275
msgid ""
"Returns *o* converted to a Py_ssize_t value if *o* can be interpreted as an "
"integer. If the call fails, an exception is raised and ``-1`` is returned."
msgstr ""
#: c-api/number.rst:274
#: c-api/number.rst:278
msgid ""
"If *o* can be converted to a Python int but the attempt to convert to a "
"Py_ssize_t value would raise an :exc:`OverflowError`, then the *exc* "
@ -281,7 +287,7 @@ msgid ""
"negative integer or ``PY_SSIZE_T_MAX`` for a positive integer."
msgstr ""
#: c-api/number.rst:284
#: c-api/number.rst:288
msgid ""
"Returns ``1`` if *o* is an index integer (has the nb_index slot of the "
"tp_as_number structure filled in), and ``0`` otherwise. This function always "

15
c-api/object.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-06-22 09:58+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2019-08-16 22:56+0200\n"
"Last-Translator: Julien Palard <julien@palard.fr>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -428,8 +428,8 @@ msgstr ""
#: c-api/object.rst:300
msgid ""
"Return true if the object *o* is of type *type* or a subtype of *type*. "
"Both parameters must be non-``NULL``."
"Return non-zero if the object *o* is of type *type* or a subtype of *type*, "
"and ``0`` otherwise. Both parameters must be non-``NULL``."
msgstr ""
#: c-api/object.rst:309
@ -499,6 +499,15 @@ msgid ""
"object cannot be iterated."
msgstr ""
#: c-api/object.rst:363
msgid ""
"This is the equivalent to the Python expression ``aiter(o)``. Takes an :"
"class:`AsyncIterable` object and returns an :class:`AsyncIterator` for it. "
"This is typically a new iterator but if the argument is an :class:"
"`AsyncIterator`, this returns itself. Raises :exc:`TypeError` and returns "
"``NULL`` if the object cannot be iterated."
msgstr ""
#~ msgid ""
#~ "Determine if the object *o* is callable. Return ``1`` if the object is "
#~ "callable and ``0`` otherwise. This function always succeeds."

98
c-api/refcounting.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -25,27 +25,93 @@ msgid ""
msgstr ""
#: c-api/refcounting.rst:16
msgid "Increment the reference count for object *o*."
msgstr ""
#: c-api/refcounting.rst:18
msgid ""
"Increment the reference count for object *o*. The object must not be "
"``NULL``; if you aren't sure that it isn't ``NULL``, use :c:func:"
"`Py_XINCREF`."
"This function is usually used to convert a :term:`borrowed reference` to a :"
"term:`strong reference` in-place. The :c:func:`Py_NewRef` function can be "
"used to create a new :term:`strong reference`."
msgstr ""
#: c-api/refcounting.rst:22
msgid ""
"The object must not be ``NULL``; if you aren't sure that it isn't ``NULL``, "
"use :c:func:`Py_XINCREF`."
msgstr ""
#: c-api/refcounting.rst:28
msgid ""
"Increment the reference count for object *o*. The object may be ``NULL``, "
"in which case the macro has no effect."
msgstr ""
#: c-api/refcounting.rst:28
msgid ""
"Decrement the reference count for object *o*. The object must not be "
"``NULL``; if you aren't sure that it isn't ``NULL``, use :c:func:"
"`Py_XDECREF`. If the reference count reaches zero, the object's type's "
"deallocation function (which must not be ``NULL``) is invoked."
#: c-api/refcounting.rst:31
msgid "See also :c:func:`Py_XNewRef`."
msgstr ""
#: c-api/refcounting.rst:35
#: c-api/refcounting.rst:36
msgid ""
"Create a new :term:`strong reference` to an object: increment the reference "
"count of the object *o* and return the object *o*."
msgstr ""
#: c-api/refcounting.rst:39
msgid ""
"When the :term:`strong reference` is no longer needed, :c:func:`Py_DECREF` "
"should be called on it to decrement the object reference count."
msgstr ""
#: c-api/refcounting.rst:42
msgid ""
"The object *o* must not be ``NULL``; use :c:func:`Py_XNewRef` if *o* can be "
"``NULL``."
msgstr ""
#: c-api/refcounting.rst:45
msgid "For example::"
msgstr ""
#: c-api/refcounting.rst:50
msgid "can be written as::"
msgstr ""
#: c-api/refcounting.rst:54
msgid "See also :c:func:`Py_INCREF`."
msgstr ""
#: c-api/refcounting.rst:61
msgid "Similar to :c:func:`Py_NewRef`, but the object *o* can be NULL."
msgstr ""
#: c-api/refcounting.rst:63
msgid "If the object *o* is ``NULL``, the function just returns ``NULL``."
msgstr ""
#: c-api/refcounting.rst:70
msgid "Decrement the reference count for object *o*."
msgstr ""
#: c-api/refcounting.rst:72
msgid ""
"If the reference count reaches zero, the object's type's deallocation "
"function (which must not be ``NULL``) is invoked."
msgstr ""
#: c-api/refcounting.rst:75
msgid ""
"This function is usually used to delete a :term:`strong reference` before "
"exiting its scope."
msgstr ""
#: c-api/refcounting.rst:78
msgid ""
"The object must not be ``NULL``; if you aren't sure that it isn't ``NULL``, "
"use :c:func:`Py_XDECREF`."
msgstr ""
#: c-api/refcounting.rst:83
msgid ""
"The deallocation function can cause arbitrary Python code to be invoked (e."
"g. when a class instance with a :meth:`__del__` method is deallocated). "
@ -58,14 +124,14 @@ msgid ""
"temporary variable."
msgstr ""
#: c-api/refcounting.rst:47
#: c-api/refcounting.rst:95
msgid ""
"Decrement the reference count for object *o*. The object may be ``NULL``, "
"in which case the macro has no effect; otherwise the effect is the same as "
"for :c:func:`Py_DECREF`, and the same warning applies."
msgstr ""
#: c-api/refcounting.rst:54
#: c-api/refcounting.rst:102
msgid ""
"Decrement the reference count for object *o*. The object may be ``NULL``, "
"in which case the macro has no effect; otherwise the effect is the same as "
@ -75,13 +141,13 @@ msgid ""
"the argument to ``NULL`` before decrementing its reference count."
msgstr ""
#: c-api/refcounting.rst:61
#: c-api/refcounting.rst:109
msgid ""
"It is a good idea to use this macro whenever decrementing the reference "
"count of an object that might be traversed during garbage collection."
msgstr ""
#: c-api/refcounting.rst:65
#: c-api/refcounting.rst:113
msgid ""
"The following functions are for runtime dynamic embedding of Python: "
"``Py_IncRef(PyObject *o)``, ``Py_DecRef(PyObject *o)``. They are simply "
@ -89,7 +155,7 @@ msgid ""
"respectively."
msgstr ""
#: c-api/refcounting.rst:70
#: c-api/refcounting.rst:118
msgid ""
"The following functions or macros are only for use within the interpreter "
"core: :c:func:`_Py_Dealloc`, :c:func:`_Py_ForgetReference`, :c:func:"

7
c-api/reflection.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-10-01 16:00+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2019-02-26 12:01+0100\n"
"Last-Translator: Julien Palard <julien@palard.fr>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -63,7 +63,8 @@ msgid "Get the *frame* next outer frame."
msgstr ""
#: c-api/reflection.rst:38
msgid "Return a strong reference, or ``NULL`` if *frame* has no outer frame."
msgid ""
"Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer frame."
msgstr ""
#: c-api/reflection.rst:60
@ -75,7 +76,7 @@ msgid "Get the *frame* code."
msgstr ""
#: c-api/reflection.rst:49
msgid "Return a strong reference."
msgid "Return a :term:`strong reference`."
msgstr ""
#: c-api/reflection.rst:51

34
c-api/set.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-27 19:26+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -86,19 +86,25 @@ msgid ""
"an instance of a subtype. This function always succeeds."
msgstr ""
#: c-api/set.rst:71
#: c-api/set.rst:70
msgid ""
"Return true if *p* is a :class:`set` object but not an instance of a "
"subtype. This function always succeeds."
msgstr ""
#: c-api/set.rst:77
msgid ""
"Return true if *p* is a :class:`set` object or a :class:`frozenset` object "
"but not an instance of a subtype. This function always succeeds."
msgstr ""
#: c-api/set.rst:77
#: c-api/set.rst:83
msgid ""
"Return true if *p* is a :class:`frozenset` object but not an instance of a "
"subtype. This function always succeeds."
msgstr ""
#: c-api/set.rst:83
#: c-api/set.rst:89
msgid ""
"Return a new :class:`set` containing objects returned by the *iterable*. "
"The *iterable* may be ``NULL`` to create a new empty set. Return the new "
@ -107,7 +113,7 @@ msgid ""
"(``c=set(s)``)."
msgstr ""
#: c-api/set.rst:92
#: c-api/set.rst:98
msgid ""
"Return a new :class:`frozenset` containing objects returned by the "
"*iterable*. The *iterable* may be ``NULL`` to create a new empty frozenset. "
@ -115,24 +121,24 @@ msgid ""
"`TypeError` if *iterable* is not actually iterable."
msgstr ""
#: c-api/set.rst:98
#: c-api/set.rst:104
msgid ""
"The following functions and macros are available for instances of :class:"
"`set` or :class:`frozenset` or instances of their subtypes."
msgstr ""
#: c-api/set.rst:106
#: c-api/set.rst:112
msgid ""
"Return the length of a :class:`set` or :class:`frozenset` object. Equivalent "
"to ``len(anyset)``. Raises a :exc:`PyExc_SystemError` if *anyset* is not a :"
"class:`set`, :class:`frozenset`, or an instance of a subtype."
msgstr ""
#: c-api/set.rst:113
#: c-api/set.rst:119
msgid "Macro form of :c:func:`PySet_Size` without error checking."
msgstr ""
#: c-api/set.rst:118
#: c-api/set.rst:124
msgid ""
"Return ``1`` if found, ``0`` if not found, and ``-1`` if an error is "
"encountered. Unlike the Python :meth:`__contains__` method, this function "
@ -142,7 +148,7 @@ msgid ""
"or an instance of a subtype."
msgstr ""
#: c-api/set.rst:127
#: c-api/set.rst:133
msgid ""
"Add *key* to a :class:`set` instance. Also works with :class:`frozenset` "
"instances (like :c:func:`PyTuple_SetItem` it can be used to fill-in the "
@ -153,13 +159,13 @@ msgid ""
"`set` or its subtype."
msgstr ""
#: c-api/set.rst:136
#: c-api/set.rst:142
msgid ""
"The following functions are available for instances of :class:`set` or its "
"subtypes but not for instances of :class:`frozenset` or its subtypes."
msgstr ""
#: c-api/set.rst:142
#: c-api/set.rst:148
msgid ""
"Return ``1`` if found and removed, ``0`` if not found (no action taken), and "
"``-1`` if an error is encountered. Does not raise :exc:`KeyError` for "
@ -170,7 +176,7 @@ msgid ""
"subtype."
msgstr ""
#: c-api/set.rst:152
#: c-api/set.rst:158
msgid ""
"Return a new reference to an arbitrary object in the *set*, and removes the "
"object from the *set*. Return ``NULL`` on failure. Raise :exc:`KeyError` "
@ -178,6 +184,6 @@ msgid ""
"of :class:`set` or its subtype."
msgstr ""
#: c-api/set.rst:160
#: c-api/set.rst:166
msgid "Empty an existing set of all elements."
msgstr ""

334
c-api/stable.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2018-10-04 12:26+0200\n"
"Last-Translator: Julien Palard <julien@palard.fr>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -15,83 +15,291 @@ msgstr ""
"Content-Transfer-Encoding: 8bit\n"
#: c-api/stable.rst:7
msgid "Stable Application Binary Interface"
msgstr "ABI Stable"
msgid "C API Stability"
msgstr ""
#: c-api/stable.rst:9
#, fuzzy
msgid ""
"Traditionally, the C API of Python will change with every release. Most "
"changes will be source-compatible, typically by only adding API, rather than "
"changing existing API or removing API (although some interfaces do get "
"removed after being deprecated first)."
"Python's C API is covered by the Backwards Compatibility Policy, :pep:`387`. "
"While the C API will change with every minor release (e.g. from 3.9 to "
"3.10), most changes will be source-compatible, typically by only adding new "
"API. Changing existing API or removing API is only done after a deprecation "
"period or to fix serious issues."
msgstr ""
"L'API C de Python change à chaque version. La majorité de ces changement "
"n'affecte cependant pas la compatibilité du code source. Typiquement, des "
"API sont ajoutées, mais ni modifiées ni supprimées (bien que certaines "
"interfaces puissent être supprimées, après avoir d'abord été dépréciées)."
#: c-api/stable.rst:14
#: c-api/stable.rst:15
msgid ""
"Unfortunately, the API compatibility does not extend to binary compatibility "
"(the ABI). The reason is primarily the evolution of struct definitions, "
"where addition of a new field, or changing the type of a field, might not "
"break the API, but can break the ABI. As a consequence, extension modules "
"need to be recompiled for every Python release (although an exception is "
"possible on Unix when none of the affected interfaces are used). In "
"addition, on Windows, extension modules link with a specific pythonXY.dll "
"and need to be recompiled to link with a newer one."
"CPython's Application Binary Interface (ABI) is forward- and backwards-"
"compatible across a minor release (if these are compiled the same way; see :"
"ref:`stable-abi-platform` below). So, code compiled for Python 3.10.0 will "
"work on 3.10.8 and vice versa, but will need to be compiled separately for "
"3.9.x and 3.10.x."
msgstr ""
"Malheureusement, la compatibilité de l'API ne s'étend pas à une "
"compatibilité binaire (l'ABI). L'évolution des structures en est la raison "
"principale : l'ajout de nouveaux attributs, ou le changement du type d'un "
"attribut peut ne pas casser l'API mais casser l'ABI. Par conséquent, les "
"modules d'extension doivent être recompilés à chaque nouvelle version de "
"Python (ce n'est exceptionnellement pas nécessaire sur Unix, si aucune des "
"interfaces modifiées n'est utilisée). De plus, sous Windows, les modules "
"d'extension sont liés à un *pythonXY.dll* spécifique, ils est donc "
"nécessaire de les recompiler pour les lier au nouveau DLL."
#: c-api/stable.rst:23
#: c-api/stable.rst:21
msgid ""
"Since Python 3.2, a subset of the API has been declared to guarantee a "
"stable ABI. Extension modules wishing to use this API (called \"limited API"
"\") need to define ``Py_LIMITED_API``. A number of interpreter details then "
"become hidden from the extension module; in return, a module is built that "
"works on any 3.x version (x>=2) without recompilation."
"Names prefixed by an underscore, such as ``_Py_InternalState``, are private "
"API that can change without notice even in patch releases."
msgstr ""
"Depuis Python 3.2 il est garanti qu'une certaine partie de l'API gardera une "
"ABI stable. Les modules d'extension souhaitant utiliser cette API (Appellée "
"\"API limitée\") doivent définir ``Py_LIMITED_API``. Des spécificités de "
"l'interpréteur sont alors cachées au module, en contrepartie le module "
"devient compatible avec toutes les versions de Python 3.x (x>=2) sans "
"recompilation."
#: c-api/stable.rst:29
msgid ""
"In some cases, the stable ABI needs to be extended with new functions. "
"Extension modules wishing to use these new APIs need to set "
"``Py_LIMITED_API`` to the ``PY_VERSION_HEX`` value (see :ref:"
"`apiabiversion`) of the minimum Python version they want to support (e.g. "
"``0x03030000`` for Python 3.3). Such modules will work on all subsequent "
"Python releases, but fail to load (because of missing symbols) on the older "
"releases."
msgstr ""
"Dans certains cas, il est nécessaire d'étendre l'ABI stable avec de "
"nouvelles fonctions. Les modules d'extension souhaitant utiliser ces "
"nouvelles APIs doivent configurer ``Py_LIMITED_API`` à la valeur "
"``Py_VERSION_HEX`` correspondant à la plus ancienne version de Python qu'ils "
"souhaitent supporter (voir :ref:`apiabiversion`, par exemple ``0x03030000`` "
"pour Python 3.3). De tels modules fonctionneront dans toutes les versions "
"ultérieures de Python, mais ne pourront pas se charger (dû à des symboles "
"manquants) sur les versions plus anciennes."
#: c-api/stable.rst:26
msgid "Stable Application Binary Interface"
msgstr "ABI Stable"
#: c-api/stable.rst:36
#: c-api/stable.rst:28
msgid ""
"As of Python 3.2, the set of functions available to the limited API is "
"documented in :pep:`384`. In the C API documentation, API elements that are "
"not part of the limited API are marked as \"Not part of the limited API.\""
"Python 3.2 introduced the *Limited API*, a subset of Python's C API. "
"Extensions that only use the Limited API can be compiled once and work with "
"multiple versions of Python. Contents of the Limited API are :ref:`listed "
"below <stable-abi-list>`."
msgstr ""
"Depuis Python 3.2, l'ensemble des fonctions exposées par l'API limitée est "
"documentée dans la :pep:`384`. Dans la documentation de l'API C, les "
"éléments ne faisant pas partie de l'API limitée sont notés \"Ne faisant pas "
"partie de l'API limitée\" (*\"Not part of the limited API\"*)."
#: c-api/stable.rst:33
msgid ""
"To enable this, Python provides a *Stable ABI*: a set of symbols that will "
"remain compatible across Python 3.x versions. The Stable ABI contains "
"symbols exposed in the Limited API, but also other ones – for example, "
"functions necessary to support older versions of the Limited API."
msgstr ""
#: c-api/stable.rst:38
msgid ""
"(For simplicity, this document talks about *extensions*, but the Limited API "
"and Stable ABI work the same way for all uses of the API – for example, "
"embedding Python.)"
msgstr ""
#: c-api/stable.rst:44
msgid ""
"Define this macro before including ``Python.h`` to opt in to only use the "
"Limited API, and to select the Limited API version."
msgstr ""
#: c-api/stable.rst:47
msgid ""
"Define ``Py_LIMITED_API`` to the value of :c:data:`PY_VERSION_HEX` "
"corresponding to the lowest Python version your extension supports. The "
"extension will work without recompilation with all Python 3 releases from "
"the specified one onward, and can use Limited API introduced up to that "
"version."
msgstr ""
#: c-api/stable.rst:53
msgid ""
"Rather than using the ``PY_VERSION_HEX`` macro directly, hardcode a minimum "
"minor version (e.g. ``0x030A0000`` for Python 3.10) for stability when "
"compiling with future Python versions."
msgstr ""
#: c-api/stable.rst:57
msgid ""
"You can also define ``Py_LIMITED_API`` to ``3``. This works the same as "
"``0x03020000`` (Python 3.2, the version that introduced Limited API)."
msgstr ""
#: c-api/stable.rst:60
msgid ""
"On Windows, extensions that use the Stable ABI should be linked against "
"``python3.dll`` rather than a version-specific library such as ``python39."
"dll``."
msgstr ""
#: c-api/stable.rst:64
msgid ""
"On some platforms, Python will look for and load shared library files named "
"with the ``abi3`` tag (e.g. ``mymodule.abi3.so``). It does not check if such "
"extensions conform to a Stable ABI. The user (or their packaging tools) need "
"to ensure that, for example, extensions built with the 3.10+ Limited API are "
"not installed for lower versions of Python."
msgstr ""
#: c-api/stable.rst:71
msgid ""
"All functions in the Stable ABI are present as functions in Python's shared "
"library, not solely as macros. This makes them usable from languages that "
"don't use the C preprocessor."
msgstr ""
#: c-api/stable.rst:77
msgid "Limited API Scope and Performance"
msgstr ""
#: c-api/stable.rst:79
msgid ""
"The goal for the Limited API is to allow everything that is possible with "
"the full C API, but possibly with a performance penalty."
msgstr ""
#: c-api/stable.rst:82
msgid ""
"For example, while :c:func:`PyList_GetItem` is available, its “unsafe” macro "
"variant :c:func:`PyList_GET_ITEM` is not. The macro can be faster because it "
"can rely on version-specific implementation details of the list object."
msgstr ""
#: c-api/stable.rst:87
msgid ""
"Without ``Py_LIMITED_API`` defined, some C API functions are inlined or "
"replaced by macros. Defining ``Py_LIMITED_API`` disables this inlining, "
"allowing stability as Python's data structures are improved, but possibly "
"reducing performance."
msgstr ""
#: c-api/stable.rst:92
msgid ""
"By leaving out the ``Py_LIMITED_API`` definition, it is possible to compile "
"a Limited API extension with a version-specific ABI. This can improve "
"performance for that Python version, but will limit compatibility. Compiling "
"with ``Py_LIMITED_API`` will then yield an extension that can be distributed "
"where a version-specific one is not available – for example, for prereleases "
"of an upcoming Python version."
msgstr ""
#: c-api/stable.rst:101
msgid "Limited API Caveats"
msgstr ""
#: c-api/stable.rst:103
msgid ""
"Note that compiling with ``Py_LIMITED_API`` is *not* a complete guarantee "
"that code conforms to the Limited API or the Stable ABI. ``Py_LIMITED_API`` "
"only covers definitions, but an API also includes other issues, such as "
"expected semantics."
msgstr ""
#: c-api/stable.rst:108
msgid ""
"One issue that ``Py_LIMITED_API`` does not guard against is calling a "
"function with arguments that are invalid in a lower Python version. For "
"example, consider a function that starts accepting ``NULL`` for an argument. "
"In Python 3.9, ``NULL`` now selects a default behavior, but in Python 3.8, "
"the argument will be used directly, causing a ``NULL`` dereference and "
"crash. A similar argument works for fields of structs."
msgstr ""
#: c-api/stable.rst:115
msgid ""
"Another issue is that some struct fields are currently not hidden when "
"``Py_LIMITED_API`` is defined, even though they're part of the Limited API."
msgstr ""
#: c-api/stable.rst:118
msgid ""
"For these reasons, we recommend testing an extension with *all* minor Python "
"versions it supports, and preferably to build with the *lowest* such version."
msgstr ""
#: c-api/stable.rst:121
msgid ""
"We also recommend reviewing documentation of all used API to check if it is "
"explicitly part of the Limited API. Even with ``Py_LIMITED_API`` defined, a "
"few private declarations are exposed for technical reasons (or even "
"unintentionally, as bugs)."
msgstr ""
#: c-api/stable.rst:126
msgid ""
"Also note that the Limited API is not necessarily stable: compiling with "
"``Py_LIMITED_API`` with Python 3.8 means that the extension will run with "
"Python 3.12, but it will not necessarily *compile* with Python 3.12. In "
"particular, parts of the Limited API may be deprecated and removed, provided "
"that the Stable ABI stays stable."
msgstr ""
#: c-api/stable.rst:136
msgid "Platform Considerations"
msgstr ""
#: c-api/stable.rst:138
msgid ""
"ABI stability depends not only on Python, but also on the compiler used, "
"lower-level libraries and compiler options. For the purposes of the Stable "
"ABI, these details define a “platform”. They usually depend on the OS type "
"and processor architecture"
msgstr ""
#: c-api/stable.rst:143
msgid ""
"It is the responsibility of each particular distributor of Python to ensure "
"that all Python versions on a particular platform are built in a way that "
"does not break the Stable ABI. This is the case with Windows and macOS "
"releases from ``python.org`` and many third-party distributors."
msgstr ""
#: c-api/stable.rst:153
msgid "Contents of Limited API"
msgstr ""
#: c-api/stable.rst:156
msgid "Currently, the Limited API includes the following items:"
msgstr ""
#~ msgid ""
#~ "Unfortunately, the API compatibility does not extend to binary "
#~ "compatibility (the ABI). The reason is primarily the evolution of struct "
#~ "definitions, where addition of a new field, or changing the type of a "
#~ "field, might not break the API, but can break the ABI. As a consequence, "
#~ "extension modules need to be recompiled for every Python release "
#~ "(although an exception is possible on Unix when none of the affected "
#~ "interfaces are used). In addition, on Windows, extension modules link "
#~ "with a specific pythonXY.dll and need to be recompiled to link with a "
#~ "newer one."
#~ msgstr ""
#~ "Malheureusement, la compatibilité de l'API ne s'étend pas à une "
#~ "compatibilité binaire (l'ABI). L'évolution des structures en est la "
#~ "raison principale : l'ajout de nouveaux attributs, ou le changement du "
#~ "type d'un attribut peut ne pas casser l'API mais casser l'ABI. Par "
#~ "conséquent, les modules d'extension doivent être recompilés à chaque "
#~ "nouvelle version de Python (ce n'est exceptionnellement pas nécessaire "
#~ "sur Unix, si aucune des interfaces modifiées n'est utilisée). De plus, "
#~ "sous Windows, les modules d'extension sont liés à un *pythonXY.dll* "
#~ "spécifique, ils est donc nécessaire de les recompiler pour les lier au "
#~ "nouveau DLL."
#~ msgid ""
#~ "Since Python 3.2, a subset of the API has been declared to guarantee a "
#~ "stable ABI. Extension modules wishing to use this API (called \"limited "
#~ "API\") need to define ``Py_LIMITED_API``. A number of interpreter details "
#~ "then become hidden from the extension module; in return, a module is "
#~ "built that works on any 3.x version (x>=2) without recompilation."
#~ msgstr ""
#~ "Depuis Python 3.2 il est garanti qu'une certaine partie de l'API gardera "
#~ "une ABI stable. Les modules d'extension souhaitant utiliser cette API "
#~ "(Appellée \"API limitée\") doivent définir ``Py_LIMITED_API``. Des "
#~ "spécificités de l'interpréteur sont alors cachées au module, en "
#~ "contrepartie le module devient compatible avec toutes les versions de "
#~ "Python 3.x (x>=2) sans recompilation."
#~ msgid ""
#~ "In some cases, the stable ABI needs to be extended with new functions. "
#~ "Extension modules wishing to use these new APIs need to set "
#~ "``Py_LIMITED_API`` to the ``PY_VERSION_HEX`` value (see :ref:"
#~ "`apiabiversion`) of the minimum Python version they want to support (e.g. "
#~ "``0x03030000`` for Python 3.3). Such modules will work on all subsequent "
#~ "Python releases, but fail to load (because of missing symbols) on the "
#~ "older releases."
#~ msgstr ""
#~ "Dans certains cas, il est nécessaire d'étendre l'ABI stable avec de "
#~ "nouvelles fonctions. Les modules d'extension souhaitant utiliser ces "
#~ "nouvelles APIs doivent configurer ``Py_LIMITED_API`` à la valeur "
#~ "``Py_VERSION_HEX`` correspondant à la plus ancienne version de Python "
#~ "qu'ils souhaitent supporter (voir :ref:`apiabiversion`, par exemple "
#~ "``0x03030000`` pour Python 3.3). De tels modules fonctionneront dans "
#~ "toutes les versions ultérieures de Python, mais ne pourront pas se "
#~ "charger (dû à des symboles manquants) sur les versions plus anciennes."
#~ msgid ""
#~ "As of Python 3.2, the set of functions available to the limited API is "
#~ "documented in :pep:`384`. In the C API documentation, API elements that "
#~ "are not part of the limited API are marked as \"Not part of the limited "
#~ "API.\""
#~ msgstr ""
#~ "Depuis Python 3.2, l'ensemble des fonctions exposées par l'API limitée "
#~ "est documentée dans la :pep:`384`. Dans la documentation de l'API C, les "
#~ "éléments ne faisant pas partie de l'API limitée sont notés \"Ne faisant "
#~ "pas partie de l'API limitée\" (*\"Not part of the limited API\"*)."

300
c-api/structures.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-10-01 16:00+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -81,58 +81,93 @@ msgstr ""
#: c-api/structures.rst:67
msgid ""
"This macro is used to access the :attr:`ob_type` member of a Python object. "
"It expands to::"
"Test if the *x* object is the *y* object, the same as ``x is y`` in Python."
msgstr ""
#: c-api/structures.rst:75
#: c-api/structures.rst:74
msgid ""
"Test if an object is the ``None`` singleton, the same as ``x is None`` in "
"Python."
msgstr ""
#: c-api/structures.rst:82
msgid ""
"Test if an object is the ``True`` singleton, the same as ``x is True`` in "
"Python."
msgstr ""
#: c-api/structures.rst:90
msgid ""
"Test if an object is the ``False`` singleton, the same as ``x is False`` in "
"Python."
msgstr ""
#: c-api/structures.rst:98
msgid "Get the type of the Python object *o*."
msgstr ""
#: c-api/structures.rst:100
msgid "Return a :term:`borrowed reference`."
msgstr ""
#: c-api/structures.rst:102
msgid "The :c:func:`Py_SET_TYPE` function must be used to set an object type."
msgstr ""
#: c-api/structures.rst:107
msgid ""
"Return non-zero if the object *o* type is *type*. Return zero otherwise. "
"Equivalent to: ``Py_TYPE(o) == type``."
msgstr ""
#: c-api/structures.rst:83
#: c-api/structures.rst:115
msgid "Set the object *o* type to *type*."
msgstr ""
#: c-api/structures.rst:90
msgid ""
"This macro is used to access the :attr:`ob_refcnt` member of a Python "
"object. It expands to::"
#: c-api/structures.rst:122
msgid "Get the reference count of the Python object *o*."
msgstr ""
#: c-api/structures.rst:99
#: c-api/structures.rst:124
msgid ""
":c:func:`Py_REFCNT()` is changed to the inline static function. Use :c:func:"
"`Py_SET_REFCNT()` to set an object reference count."
msgstr ""
#: c-api/structures.rst:131
msgid "Set the object *o* reference counter to *refcnt*."
msgstr ""
#: c-api/structures.rst:106
msgid ""
"This macro is used to access the :attr:`ob_size` member of a Python object. "
"It expands to::"
#: c-api/structures.rst:138
msgid "Get the size of the Python object *o*."
msgstr ""
#: c-api/structures.rst:114
#: c-api/structures.rst:140
msgid "The :c:func:`Py_SET_SIZE` function must be used to set an object size."
msgstr ""
#: c-api/structures.rst:145
msgid "Set the object *o* size to *size*."
msgstr ""
#: c-api/structures.rst:121
#: c-api/structures.rst:152
msgid ""
"This is a macro which expands to initialization values for a new :c:type:"
"`PyObject` type. This macro expands to::"
msgstr ""
#: c-api/structures.rst:130
#: c-api/structures.rst:161
msgid ""
"This is a macro which expands to initialization values for a new :c:type:"
"`PyVarObject` type, including the :attr:`ob_size` field. This macro expands "
"to::"
msgstr ""
#: c-api/structures.rst:139
#: c-api/structures.rst:170
msgid "Implementing functions and methods"
msgstr ""
#: c-api/structures.rst:143
#: c-api/structures.rst:174
msgid ""
"Type of the functions used to implement most Python callables in C. "
"Functions of this type take two :c:type:`PyObject*` parameters and return "
@ -142,99 +177,99 @@ msgid ""
"reference."
msgstr ""
#: c-api/structures.rst:150
#: c-api/structures.rst:181
msgid "The function signature is::"
msgstr ""
#: c-api/structures.rst:157
#: c-api/structures.rst:188
msgid ""
"Type of the functions used to implement Python callables in C with "
"signature :const:`METH_VARARGS | METH_KEYWORDS`. The function signature is::"
msgstr ""
#: c-api/structures.rst:168
#: c-api/structures.rst:199
msgid ""
"Type of the functions used to implement Python callables in C with "
"signature :const:`METH_FASTCALL`. The function signature is::"
msgstr ""
#: c-api/structures.rst:178
#: c-api/structures.rst:209
msgid ""
"Type of the functions used to implement Python callables in C with "
"signature :const:`METH_FASTCALL | METH_KEYWORDS`. The function signature is::"
msgstr ""
#: c-api/structures.rst:189
#: c-api/structures.rst:220
msgid ""
"Type of the functions used to implement Python callables in C with "
"signature :const:`METH_METHOD | METH_FASTCALL | METH_KEYWORDS`. The function "
"signature is::"
msgstr ""
#: c-api/structures.rst:204
#: c-api/structures.rst:235
msgid ""
"Structure used to describe a method of an extension type. This structure "
"has four fields:"
msgstr ""
#: c-api/structures.rst:364 c-api/structures.rst:445
#: c-api/structures.rst:397 c-api/structures.rst:493
msgid "Field"
msgstr "Champ"
#: c-api/structures.rst:364 c-api/structures.rst:445
#: c-api/structures.rst:397 c-api/structures.rst:493
msgid "C Type"
msgstr "Type C"
#: c-api/structures.rst:364 c-api/structures.rst:445
#: c-api/structures.rst:397 c-api/structures.rst:493
msgid "Meaning"
msgstr "Signification"
#: c-api/structures.rst:210
#: c-api/structures.rst:241
msgid ":attr:`ml_name`"
msgstr ""
#: c-api/structures.rst:218 c-api/structures.rst:379 c-api/structures.rst:447
#: c-api/structures.rst:455
#: c-api/structures.rst:249 c-api/structures.rst:412 c-api/structures.rst:495
#: c-api/structures.rst:503
msgid "const char \\*"
msgstr ""
#: c-api/structures.rst:210
#: c-api/structures.rst:241
msgid "name of the method"
msgstr ""
#: c-api/structures.rst:212
#: c-api/structures.rst:243
msgid ":attr:`ml_meth`"
msgstr ""
#: c-api/structures.rst:212
#: c-api/structures.rst:243
msgid "PyCFunction"
msgstr "PyCFunction"
#: c-api/structures.rst:212
#: c-api/structures.rst:243
msgid "pointer to the C implementation"
msgstr ""
#: c-api/structures.rst:215
#: c-api/structures.rst:246
msgid ":attr:`ml_flags`"
msgstr ""
#: c-api/structures.rst:368 c-api/structures.rst:391
#: c-api/structures.rst:401 c-api/structures.rst:424
msgid "int"
msgstr "*int*"
#: c-api/structures.rst:215
#: c-api/structures.rst:246
msgid "flag bits indicating how the call should be constructed"
msgstr ""
#: c-api/structures.rst:218
#: c-api/structures.rst:249
msgid ":attr:`ml_doc`"
msgstr ""
#: c-api/structures.rst:379
#: c-api/structures.rst:412
msgid "points to the contents of the docstring"
msgstr ""
#: c-api/structures.rst:222
#: c-api/structures.rst:253
msgid ""
"The :attr:`ml_meth` is a C function pointer. The functions may be of "
"different types, but they always return :c:type:`PyObject*`. If the "
@ -244,18 +279,18 @@ msgid ""
"implementation uses the specific C type of the *self* object."
msgstr ""
#: c-api/structures.rst:229
#: c-api/structures.rst:260
msgid ""
"The :attr:`ml_flags` field is a bitfield which can include the following "
"flags. The individual flags indicate either a calling convention or a "
"binding convention."
msgstr ""
#: c-api/structures.rst:233
#: c-api/structures.rst:264
msgid "There are these calling conventions:"
msgstr ""
#: c-api/structures.rst:237
#: c-api/structures.rst:268
msgid ""
"This is the typical calling convention, where the methods have the type :c:"
"type:`PyCFunction`. The function expects two :c:type:`PyObject*` values. The "
@ -265,7 +300,7 @@ msgid ""
"func:`PyArg_ParseTuple` or :c:func:`PyArg_UnpackTuple`."
msgstr ""
#: c-api/structures.rst:247
#: c-api/structures.rst:278
msgid ""
"Methods with these flags must be of type :c:type:`PyCFunctionWithKeywords`. "
"The function expects three parameters: *self*, *args*, *kwargs* where "
@ -274,7 +309,7 @@ msgid ""
"using :c:func:`PyArg_ParseTupleAndKeywords`."
msgstr ""
#: c-api/structures.rst:256
#: c-api/structures.rst:287
msgid ""
"Fast calling convention supporting only positional arguments. The methods "
"have the type :c:type:`_PyCFunctionFast`. The first parameter is *self*, the "
@ -283,11 +318,11 @@ msgid ""
"the array)."
msgstr ""
#: c-api/structures.rst:279
msgid "This is not part of the :ref:`limited API <stable>`."
#: c-api/structures.rst:297
msgid "``METH_FASTCALL`` is now part of the stable ABI."
msgstr ""
#: c-api/structures.rst:269
#: c-api/structures.rst:302
msgid ""
"Extension of :const:`METH_FASTCALL` supporting also keyword arguments, with "
"methods of type :c:type:`_PyCFunctionFastWithKeywords`. Keyword arguments "
@ -299,21 +334,25 @@ msgid ""
"arguments."
msgstr ""
#: c-api/structures.rst:286
#: c-api/structures.rst:312
msgid "This is not part of the :ref:`limited API <stable>`."
msgstr ""
#: c-api/structures.rst:319
msgid ""
"Extension of :const:`METH_FASTCALL | METH_KEYWORDS` supporting the *defining "
"class*, that is, the class that contains the method in question. The "
"defining class might be a superclass of ``Py_TYPE(self)``."
msgstr ""
#: c-api/structures.rst:290
#: c-api/structures.rst:323
msgid ""
"The method needs to be of type :c:type:`PyCMethod`, the same as for "
"``METH_FASTCALL | METH_KEYWORDS`` with ``defining_class`` argument added "
"after ``self``."
msgstr ""
#: c-api/structures.rst:299
#: c-api/structures.rst:332
msgid ""
"Methods without parameters don't need to check whether arguments are given "
"if they are listed with the :const:`METH_NOARGS` flag. They need to be of "
@ -322,7 +361,7 @@ msgid ""
"the second parameter will be ``NULL``."
msgstr ""
#: c-api/structures.rst:308
#: c-api/structures.rst:341
msgid ""
"Methods with a single object argument can be listed with the :const:`METH_O` "
"flag, instead of invoking :c:func:`PyArg_ParseTuple` with a ``\"O\"`` "
@ -331,7 +370,7 @@ msgid ""
"argument."
msgstr ""
#: c-api/structures.rst:314
#: c-api/structures.rst:347
msgid ""
"These two constants are not used to indicate the calling convention but the "
"binding when use with methods of classes. These may not be used for "
@ -339,27 +378,27 @@ msgid ""
"any given method."
msgstr ""
#: c-api/structures.rst:324
#: c-api/structures.rst:357
msgid ""
"The method will be passed the type object as the first parameter rather than "
"an instance of the type. This is used to create *class methods*, similar to "
"what is created when using the :func:`classmethod` built-in function."
msgstr ""
#: c-api/structures.rst:334
#: c-api/structures.rst:367
msgid ""
"The method will be passed ``NULL`` as the first parameter rather than an "
"instance of the type. This is used to create *static methods*, similar to "
"what is created when using the :func:`staticmethod` built-in function."
msgstr ""
#: c-api/structures.rst:338
#: c-api/structures.rst:371
msgid ""
"One other constant controls whether a method is loaded in place of another "
"definition with the same method name."
msgstr ""
#: c-api/structures.rst:344
#: c-api/structures.rst:377
msgid ""
"The method will be loaded in place of existing definitions. Without "
"*METH_COEXIST*, the default is to skip repeated definitions. Since slot "
@ -372,193 +411,193 @@ msgid ""
"calls."
msgstr ""
#: c-api/structures.rst:356
#: c-api/structures.rst:389
msgid "Accessing attributes of extension types"
msgstr ""
#: c-api/structures.rst:360
#: c-api/structures.rst:393
msgid ""
"Structure which describes an attribute of a type which corresponds to a C "
"struct member. Its fields are:"
msgstr ""
#: c-api/structures.rst:366
#: c-api/structures.rst:399
msgid ":attr:`name`"
msgstr ""
#: c-api/structures.rst:366
#: c-api/structures.rst:399
msgid "name of the member"
msgstr ""
#: c-api/structures.rst:368
#: c-api/structures.rst:401
msgid ":attr:`!type`"
msgstr ""
#: c-api/structures.rst:368
#: c-api/structures.rst:401
msgid "the type of the member in the C struct"
msgstr ""
#: c-api/structures.rst:371
#: c-api/structures.rst:404
msgid ":attr:`offset`"
msgstr ""
#: c-api/structures.rst:407
#: c-api/structures.rst:440
msgid "Py_ssize_t"
msgstr ""
#: c-api/structures.rst:371
#: c-api/structures.rst:404
msgid ""
"the offset in bytes that the member is located on the type's object struct"
msgstr ""
#: c-api/structures.rst:375
#: c-api/structures.rst:408
msgid ":attr:`flags`"
msgstr ""
#: c-api/structures.rst:375
#: c-api/structures.rst:408
msgid "flag bits indicating if the field should be read-only or writable"
msgstr ""
#: c-api/structures.rst:379
#: c-api/structures.rst:412
msgid ":attr:`doc`"
msgstr ""
#: c-api/structures.rst:383
#: c-api/structures.rst:416
msgid ""
":attr:`!type` can be one of many ``T_`` macros corresponding to various C "
"types. When the member is accessed in Python, it will be converted to the "
"equivalent Python type."
msgstr ""
#: c-api/structures.rst:388
#: c-api/structures.rst:421
msgid "Macro name"
msgstr ""
#: c-api/structures.rst:388
#: c-api/structures.rst:421
msgid "C type"
msgstr "Type C"
#: c-api/structures.rst:390
#: c-api/structures.rst:423
msgid "T_SHORT"
msgstr ""
#: c-api/structures.rst:390
#: c-api/structures.rst:423
msgid "short"
msgstr ""
#: c-api/structures.rst:391
#: c-api/structures.rst:424
msgid "T_INT"
msgstr ""
#: c-api/structures.rst:392
#: c-api/structures.rst:425
msgid "T_LONG"
msgstr ""
#: c-api/structures.rst:392
#: c-api/structures.rst:425
msgid "long"
msgstr ""
#: c-api/structures.rst:393
#: c-api/structures.rst:426
msgid "T_FLOAT"
msgstr ""
#: c-api/structures.rst:393
#: c-api/structures.rst:426
msgid "float"
msgstr "*float*"
#: c-api/structures.rst:394
#: c-api/structures.rst:427
msgid "T_DOUBLE"
msgstr ""
#: c-api/structures.rst:394
#: c-api/structures.rst:427
msgid "double"
msgstr "double"
#: c-api/structures.rst:395
#: c-api/structures.rst:428
msgid "T_STRING"
msgstr ""
#: c-api/structures.rst:396
#: c-api/structures.rst:429
msgid "T_OBJECT"
msgstr ""
#: c-api/structures.rst:397
#: c-api/structures.rst:430
msgid "PyObject \\*"
msgstr "PyObject \\*"
#: c-api/structures.rst:397
#: c-api/structures.rst:430
msgid "T_OBJECT_EX"
msgstr ""
#: c-api/structures.rst:398
#: c-api/structures.rst:431
msgid "T_CHAR"
msgstr ""
#: c-api/structures.rst:399 c-api/structures.rst:404
#: c-api/structures.rst:432 c-api/structures.rst:437
msgid "char"
msgstr "char"
#: c-api/structures.rst:399
#: c-api/structures.rst:432
msgid "T_BYTE"
msgstr ""
#: c-api/structures.rst:400
#: c-api/structures.rst:433
msgid "T_UBYTE"
msgstr ""
#: c-api/structures.rst:400
#: c-api/structures.rst:433
msgid "unsigned char"
msgstr "``unsigned char``"
#: c-api/structures.rst:401
#: c-api/structures.rst:434
msgid "T_UINT"
msgstr ""
#: c-api/structures.rst:401
#: c-api/structures.rst:434
msgid "unsigned int"
msgstr "``unsigned int``"
#: c-api/structures.rst:402
#: c-api/structures.rst:435
msgid "T_USHORT"
msgstr ""
#: c-api/structures.rst:402
#: c-api/structures.rst:435
msgid "unsigned short"
msgstr "``unsigned short``"
#: c-api/structures.rst:403
#: c-api/structures.rst:436
msgid "T_ULONG"
msgstr ""
#: c-api/structures.rst:403
#: c-api/structures.rst:436
msgid "unsigned long"
msgstr "``unsigned long``"
#: c-api/structures.rst:404
#: c-api/structures.rst:437
msgid "T_BOOL"
msgstr ""
#: c-api/structures.rst:405
#: c-api/structures.rst:438
msgid "T_LONGLONG"
msgstr ""
#: c-api/structures.rst:405
#: c-api/structures.rst:438
msgid "long long"
msgstr ""
#: c-api/structures.rst:406
#: c-api/structures.rst:439
msgid "T_ULONGLONG"
msgstr ""
#: c-api/structures.rst:406
#: c-api/structures.rst:439
msgid "unsigned long long"
msgstr "``unsigned long long``"
#: c-api/structures.rst:407
#: c-api/structures.rst:440
msgid "T_PYSSIZET"
msgstr ""
#: c-api/structures.rst:410
#: c-api/structures.rst:443
msgid ""
":c:macro:`T_OBJECT` and :c:macro:`T_OBJECT_EX` differ in that :c:macro:"
"`T_OBJECT` returns ``None`` if the member is ``NULL`` and :c:macro:"
@ -568,7 +607,7 @@ msgid ""
"than :c:macro:`T_OBJECT`."
msgstr ""
#: c-api/structures.rst:417
#: c-api/structures.rst:450
msgid ""
":attr:`flags` can be ``0`` for write and read access or :c:macro:`READONLY` "
"for read-only access. Using :c:macro:`T_STRING` for :attr:`type` implies :c:"
@ -577,7 +616,7 @@ msgid ""
"are set to ``NULL``)."
msgstr ""
#: c-api/structures.rst:425
#: c-api/structures.rst:458
msgid ""
"Heap allocated types (created using :c:func:`PyType_FromSpec` or similar), "
"``PyMemberDef`` may contain definitions for the special members "
@ -588,86 +627,99 @@ msgid ""
"``T_PYSSIZET`` and ``READONLY``, for example::"
msgstr ""
#: c-api/structures.rst:441
#: c-api/structures.rst:475
msgid ""
"Get an attribute belonging to the object at address *obj_addr*. The "
"attribute is described by ``PyMemberDef`` *m*. Returns ``NULL`` on error."
msgstr ""
#: c-api/structures.rst:482
msgid ""
"Set an attribute belonging to the object at address *obj_addr* to object "
"*o*. The attribute to set is described by ``PyMemberDef`` *m*. Returns "
"``0`` if successful and a negative value on failure."
msgstr ""
#: c-api/structures.rst:489
msgid ""
"Structure to define property-like access for a type. See also description of "
"the :c:member:`PyTypeObject.tp_getset` slot."
msgstr ""
#: c-api/structures.rst:447
#: c-api/structures.rst:495
msgid "name"
msgstr ""
#: c-api/structures.rst:447
#: c-api/structures.rst:495
msgid "attribute name"
msgstr ""
#: c-api/structures.rst:449
#: c-api/structures.rst:497
msgid "get"
msgstr ""
#: c-api/structures.rst:449
#: c-api/structures.rst:497
msgid "getter"
msgstr ""
#: c-api/structures.rst:449
#: c-api/structures.rst:497
msgid "C Function to get the attribute"
msgstr ""
#: c-api/structures.rst:451
#: c-api/structures.rst:499
msgid "set"
msgstr ""
#: c-api/structures.rst:451
#: c-api/structures.rst:499
msgid "setter"
msgstr ""
#: c-api/structures.rst:451
#: c-api/structures.rst:499
msgid ""
"optional C function to set or delete the attribute, if omitted the attribute "
"is readonly"
msgstr ""
#: c-api/structures.rst:455
#: c-api/structures.rst:503
msgid "doc"
msgstr ""
#: c-api/structures.rst:455
#: c-api/structures.rst:503
msgid "optional docstring"
msgstr ""
#: c-api/structures.rst:457
#: c-api/structures.rst:505
msgid "closure"
msgstr ""
#: c-api/structures.rst:457
#: c-api/structures.rst:505
msgid "void \\*"
msgstr ""
#: c-api/structures.rst:457
#: c-api/structures.rst:505
msgid ""
"optional function pointer, providing additional data for getter and setter"
msgstr ""
#: c-api/structures.rst:462
#: c-api/structures.rst:510
msgid ""
"The ``get`` function takes one :c:type:`PyObject*` parameter (the instance) "
"and a function pointer (the associated ``closure``)::"
msgstr ""
#: c-api/structures.rst:467
#: c-api/structures.rst:515
msgid ""
"It should return a new reference on success or ``NULL`` with a set exception "
"on failure."
msgstr ""
#: c-api/structures.rst:470
#: c-api/structures.rst:518
msgid ""
"``set`` functions take two :c:type:`PyObject*` parameters (the instance and "
"the value to be set) and a function pointer (the associated ``closure``)::"
msgstr ""
#: c-api/structures.rst:475
#: c-api/structures.rst:523
msgid ""
"In case the attribute should be deleted the second parameter is ``NULL``. "
"Should return ``0`` on success or ``-1`` with a set exception on failure."

163
c-api/sys.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-03-19 16:59+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -129,125 +129,118 @@ msgid ""
"`PyOS_sighandler_t` is a typedef alias for :c:type:`void (\\*)(int)`."
msgstr ""
#: c-api/sys.rst:121
#: c-api/sys.rst:122
msgid ""
"Decode a byte string from the locale encoding with the :ref:`surrogateescape "
"error handler <surrogateescape>`: undecodable bytes are decoded as "
"characters in range U+DC80..U+DCFF. If a byte sequence can be decoded as a "
"surrogate character, escape the bytes using the surrogateescape error "
"handler instead of decoding them."
"This function should not be called directly: use the :c:type:`PyConfig` API "
"with the :c:func:`PyConfig_SetBytesString` function which ensures that :ref:"
"`Python is preinitialized <c-preinit>`."
msgstr ""
#: c-api/sys.rst:173
msgid "Encoding, highest priority to lowest priority:"
msgstr ""
#: c-api/sys.rst:175
msgid "``UTF-8`` on macOS, Android, and VxWorks;"
msgstr ""
#: c-api/sys.rst:176
#: c-api/sys.rst:193
msgid ""
"``UTF-8`` on Windows if :c:data:`Py_LegacyWindowsFSEncodingFlag` is zero;"
"This function must not be called before :ref:`Python is preinitialized <c-"
"preinit>` and so that the LC_CTYPE locale is properly configured: see the :c:"
"func:`Py_PreInitialize` function."
msgstr ""
#: c-api/sys.rst:177
msgid "``UTF-8`` if the Python UTF-8 mode is enabled;"
msgstr ""
#: c-api/sys.rst:178
#: c-api/sys.rst:130
msgid ""
"``ASCII`` if the ``LC_CTYPE`` locale is ``\"C\"``, ``nl_langinfo(CODESET)`` "
"returns the ``ASCII`` encoding (or an alias), and :c:func:`mbstowcs` and :c:"
"func:`wcstombs` functions uses the ``ISO-8859-1`` encoding."
"Decode a byte string from the :term:`filesystem encoding and error handler`. "
"If the error handler is :ref:`surrogateescape error handler "
"<surrogateescape>`, undecodable bytes are decoded as characters in range U"
"+DC80..U+DCFF; and if a byte sequence can be decoded as a surrogate "
"character, the bytes are escaped using the surrogateescape error handler "
"instead of decoding them."
msgstr ""
#: c-api/sys.rst:182
msgid "the current locale encoding."
msgstr ""
#: c-api/sys.rst:138
#: c-api/sys.rst:137
msgid ""
"Return a pointer to a newly allocated wide character string, use :c:func:"
"`PyMem_RawFree` to free the memory. If size is not ``NULL``, write the "
"number of wide characters excluding the null character into ``*size``"
msgstr ""
#: c-api/sys.rst:142
#: c-api/sys.rst:141
msgid ""
"Return ``NULL`` on decoding error or memory allocation error. If *size* is "
"not ``NULL``, ``*size`` is set to ``(size_t)-1`` on memory error or set to "
"``(size_t)-2`` on decoding error."
msgstr ""
#: c-api/sys.rst:146
#: c-api/sys.rst:185
msgid ""
"The :term:`filesystem encoding and error handler` are selected by :c:func:"
"`PyConfig_Read`: see :c:member:`~PyConfig.filesystem_encoding` and :c:member:"
"`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`."
msgstr ""
#: c-api/sys.rst:149
msgid ""
"Decoding errors should never happen, unless there is a bug in the C library."
msgstr ""
#: c-api/sys.rst:149
#: c-api/sys.rst:152
msgid ""
"Use the :c:func:`Py_EncodeLocale` function to encode the character string "
"back to a byte string."
msgstr ""
#: c-api/sys.rst:154
#: c-api/sys.rst:157
msgid ""
"The :c:func:`PyUnicode_DecodeFSDefaultAndSize` and :c:func:"
"`PyUnicode_DecodeLocaleAndSize` functions."
msgstr ""
#: c-api/sys.rst:203
msgid "The function now uses the UTF-8 encoding in the UTF-8 mode."
#: c-api/sys.rst:204
msgid ""
"The function now uses the UTF-8 encoding in the :ref:`Python UTF-8 Mode "
"<utf8-mode>`."
msgstr ""
#: c-api/sys.rst:206
#: c-api/sys.rst:208
msgid ""
"The function now uses the UTF-8 encoding on Windows if :c:data:"
"`Py_LegacyWindowsFSEncodingFlag` is zero;"
msgstr ""
#: c-api/sys.rst:169
#: c-api/sys.rst:173
msgid ""
"Encode a wide character string to the locale encoding with the :ref:"
"`surrogateescape error handler <surrogateescape>`: surrogate characters in "
"the range U+DC80..U+DCFF are converted to bytes 0x80..0xFF."
"Encode a wide character string to the :term:`filesystem encoding and error "
"handler`. If the error handler is :ref:`surrogateescape error handler "
"<surrogateescape>`, surrogate characters in the range U+DC80..U+DCFF are "
"converted to bytes 0x80..0xFF."
msgstr ""
#: c-api/sys.rst:184
msgid "The function uses the UTF-8 encoding in the Python UTF-8 mode."
msgstr ""
#: c-api/sys.rst:186
#: c-api/sys.rst:178
msgid ""
"Return a pointer to a newly allocated byte string, use :c:func:`PyMem_Free` "
"to free the memory. Return ``NULL`` on encoding error or memory allocation "
"error"
msgstr ""
#: c-api/sys.rst:190
#: c-api/sys.rst:182
msgid ""
"If error_pos is not ``NULL``, ``*error_pos`` is set to ``(size_t)-1`` on "
"success, or set to the index of the invalid character on encoding error."
msgstr ""
#: c-api/sys.rst:193
#: c-api/sys.rst:189
msgid ""
"Use the :c:func:`Py_DecodeLocale` function to decode the bytes string back "
"to a wide character string."
msgstr ""
#: c-api/sys.rst:198
#: c-api/sys.rst:199
msgid ""
"The :c:func:`PyUnicode_EncodeFSDefault` and :c:func:`PyUnicode_EncodeLocale` "
"functions."
msgstr ""
#: c-api/sys.rst:214
#: c-api/sys.rst:216
msgid "System Functions"
msgstr ""
#: c-api/sys.rst:216
#: c-api/sys.rst:218
msgid ""
"These are utility functions that make functionality from the :mod:`sys` "
"module accessible to C code. They all work with the current interpreter "
@ -255,36 +248,36 @@ msgid ""
"state structure."
msgstr ""
#: c-api/sys.rst:222
#: c-api/sys.rst:224
msgid ""
"Return the object *name* from the :mod:`sys` module or ``NULL`` if it does "
"not exist, without setting an exception."
msgstr ""
#: c-api/sys.rst:227
#: c-api/sys.rst:229
msgid ""
"Set *name* in the :mod:`sys` module to *v* unless *v* is ``NULL``, in which "
"case *name* is deleted from the sys module. Returns ``0`` on success, ``-1`` "
"on error."
msgstr ""
#: c-api/sys.rst:233
#: c-api/sys.rst:235
msgid ""
"Reset :data:`sys.warnoptions` to an empty list. This function may be called "
"prior to :c:func:`Py_Initialize`."
msgstr ""
#: c-api/sys.rst:238
#: c-api/sys.rst:240
msgid ""
"Append *s* to :data:`sys.warnoptions`. This function must be called prior "
"to :c:func:`Py_Initialize` in order to affect the warnings filter list."
msgstr ""
#: c-api/sys.rst:243
#: c-api/sys.rst:245
msgid "Append *unicode* to :data:`sys.warnoptions`."
msgstr ""
#: c-api/sys.rst:245
#: c-api/sys.rst:247
msgid ""
"Note: this function is not currently usable from outside the CPython "
"implementation, as it must be called prior to the implicit import of :mod:"
@ -293,20 +286,20 @@ msgid ""
"Unicode objects."
msgstr ""
#: c-api/sys.rst:253
#: c-api/sys.rst:255
msgid ""
"Set :data:`sys.path` to a list object of paths found in *path* which should "
"be a list of paths separated with the platform's search path delimiter (``:"
"`` on Unix, ``;`` on Windows)."
msgstr ""
#: c-api/sys.rst:259
#: c-api/sys.rst:261
msgid ""
"Write the output string described by *format* to :data:`sys.stdout`. No "
"exceptions are raised, even if truncation occurs (see below)."
msgstr ""
#: c-api/sys.rst:262
#: c-api/sys.rst:264
msgid ""
"*format* should limit the total size of the formatted output string to 1000 "
"bytes or less -- after 1000 bytes, the output string is truncated. In "
@ -317,51 +310,51 @@ msgid ""
"of digits for very large numbers."
msgstr ""
#: c-api/sys.rst:270
#: c-api/sys.rst:272
msgid ""
"If a problem occurs, or :data:`sys.stdout` is unset, the formatted message "
"is written to the real (C level) *stdout*."
msgstr ""
#: c-api/sys.rst:275
#: c-api/sys.rst:277
msgid ""
"As :c:func:`PySys_WriteStdout`, but write to :data:`sys.stderr` or *stderr* "
"instead."
msgstr ""
#: c-api/sys.rst:280
#: c-api/sys.rst:282
msgid ""
"Function similar to PySys_WriteStdout() but format the message using :c:func:"
"`PyUnicode_FromFormatV` and don't truncate the message to an arbitrary "
"length."
msgstr ""
#: c-api/sys.rst:288
#: c-api/sys.rst:290
msgid ""
"As :c:func:`PySys_FormatStdout`, but write to :data:`sys.stderr` or *stderr* "
"instead."
msgstr ""
#: c-api/sys.rst:295
#: c-api/sys.rst:297
msgid ""
"Parse *s* as a set of :option:`-X` options and add them to the current "
"options mapping as returned by :c:func:`PySys_GetXOptions`. This function "
"may be called prior to :c:func:`Py_Initialize`."
msgstr ""
#: c-api/sys.rst:303
#: c-api/sys.rst:305
msgid ""
"Return the current dictionary of :option:`-X` options, similarly to :data:"
"`sys._xoptions`. On error, ``NULL`` is returned and an exception is set."
msgstr ""
#: c-api/sys.rst:312
#: c-api/sys.rst:314
msgid ""
"Raise an auditing event with any active hooks. Return zero for success and "
"non-zero with an exception set on failure."
msgstr ""
#: c-api/sys.rst:315
#: c-api/sys.rst:317
msgid ""
"If any hooks have been added, *format* and other arguments will be used to "
"construct a tuple to pass. Apart from ``N``, the same format characters as "
@ -372,23 +365,23 @@ msgid ""
"leaks.)"
msgstr ""
#: c-api/sys.rst:323
#: c-api/sys.rst:325
msgid ""
"Note that ``#`` format characters should always be treated as "
"``Py_ssize_t``, regardless of whether ``PY_SSIZE_T_CLEAN`` was defined."
msgstr ""
#: c-api/sys.rst:326
#: c-api/sys.rst:328
msgid ":func:`sys.audit` performs the same function from Python code."
msgstr ""
#: c-api/sys.rst:332
#: c-api/sys.rst:334
msgid ""
"Require ``Py_ssize_t`` for ``#`` format characters. Previously, an "
"unavoidable deprecation warning was raised."
msgstr ""
#: c-api/sys.rst:338
#: c-api/sys.rst:340
msgid ""
"Append the callable *hook* to the list of active auditing hooks. Return zero "
"for success and non-zero on failure. If the runtime has been initialized, "
@ -396,14 +389,14 @@ msgid ""
"all interpreters created by the runtime."
msgstr ""
#: c-api/sys.rst:344
#: c-api/sys.rst:346
msgid ""
"The *userData* pointer is passed into the hook function. Since hook "
"functions may be called from different runtimes, this pointer should not "
"refer directly to Python state."
msgstr ""
#: c-api/sys.rst:348
#: c-api/sys.rst:350
msgid ""
"This function is safe to call before :c:func:`Py_Initialize`. When called "
"after runtime initialization, existing audit hooks are notified and may "
@ -411,7 +404,7 @@ msgid ""
"`Exception` (other errors will not be silenced)."
msgstr ""
#: c-api/sys.rst:353
#: c-api/sys.rst:355
msgid ""
"The hook function is of type :c:type:`int (*)(const char *event, PyObject "
"*args, void *userData)`, where *args* is guaranteed to be a :c:type:"
@ -419,14 +412,14 @@ msgid ""
"Python interpreter that raised the event."
msgstr ""
#: c-api/sys.rst:358
#: c-api/sys.rst:360
msgid ""
"See :pep:`578` for a detailed description of auditing. Functions in the "
"runtime and standard library that raise events are listed in the :ref:`audit "
"events table <audit-events>`. Details are in each function's documentation."
msgstr ""
#: c-api/sys.rst:363
#: c-api/sys.rst:365
msgid ""
"Raises an :ref:`auditing event <auditing>` ``sys.addaudithook`` with no "
"arguments."
@ -434,7 +427,7 @@ msgstr ""
"Déclenche un :ref:`événement d'audit <auditing>` ``sys.addaudithook`` sans "
"arguments."
#: c-api/sys.rst:365
#: c-api/sys.rst:367
msgid ""
"If the interpreter is initialized, this function raises a auditing event "
"``sys.addaudithook`` with no arguments. If any existing hooks raise an "
@ -443,11 +436,11 @@ msgid ""
"hook has been added unless they control all existing hooks."
msgstr ""
#: c-api/sys.rst:377
#: c-api/sys.rst:379
msgid "Process Control"
msgstr ""
#: c-api/sys.rst:384
#: c-api/sys.rst:386
msgid ""
"Print a fatal error message and kill the process. No cleanup is performed. "
"This function should only be invoked when a condition is detected that would "
@ -457,29 +450,29 @@ msgid ""
"file:`core` file."
msgstr ""
#: c-api/sys.rst:391
#: c-api/sys.rst:393
msgid ""
"The ``Py_FatalError()`` function is replaced with a macro which logs "
"automatically the name of the current function, unless the "
"``Py_LIMITED_API`` macro is defined."
msgstr ""
#: c-api/sys.rst:395
#: c-api/sys.rst:397
msgid "Log the function name automatically."
msgstr ""
#: c-api/sys.rst:405
#: c-api/sys.rst:407
msgid ""
"Exit the current process. This calls :c:func:`Py_FinalizeEx` and then calls "
"the standard C library function ``exit(status)``. If :c:func:"
"`Py_FinalizeEx` indicates an error, the exit status is set to 120."
msgstr ""
#: c-api/sys.rst:409
#: c-api/sys.rst:411
msgid "Errors from finalization no longer ignored."
msgstr ""
#: c-api/sys.rst:419
#: c-api/sys.rst:421
msgid ""
"Register a cleanup function to be called by :c:func:`Py_FinalizeEx`. The "
"cleanup function will be called with no arguments and should return no "

6
c-api/tuple.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-27 19:26+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -70,8 +70,8 @@ msgstr ""
#: c-api/tuple.rst:59
msgid ""
"Return the object at position *pos* in the tuple pointed to by *p*. If "
"*pos* is out of bounds, return ``NULL`` and set an :exc:`IndexError` "
"exception."
"*pos* is negative or out of bounds, return ``NULL`` and set an :exc:"
"`IndexError` exception."
msgstr ""
#: c-api/tuple.rst:65

118
c-api/type.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-05-29 16:33+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2018-02-15 00:33+0100\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -133,23 +133,25 @@ msgid ""
"See :c:member:`PyType_Slot.slot` for possible values of the *slot* argument."
msgstr ""
#: c-api/type.rst:119
msgid "An exception is raised if *type* is not a heap type."
#: c-api/type.rst:121
msgid ""
":c:func:`PyType_GetSlot` can now accept all types. Previously, it was "
"limited to :ref:`heap types <heap-types>`."
msgstr ""
#: c-api/type.rst:125
#: c-api/type.rst:127
msgid ""
"Return the module object associated with the given type when the type was "
"created using :c:func:`PyType_FromModuleAndSpec`."
msgstr ""
#: c-api/type.rst:146
#: c-api/type.rst:148
msgid ""
"If no module is associated with the given type, sets :py:class:`TypeError` "
"and returns ``NULL``."
msgstr ""
#: c-api/type.rst:131
#: c-api/type.rst:133
msgid ""
"This function is usually used to get the module in which a method is "
"defined. Note that in such a method, ``PyType_GetModule(Py_TYPE(self))`` may "
@ -159,110 +161,112 @@ msgid ""
"defines the method."
msgstr ""
#: c-api/type.rst:142
#: c-api/type.rst:144
msgid ""
"Return the state of the module object associated with the given type. This "
"is a shortcut for calling :c:func:`PyModule_GetState()` on the result of :c:"
"func:`PyType_GetModule`."
msgstr ""
#: c-api/type.rst:149
#: c-api/type.rst:151
msgid ""
"If the *type* has an associated module but its state is ``NULL``, returns "
"``NULL`` without setting an exception."
msgstr ""
#: c-api/type.rst:156
#: c-api/type.rst:158
msgid "Creating Heap-Allocated Types"
msgstr ""
#: c-api/type.rst:158
#: c-api/type.rst:160
msgid ""
"The following functions and structs are used to create :ref:`heap types "
"<heap-types>`."
msgstr ""
#: c-api/type.rst:163
#: c-api/type.rst:165
msgid ""
"Creates and returns a heap type object from the *spec* (:const:"
"Creates and returns a :ref:`heap type <heap-types>` from the *spec* (:const:"
"`Py_TPFLAGS_HEAPTYPE`)."
msgstr ""
#: c-api/type.rst:166
#: c-api/type.rst:168
msgid ""
"If *bases* is a tuple, the created heap type contains all types contained in "
"it as base types."
"The *bases* argument can be used to specify base classes; it can either be "
"only one class or a tuple of classes. If *bases* is ``NULL``, the "
"*Py_tp_bases* slot is used instead. If that also is ``NULL``, the "
"*Py_tp_base* slot is used instead. If that also is ``NULL``, the new type "
"derives from :class:`object`."
msgstr ""
#: c-api/type.rst:169
msgid ""
"If *bases* is ``NULL``, the *Py_tp_bases* slot is used instead. If that also "
"is ``NULL``, the *Py_tp_base* slot is used instead. If that also is "
"``NULL``, the new type derives from :class:`object`."
msgstr ""
#: c-api/type.rst:173
#: c-api/type.rst:174
msgid ""
"The *module* argument can be used to record the module in which the new "
"class is defined. It must be a module object or ``NULL``. If not ``NULL``, "
"the module is associated with the new type and can later be retreived with :"
"the module is associated with the new type and can later be retrieved with :"
"c:func:`PyType_GetModule`. The associated module is not inherited by "
"subclasses; it must be specified for each class individually."
msgstr ""
#: c-api/type.rst:180
#: c-api/type.rst:181
msgid "This function calls :c:func:`PyType_Ready` on the new type."
msgstr ""
#: c-api/type.rst:186
msgid "Equivalent to ``PyType_FromModuleAndSpec(NULL, spec, bases)``."
#: c-api/type.rst:187
msgid ""
"The function now accepts a single class as the *bases* argument and ``NULL`` "
"as the ``tp_doc`` slot."
msgstr ""
#: c-api/type.rst:192
msgid "Equivalent to ``PyType_FromModuleAndSpec(NULL, spec, bases)``."
msgstr ""
#: c-api/type.rst:198
msgid "Equivalent to ``PyType_FromSpecWithBases(spec, NULL)``."
msgstr ""
#: c-api/type.rst:196
#: c-api/type.rst:202
msgid "Structure defining a type's behavior."
msgstr ""
#: c-api/type.rst:200
#: c-api/type.rst:206
msgid "Name of the type, used to set :c:member:`PyTypeObject.tp_name`."
msgstr ""
#: c-api/type.rst:205
#: c-api/type.rst:211
msgid ""
"Size of the instance in bytes, used to set :c:member:`PyTypeObject."
"tp_basicsize` and :c:member:`PyTypeObject.tp_itemsize`."
msgstr ""
#: c-api/type.rst:211
#: c-api/type.rst:217
msgid "Type flags, used to set :c:member:`PyTypeObject.tp_flags`."
msgstr ""
#: c-api/type.rst:213
#: c-api/type.rst:219
msgid ""
"If the ``Py_TPFLAGS_HEAPTYPE`` flag is not set, :c:func:"
"`PyType_FromSpecWithBases` sets it automatically."
msgstr ""
#: c-api/type.rst:218
#: c-api/type.rst:224
msgid ""
"Array of :c:type:`PyType_Slot` structures. Terminated by the special slot "
"value ``{0, NULL}``."
msgstr ""
#: c-api/type.rst:223
#: c-api/type.rst:229
msgid ""
"Structure defining optional functionality of a type, containing a slot ID "
"and a value pointer."
msgstr ""
#: c-api/type.rst:228
#: c-api/type.rst:234
msgid "A slot ID."
msgstr ""
#: c-api/type.rst:230
#: c-api/type.rst:236
msgid ""
"Slot IDs are named like the field names of the structures :c:type:"
"`PyTypeObject`, :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, :c:"
@ -270,97 +274,97 @@ msgid ""
"prefix. For example, use:"
msgstr ""
#: c-api/type.rst:236
#: c-api/type.rst:242
msgid "``Py_tp_dealloc`` to set :c:member:`PyTypeObject.tp_dealloc`"
msgstr ""
#: c-api/type.rst:237
#: c-api/type.rst:243
msgid "``Py_nb_add`` to set :c:member:`PyNumberMethods.nb_add`"
msgstr ""
#: c-api/type.rst:238
#: c-api/type.rst:244
msgid "``Py_sq_length`` to set :c:member:`PySequenceMethods.sq_length`"
msgstr ""
#: c-api/type.rst:240
#: c-api/type.rst:246
msgid ""
"The following fields cannot be set at all using :c:type:`PyType_Spec` and :c:"
"type:`PyType_Slot`:"
msgstr ""
#: c-api/type.rst:243
#: c-api/type.rst:249
msgid ":c:member:`~PyTypeObject.tp_dict`"
msgstr ""
#: c-api/type.rst:244
#: c-api/type.rst:250
msgid ":c:member:`~PyTypeObject.tp_mro`"
msgstr ""
#: c-api/type.rst:245
#: c-api/type.rst:251
msgid ":c:member:`~PyTypeObject.tp_cache`"
msgstr ""
#: c-api/type.rst:246
#: c-api/type.rst:252
msgid ":c:member:`~PyTypeObject.tp_subclasses`"
msgstr ""
#: c-api/type.rst:247
#: c-api/type.rst:253
msgid ":c:member:`~PyTypeObject.tp_weaklist`"
msgstr ""
#: c-api/type.rst:248
#: c-api/type.rst:254
msgid ":c:member:`~PyTypeObject.tp_vectorcall`"
msgstr ""
#: c-api/type.rst:249
#: c-api/type.rst:255
msgid ""
":c:member:`~PyTypeObject.tp_weaklistoffset` (see :ref:`PyMemberDef "
"<pymemberdef-offsets>`)"
msgstr ""
#: c-api/type.rst:251
#: c-api/type.rst:257
msgid ""
":c:member:`~PyTypeObject.tp_dictoffset` (see :ref:`PyMemberDef <pymemberdef-"
"offsets>`)"
msgstr ""
#: c-api/type.rst:253
#: c-api/type.rst:259
msgid ""
":c:member:`~PyTypeObject.tp_vectorcall_offset` (see :ref:`PyMemberDef "
"<pymemberdef-offsets>`)"
msgstr ""
#: c-api/type.rst:256
#: c-api/type.rst:262
msgid ""
"The following fields cannot be set using :c:type:`PyType_Spec` and :c:type:"
"`PyType_Slot` under the limited API:"
msgstr ""
#: c-api/type.rst:259
#: c-api/type.rst:265
msgid ":c:member:`~PyBufferProcs.bf_getbuffer`"
msgstr ""
#: c-api/type.rst:260
#: c-api/type.rst:266
msgid ":c:member:`~PyBufferProcs.bf_releasebuffer`"
msgstr ""
#: c-api/type.rst:262
#: c-api/type.rst:268
msgid ""
"Setting :c:data:`Py_tp_bases` or :c:data:`Py_tp_base` may be problematic on "
"some platforms. To avoid issues, use the *bases* argument of :py:func:"
"`PyType_FromSpecWithBases` instead."
msgstr ""
#: c-api/type.rst:269
#: c-api/type.rst:275
msgid "Slots in :c:type:`PyBufferProcs` in may be set in the unlimited API."
msgstr ""
#: c-api/type.rst:273
#: c-api/type.rst:279
msgid ""
"The desired value of the slot. In most cases, this is a pointer to a "
"function."
msgstr ""
#: c-api/type.rst:276
msgid "May not be ``NULL``."
#: c-api/type.rst:282
msgid "Slots other than ``Py_tp_doc`` may not be ``NULL``."
msgstr ""

55
c-api/typehints.po Normal file
View file

@ -0,0 +1,55 @@
# 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: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: c-api/typehints.rst:6
msgid "Objects for Type Hinting"
msgstr ""
#: c-api/typehints.rst:8
msgid ""
"Various built-in types for type hinting are provided. Currently, two types "
"exist -- :ref:`GenericAlias <types-genericalias>` and :ref:`Union <types-"
"union>`. Only ``GenericAlias`` is exposed to C."
msgstr ""
#: c-api/typehints.rst:14
msgid ""
"Create a :ref:`GenericAlias <types-genericalias>` object. Equivalent to "
"calling the Python class :class:`types.GenericAlias`. The *origin* and "
"*args* arguments set the ``GenericAlias``\\ 's ``__origin__`` and "
"``__args__`` attributes respectively. *origin* should be a :c:type:"
"`PyTypeObject*`, and *args* can be a :c:type:`PyTupleObject*` or any "
"``PyObject*``. If *args* passed is not a tuple, a 1-tuple is automatically "
"constructed and ``__args__`` is set to ``(args,)``. Minimal checking is done "
"for the arguments, so the function will succeed even if *origin* is not a "
"type. The ``GenericAlias``\\ 's ``__parameters__`` attribute is constructed "
"lazily from ``__args__``. On failure, an exception is raised and ``NULL`` "
"is returned."
msgstr ""
#: c-api/typehints.rst:28
msgid "Here's an example of how to make an extension type generic::"
msgstr ""
#: c-api/typehints.rst:38
msgid "The data model method :meth:`__class_getitem__`."
msgstr ""
#: c-api/typehints.rst:44
msgid ""
"The C type of the object returned by :c:func:`Py_GenericAlias`. Equivalent "
"to :class:`types.GenericAlias` in Python."
msgstr ""

1279
c-api/typeobj.po
View file

File diff suppressed because it is too large Load diff

371
c-api/unicode.po
View file

File diff suppressed because it is too large Load diff

126
c-api/veryhigh.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -135,9 +135,9 @@ msgstr ""
msgid ""
"Similar to :c:func:`PyRun_SimpleStringFlags`, but the Python source code is "
"read from *fp* instead of an in-memory string. *filename* should be the name "
"of the file, it is decoded from the filesystem encoding (:func:`sys."
"getfilesystemencoding`). If *closeit* is true, the file is closed before "
"PyRun_SimpleFileExFlags returns."
"of the file, it is decoded from :term:`filesystem encoding and error "
"handler`. If *closeit* is true, the file is closed before "
"``PyRun_SimpleFileExFlags()`` returns."
msgstr ""
#: c-api/veryhigh.rst:120
@ -157,8 +157,8 @@ msgstr ""
msgid ""
"Read and execute a single statement from a file associated with an "
"interactive device according to the *flags* argument. The user will be "
"prompted using ``sys.ps1`` and ``sys.ps2``. *filename* is decoded from the "
"filesystem encoding (:func:`sys.getfilesystemencoding`)."
"prompted using ``sys.ps1`` and ``sys.ps2``. *filename* is decoded from the :"
"term:`filesystem encoding and error handler`."
msgstr ""
#: c-api/veryhigh.rst:137
@ -180,12 +180,11 @@ msgstr ""
msgid ""
"Read and execute statements from a file associated with an interactive "
"device until EOF is reached. The user will be prompted using ``sys.ps1`` "
"and ``sys.ps2``. *filename* is decoded from the filesystem encoding (:func:"
"`sys.getfilesystemencoding`). Returns ``0`` at EOF or a negative number "
"upon failure."
"and ``sys.ps2``. *filename* is decoded from the :term:`filesystem encoding "
"and error handler`. Returns ``0`` at EOF or a negative number upon failure."
msgstr ""
#: c-api/veryhigh.rst:161
#: c-api/veryhigh.rst:160
msgid ""
"Can be set to point to a function with the prototype ``int func(void)``. "
"The function will be called when Python's interpreter prompt is about to "
@ -195,7 +194,7 @@ msgid ""
"the Python source code."
msgstr ""
#: c-api/veryhigh.rst:172
#: c-api/veryhigh.rst:171
msgid ""
"Can be set to point to a function with the prototype ``char *func(FILE "
"*stdin, FILE *stdout, char *prompt)``, overriding the default function used "
@ -206,61 +205,26 @@ msgid ""
"line-editing and tab-completion features."
msgstr ""
#: c-api/veryhigh.rst:181
#: c-api/veryhigh.rst:180
msgid ""
"The result must be a string allocated by :c:func:`PyMem_RawMalloc` or :c:"
"func:`PyMem_RawRealloc`, or ``NULL`` if an error occurred."
msgstr ""
#: c-api/veryhigh.rst:184
#: c-api/veryhigh.rst:183
msgid ""
"The result must be allocated by :c:func:`PyMem_RawMalloc` or :c:func:"
"`PyMem_RawRealloc`, instead of being allocated by :c:func:`PyMem_Malloc` or :"
"c:func:`PyMem_Realloc`."
msgstr ""
#: c-api/veryhigh.rst:192
msgid ""
"This is a simplified interface to :c:func:"
"`PyParser_SimpleParseStringFlagsFilename` below, leaving *filename* set to "
"``NULL`` and *flags* set to ``0``."
msgstr ""
#: c-api/veryhigh.rst:201
msgid ""
"This is a simplified interface to :c:func:"
"`PyParser_SimpleParseStringFlagsFilename` below, leaving *filename* set to "
"``NULL``."
msgstr ""
#: c-api/veryhigh.rst:210
msgid ""
"Parse Python source code from *str* using the start token *start* according "
"to the *flags* argument. The result can be used to create a code object "
"which can be evaluated efficiently. This is useful if a code fragment must "
"be evaluated many times. *filename* is decoded from the filesystem encoding "
"(:func:`sys.getfilesystemencoding`)."
msgstr ""
#: c-api/veryhigh.rst:221
msgid ""
"This is a simplified interface to :c:func:`PyParser_SimpleParseFileFlags` "
"below, leaving *flags* set to ``0``."
msgstr ""
#: c-api/veryhigh.rst:229
msgid ""
"Similar to :c:func:`PyParser_SimpleParseStringFlagsFilename`, but the Python "
"source code is read from *fp* instead of an in-memory string."
msgstr ""
#: c-api/veryhigh.rst:237
#: c-api/veryhigh.rst:190
msgid ""
"This is a simplified interface to :c:func:`PyRun_StringFlags` below, leaving "
"*flags* set to ``NULL``."
msgstr ""
#: c-api/veryhigh.rst:243
#: c-api/veryhigh.rst:196
msgid ""
"Execute Python source code from *str* in the context specified by the "
"objects *globals* and *locals* with the compiler flags specified by "
@ -269,52 +233,52 @@ msgid ""
"token that should be used to parse the source code."
msgstr ""
#: c-api/veryhigh.rst:249
#: c-api/veryhigh.rst:202
msgid ""
"Returns the result of executing the code as a Python object, or ``NULL`` if "
"an exception was raised."
msgstr ""
#: c-api/veryhigh.rst:255
#: c-api/veryhigh.rst:208
msgid ""
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
"*closeit* set to ``0`` and *flags* set to ``NULL``."
msgstr ""
#: c-api/veryhigh.rst:261
#: c-api/veryhigh.rst:214
msgid ""
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
"*flags* set to ``NULL``."
msgstr ""
#: c-api/veryhigh.rst:267
#: c-api/veryhigh.rst:220
msgid ""
"This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving "
"*closeit* set to ``0``."
msgstr ""
#: c-api/veryhigh.rst:273
#: c-api/veryhigh.rst:226
msgid ""
"Similar to :c:func:`PyRun_StringFlags`, but the Python source code is read "
"from *fp* instead of an in-memory string. *filename* should be the name of "
"the file, it is decoded from the filesystem encoding (:func:`sys."
"getfilesystemencoding`). If *closeit* is true, the file is closed before :c:"
"func:`PyRun_FileExFlags` returns."
"the file, it is decoded from the :term:`filesystem encoding and error "
"handler`. If *closeit* is true, the file is closed before :c:func:"
"`PyRun_FileExFlags` returns."
msgstr ""
#: c-api/veryhigh.rst:282
#: c-api/veryhigh.rst:235
msgid ""
"This is a simplified interface to :c:func:`Py_CompileStringFlags` below, "
"leaving *flags* set to ``NULL``."
msgstr ""
#: c-api/veryhigh.rst:288
#: c-api/veryhigh.rst:241
msgid ""
"This is a simplified interface to :c:func:`Py_CompileStringExFlags` below, "
"with *optimize* set to ``-1``."
msgstr ""
#: c-api/veryhigh.rst:294
#: c-api/veryhigh.rst:247
msgid ""
"Parse and compile the Python source code in *str*, returning the resulting "
"code object. The start token is given by *start*; this can be used to "
@ -325,7 +289,7 @@ msgid ""
"returns ``NULL`` if the code cannot be parsed or compiled."
msgstr ""
#: c-api/veryhigh.rst:302
#: c-api/veryhigh.rst:255
msgid ""
"The integer *optimize* specifies the optimization level of the compiler; a "
"value of ``-1`` selects the optimization level of the interpreter as given "
@ -334,20 +298,20 @@ msgid ""
"or ``2`` (docstrings are removed too)."
msgstr ""
#: c-api/veryhigh.rst:313
#: c-api/veryhigh.rst:266
msgid ""
"Like :c:func:`Py_CompileStringObject`, but *filename* is a byte string "
"decoded from the filesystem encoding (:func:`os.fsdecode`)."
"decoded from the :term:`filesystem encoding and error handler`."
msgstr ""
#: c-api/veryhigh.rst:320
#: c-api/veryhigh.rst:273
msgid ""
"This is a simplified interface to :c:func:`PyEval_EvalCodeEx`, with just the "
"code object, and global and local variables. The other arguments are set to "
"``NULL``."
msgstr ""
#: c-api/veryhigh.rst:327
#: c-api/veryhigh.rst:280
msgid ""
"Evaluate a precompiled code object, given a particular environment for its "
"evaluation. This environment consists of a dictionary of global variables, "
@ -356,7 +320,7 @@ msgid ""
"only_parameter>` arguments and a closure tuple of cells."
msgstr ""
#: c-api/veryhigh.rst:336
#: c-api/veryhigh.rst:289
#, fuzzy
msgid ""
"The C structure of the objects used to describe frame objects. The fields of "
@ -365,13 +329,13 @@ msgstr ""
"La structure C utilisée pour décrire les objets *Code*. Les attributs de "
"cette structure sont sujets à changer à tout moment."
#: c-api/veryhigh.rst:342
#: c-api/veryhigh.rst:295
msgid ""
"Evaluate an execution frame. This is a simplified interface to :c:func:"
"`PyEval_EvalFrameEx`, for backward compatibility."
msgstr ""
#: c-api/veryhigh.rst:348
#: c-api/veryhigh.rst:301
msgid ""
"This is the main, unvarnished function of Python interpretation. The code "
"object associated with the execution frame *f* is executed, interpreting "
@ -381,7 +345,7 @@ msgid ""
"of generator objects."
msgstr ""
#: c-api/veryhigh.rst:355
#: c-api/veryhigh.rst:308
msgid ""
"This function now includes a debug assertion to help ensure that it does not "
"silently discard an active exception."
@ -389,33 +353,33 @@ msgstr ""
"Cette fonction inclut maintenant une assertion de débogage afin d'assurer "
"qu'elle ne passe pas sous silence une exception active."
#: c-api/veryhigh.rst:362
#: c-api/veryhigh.rst:315
msgid ""
"This function changes the flags of the current evaluation frame, and returns "
"true on success, false on failure."
msgstr ""
#: c-api/veryhigh.rst:370
#: c-api/veryhigh.rst:323
msgid ""
"The start symbol from the Python grammar for isolated expressions; for use "
"with :c:func:`Py_CompileString`."
msgstr ""
#: c-api/veryhigh.rst:378
#: c-api/veryhigh.rst:331
msgid ""
"The start symbol from the Python grammar for sequences of statements as read "
"from a file or other source; for use with :c:func:`Py_CompileString`. This "
"is the symbol to use when compiling arbitrarily long Python source code."
msgstr ""
#: c-api/veryhigh.rst:387
#: c-api/veryhigh.rst:340
msgid ""
"The start symbol from the Python grammar for a single statement; for use "
"with :c:func:`Py_CompileString`. This is the symbol used for the interactive "
"interpreter loop."
msgstr ""
#: c-api/veryhigh.rst:394
#: c-api/veryhigh.rst:347
msgid ""
"This is the structure used to hold compiler flags. In cases where code is "
"only being compiled, it is passed as ``int flags``, and in cases where code "
@ -423,34 +387,34 @@ msgid ""
"case, ``from __future__ import`` can modify *flags*."
msgstr ""
#: c-api/veryhigh.rst:399
#: c-api/veryhigh.rst:352
msgid ""
"Whenever ``PyCompilerFlags *flags`` is ``NULL``, :attr:`cf_flags` is treated "
"as equal to ``0``, and any modification due to ``from __future__ import`` is "
"discarded."
msgstr ""
#: c-api/veryhigh.rst:405
#: c-api/veryhigh.rst:358
msgid "Compiler flags."
msgstr ""
#: c-api/veryhigh.rst:409
#: c-api/veryhigh.rst:362
msgid ""
"*cf_feature_version* is the minor Python version. It should be initialized "
"to ``PY_MINOR_VERSION``."
msgstr ""
#: c-api/veryhigh.rst:412
#: c-api/veryhigh.rst:365
msgid ""
"The field is ignored by default, it is used if and only if ``PyCF_ONLY_AST`` "
"flag is set in *cf_flags*."
msgstr ""
#: c-api/veryhigh.rst:415
#: c-api/veryhigh.rst:368
msgid "Added *cf_feature_version* field."
msgstr ""
#: c-api/veryhigh.rst:421
#: c-api/veryhigh.rst:374
msgid ""
"This bit can be set in *flags* to cause division operator ``/`` to be "
"interpreted as \"true division\" according to :pep:`238`."

8
c-api/weakref.po
View file

@ -5,7 +5,7 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-27 19:26+0100\n"
"POT-Creation-Date: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2019-03-29 14:17+0100\n"
"Last-Translator: Andy Kwok <andy.kwok.work@gmail.com>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
@ -103,10 +103,12 @@ msgstr ""
"référence n'existe plus, alors l'objet renvoie :const:`Py_None`."
#: c-api/weakref.rst:61
#, fuzzy
msgid ""
"This function returns a **borrowed reference** to the referenced object. "
"This function returns a :term:`borrowed reference` to the referenced object. "
"This means that you should always call :c:func:`Py_INCREF` on the object "
"except if you know that it cannot be destroyed while you are still using it."
"except when it cannot be destroyed before the last usage of the borrowed "
"reference."
msgstr ""
"Cette fonction renvoie une **référence empruntée** à l'objet référencé. Cela "
"signifie que vous devez toujours appeler :c:func:`Py_INCREF` sur l'objet "