diff --git a/c-api/init.po b/c-api/init.po index f3c458fb..9d3b5782 100644 --- a/c-api/init.po +++ b/c-api/init.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-02-08 09:58+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -67,8 +67,8 @@ msgid "" "last call to :c:func:`Py_Initialize`. Ideally, this frees all memory " "allocated by the Python interpreter. This is a no-op when called for a " "second time (without calling :c:func:`Py_Initialize` again first). Normally " -"the return value is 0. If there were errors during finalization (flushing " -"buffered data), -1 is returned." +"the return value is ``0``. If there were errors during finalization " +"(flushing buffered data), ``-1`` is returned." msgstr "" #: ../Doc/c-api/init.rst:70 diff --git a/c-api/long.po b/c-api/long.po index 09b097e6..808c8c6f 100644 --- a/c-api/long.po +++ b/c-api/long.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-02-08 09:58+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -126,12 +126,6 @@ msgid "" "`PyLong_FromString`." msgstr "" -#: ../Doc/c-api/long.rst:107 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using PyLong_FromUnicodeObject()." -msgstr "" - #: ../Doc/c-api/long.rst:107 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -169,7 +163,7 @@ msgstr "" #: ../Doc/c-api/long.rst:169 ../Doc/c-api/long.rst:183 #: ../Doc/c-api/long.rst:200 ../Doc/c-api/long.rst:262 #: ../Doc/c-api/long.rst:274 -msgid "Returns -1 on error. Use :c:func:`PyErr_Occurred` to disambiguate." +msgid "Returns ``-1`` on error. Use :c:func:`PyErr_Occurred` to disambiguate." msgstr "" #: ../Doc/c-api/long.rst:149 @@ -305,7 +299,8 @@ msgid "" msgstr "" #: ../Doc/c-api/long.rst:285 -msgid "Returns -1.0 on error. Use :c:func:`PyErr_Occurred` to disambiguate." +msgid "" +"Returns ``-1.0`` on error. Use :c:func:`PyErr_Occurred` to disambiguate." msgstr "" #: ../Doc/c-api/long.rst:290 @@ -317,5 +312,5 @@ msgid "" msgstr "" #: ../Doc/c-api/long.rst:295 -msgid "Returns NULL on error. Use :c:func:`PyErr_Occurred` to disambiguate." +msgid "Returns *NULL* on error. Use :c:func:`PyErr_Occurred` to disambiguate." msgstr "" diff --git a/c-api/module.po b/c-api/module.po index e89ad7be..2ab3f398 100644 --- a/c-api/module.po +++ b/c-api/module.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-08-01 13:21+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -211,64 +211,70 @@ msgstr "" #: ../Doc/c-api/module.rst:198 msgid "" "A traversal function to call during GC traversal of the module object, or " -"*NULL* if not needed." +"*NULL* if not needed. This function may be called before module state is " +"allocated (:c:func:`PyModule_GetState()` may return `NULL`), and before the :" +"c:member:`Py_mod_exec` function is executed." msgstr "" -#: ../Doc/c-api/module.rst:203 +#: ../Doc/c-api/module.rst:205 msgid "" "A clear function to call during GC clearing of the module object, or *NULL* " -"if not needed." -msgstr "" - -#: ../Doc/c-api/module.rst:208 -msgid "" -"A function to call during deallocation of the module object, or *NULL* if " -"not needed." +"if not needed. This function may be called before module state is allocated " +"(:c:func:`PyModule_GetState()` may return `NULL`), and before the :c:member:" +"`Py_mod_exec` function is executed." msgstr "" #: ../Doc/c-api/module.rst:212 +msgid "" +"A function to call during deallocation of the module object, or *NULL* if " +"not needed. This function may be called before module state is allocated (:c:" +"func:`PyModule_GetState()` may return `NULL`), and before the :c:member:" +"`Py_mod_exec` function is executed." +msgstr "" + +#: ../Doc/c-api/module.rst:218 msgid "Single-phase initialization" msgstr "" -#: ../Doc/c-api/module.rst:214 +#: ../Doc/c-api/module.rst:220 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 "" -#: ../Doc/c-api/module.rst:220 +#: ../Doc/c-api/module.rst:226 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 "" -#: ../Doc/c-api/module.rst:227 +#: ../Doc/c-api/module.rst:233 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 "" -#: ../Doc/c-api/module.rst:233 +#: ../Doc/c-api/module.rst:239 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 "" -#: ../Doc/c-api/module.rst:236 +#: ../Doc/c-api/module.rst:242 msgid "" "Before it is returned from in the initialization function, the resulting " "module object is typically populated using functions like :c:func:" "`PyModule_AddObject`." msgstr "" -#: ../Doc/c-api/module.rst:242 +#: ../Doc/c-api/module.rst:248 msgid "Multi-phase initialization" msgstr "" -#: ../Doc/c-api/module.rst:244 +#: ../Doc/c-api/module.rst:250 msgid "" "An alternate way to specify extensions is to request \"multi-phase " "initialization\". Extension modules created this way behave more like Python " @@ -278,7 +284,7 @@ msgid "" "methods of classes." msgstr "" -#: ../Doc/c-api/module.rst:251 +#: ../Doc/c-api/module.rst:257 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-" @@ -291,14 +297,14 @@ msgid "" "or individual classes created with :c:func:`PyType_FromSpec`)." msgstr "" -#: ../Doc/c-api/module.rst:261 +#: ../Doc/c-api/module.rst:267 msgid "" "All modules created using multi-phase initialization are expected to " "support :ref:`sub-interpreters `. Making sure " "multiple modules are independent is typically enough to achieve this." msgstr "" -#: ../Doc/c-api/module.rst:265 +#: ../Doc/c-api/module.rst:271 msgid "" "To request multi-phase initialization, the initialization function " "(PyInit_modulename) returns a :c:type:`PyModuleDef` instance with non-empty :" @@ -306,65 +312,65 @@ msgid "" "instance must be initialized with the following function:" msgstr "" -#: ../Doc/c-api/module.rst:272 +#: ../Doc/c-api/module.rst:278 msgid "" "Ensures a module definition is a properly initialized Python object that " "correctly reports its type and reference count." msgstr "" -#: ../Doc/c-api/module.rst:275 +#: ../Doc/c-api/module.rst:281 msgid "Returns *def* cast to ``PyObject*``, or *NULL* if an error occurred." msgstr "" -#: ../Doc/c-api/module.rst:279 +#: ../Doc/c-api/module.rst:285 msgid "" "The *m_slots* member of the module definition must point to an array of " "``PyModuleDef_Slot`` structures:" msgstr "" -#: ../Doc/c-api/module.rst:286 +#: ../Doc/c-api/module.rst:292 msgid "A slot ID, chosen from the available values explained below." msgstr "" -#: ../Doc/c-api/module.rst:290 +#: ../Doc/c-api/module.rst:296 msgid "Value of the slot, whose meaning depends on the slot ID." msgstr "" -#: ../Doc/c-api/module.rst:294 +#: ../Doc/c-api/module.rst:300 msgid "The *m_slots* array must be terminated by a slot with id 0." msgstr "" -#: ../Doc/c-api/module.rst:296 +#: ../Doc/c-api/module.rst:302 msgid "The available slot types are:" msgstr "" -#: ../Doc/c-api/module.rst:300 +#: ../Doc/c-api/module.rst:306 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 "" -#: ../Doc/c-api/module.rst:305 +#: ../Doc/c-api/module.rst:311 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 "" -#: ../Doc/c-api/module.rst:310 +#: ../Doc/c-api/module.rst:316 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 "" -#: ../Doc/c-api/module.rst:314 +#: ../Doc/c-api/module.rst:320 msgid "" "Multiple ``Py_mod_create`` slots may not be specified in one module " "definition." msgstr "" -#: ../Doc/c-api/module.rst:317 +#: ../Doc/c-api/module.rst:323 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 " @@ -373,7 +379,7 @@ msgid "" "through symlinks, all while sharing a single module definition." msgstr "" -#: ../Doc/c-api/module.rst:323 +#: ../Doc/c-api/module.rst:329 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 " @@ -383,7 +389,7 @@ msgid "" "``Py_mod_create``." msgstr "" -#: ../Doc/c-api/module.rst:332 +#: ../Doc/c-api/module.rst:338 msgid "" "Specifies a function that is called to *execute* the module. This is " "equivalent to executing the code of a Python module: typically, this " @@ -391,21 +397,21 @@ msgid "" "function is:" msgstr "" -#: ../Doc/c-api/module.rst:339 +#: ../Doc/c-api/module.rst:345 msgid "" "If multiple ``Py_mod_exec`` slots are specified, they are processed in the " "order they appear in the *m_slots* array." msgstr "" -#: ../Doc/c-api/module.rst:342 +#: ../Doc/c-api/module.rst:348 msgid "See :PEP:`489` for more details on multi-phase initialization." msgstr "" -#: ../Doc/c-api/module.rst:345 +#: ../Doc/c-api/module.rst:351 msgid "Low-level module creation functions" msgstr "" -#: ../Doc/c-api/module.rst:347 +#: ../Doc/c-api/module.rst:353 msgid "" "The following functions are called under the hood when using multi-phase " "initialization. They can be used directly, for example when creating module " @@ -413,14 +419,14 @@ msgid "" "``PyModule_ExecDef`` must be called to fully initialize a module." msgstr "" -#: ../Doc/c-api/module.rst:354 +#: ../Doc/c-api/module.rst:360 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 "" -#: ../Doc/c-api/module.rst:362 +#: ../Doc/c-api/module.rst:368 msgid "" "Create a new module object, given the definition in *module* and the " "ModuleSpec *spec*, assuming the API version *module_api_version*. If that " @@ -428,24 +434,24 @@ msgid "" "`RuntimeWarning` is emitted." msgstr "" -#: ../Doc/c-api/module.rst:369 +#: ../Doc/c-api/module.rst:375 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 "" -#: ../Doc/c-api/module.rst:376 +#: ../Doc/c-api/module.rst:382 msgid "Process any execution slots (:c:data:`Py_mod_exec`) given in *def*." msgstr "" -#: ../Doc/c-api/module.rst:382 +#: ../Doc/c-api/module.rst:388 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 "" -#: ../Doc/c-api/module.rst:391 +#: ../Doc/c-api/module.rst:397 msgid "" "Add the functions from the *NULL* terminated *functions* array to *module*. " "Refer to the :c:type:`PyMethodDef` documentation for details on individual " @@ -457,11 +463,11 @@ msgid "" "``PyModule_FromDefAndSpec``." msgstr "" -#: ../Doc/c-api/module.rst:403 +#: ../Doc/c-api/module.rst:409 msgid "Support functions" msgstr "" -#: ../Doc/c-api/module.rst:405 +#: ../Doc/c-api/module.rst:411 msgid "" "The module initialization function (if using single phase initialization) or " "a function called from a module execution slot (if using multi-phase " @@ -469,28 +475,28 @@ msgid "" "module state:" msgstr "" -#: ../Doc/c-api/module.rst:412 +#: ../Doc/c-api/module.rst:418 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*. Return ``-1`` on error, ``0`` on success." msgstr "" -#: ../Doc/c-api/module.rst:418 +#: ../Doc/c-api/module.rst:424 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 "" -#: ../Doc/c-api/module.rst:425 +#: ../Doc/c-api/module.rst:431 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 "" -#: ../Doc/c-api/module.rst:432 +#: ../Doc/c-api/module.rst:438 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 " @@ -498,29 +504,29 @@ msgid "" "error, ``0`` on success." msgstr "" -#: ../Doc/c-api/module.rst:440 +#: ../Doc/c-api/module.rst:446 msgid "Add a string constant to *module*." msgstr "" -#: ../Doc/c-api/module.rst:444 +#: ../Doc/c-api/module.rst:450 msgid "Module lookup" msgstr "" -#: ../Doc/c-api/module.rst:446 +#: ../Doc/c-api/module.rst:452 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 "" -#: ../Doc/c-api/module.rst:450 +#: ../Doc/c-api/module.rst:456 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 "" -#: ../Doc/c-api/module.rst:455 +#: ../Doc/c-api/module.rst:461 msgid "" "Returns the module object that was created from *def* for the current " "interpreter. This method requires that the module object has been attached " @@ -529,18 +535,18 @@ msgid "" "to the interpreter state yet, it returns *NULL*." msgstr "" -#: ../Doc/c-api/module.rst:462 +#: ../Doc/c-api/module.rst:468 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 "" -#: ../Doc/c-api/module.rst:465 +#: ../Doc/c-api/module.rst:471 msgid "Only effective on modules created using single-phase initialization." msgstr "" -#: ../Doc/c-api/module.rst:471 +#: ../Doc/c-api/module.rst:477 msgid "" "Removes the module object created from *def* from the interpreter state." msgstr "" diff --git a/c-api/sequence.po b/c-api/sequence.po index d5667bf1..6c5b5cd3 100644 --- a/c-api/sequence.po +++ b/c-api/sequence.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-04-02 22:11+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -30,49 +30,48 @@ msgstr "" #: ../Doc/c-api/sequence.rst:20 msgid "" "Returns the number of objects in sequence *o* on success, and ``-1`` on " -"failure. For objects that do not provide sequence protocol, this is " -"equivalent to the Python expression ``len(o)``." +"failure. This is equivalent to the Python expression ``len(o)``." msgstr "" -#: ../Doc/c-api/sequence.rst:27 +#: ../Doc/c-api/sequence.rst:26 msgid "" "Return the concatenation of *o1* and *o2* on success, and *NULL* on failure. " "This is the equivalent of the Python expression ``o1 + o2``." msgstr "" -#: ../Doc/c-api/sequence.rst:33 +#: ../Doc/c-api/sequence.rst:32 msgid "" "Return the result of repeating sequence object *o* *count* times, or *NULL* " "on failure. This is the equivalent of the Python expression ``o * count``." msgstr "" -#: ../Doc/c-api/sequence.rst:39 +#: ../Doc/c-api/sequence.rst:38 msgid "" "Return the concatenation of *o1* and *o2* on success, and *NULL* on failure. " "The operation is done *in-place* when *o1* supports it. This is the " "equivalent of the Python expression ``o1 += o2``." msgstr "" -#: ../Doc/c-api/sequence.rst:46 +#: ../Doc/c-api/sequence.rst:45 msgid "" "Return the result of repeating sequence object *o* *count* times, or *NULL* " "on failure. The operation is done *in-place* when *o* supports it. This is " "the equivalent of the Python expression ``o *= count``." msgstr "" -#: ../Doc/c-api/sequence.rst:53 +#: ../Doc/c-api/sequence.rst:52 msgid "" "Return the *i*\\ th element of *o*, or *NULL* on failure. This is the " "equivalent of the Python expression ``o[i]``." msgstr "" -#: ../Doc/c-api/sequence.rst:59 +#: ../Doc/c-api/sequence.rst:58 msgid "" "Return the slice of sequence object *o* between *i1* and *i2*, or *NULL* on " "failure. This is the equivalent of the Python expression ``o[i1:i2]``." msgstr "" -#: ../Doc/c-api/sequence.rst:65 +#: ../Doc/c-api/sequence.rst:64 msgid "" "Assign object *v* to the *i*\\ th element of *o*. Raise an exception and " "return ``-1`` on failure; return ``0`` on success. This is the equivalent " @@ -80,58 +79,58 @@ msgid "" "reference to *v*." msgstr "" -#: ../Doc/c-api/sequence.rst:70 +#: ../Doc/c-api/sequence.rst:69 msgid "" "If *v* is *NULL*, the element is deleted, however this feature is deprecated " "in favour of using :c:func:`PySequence_DelItem`." msgstr "" -#: ../Doc/c-api/sequence.rst:76 +#: ../Doc/c-api/sequence.rst:75 msgid "" "Delete the *i*\\ th element of object *o*. Returns ``-1`` on failure. This " "is the equivalent of the Python statement ``del o[i]``." msgstr "" -#: ../Doc/c-api/sequence.rst:82 +#: ../Doc/c-api/sequence.rst:81 msgid "" "Assign the sequence object *v* to the slice in sequence object *o* from *i1* " "to *i2*. This is the equivalent of the Python statement ``o[i1:i2] = v``." msgstr "" -#: ../Doc/c-api/sequence.rst:88 +#: ../Doc/c-api/sequence.rst:87 msgid "" "Delete the slice in sequence object *o* from *i1* to *i2*. Returns ``-1`` " "on failure. This is the equivalent of the Python statement ``del o[i1:i2]``." msgstr "" -#: ../Doc/c-api/sequence.rst:94 +#: ../Doc/c-api/sequence.rst:93 msgid "" "Return the number of occurrences of *value* in *o*, that is, return the " "number of keys for which ``o[key] == value``. On failure, return ``-1``. " "This is equivalent to the Python expression ``o.count(value)``." msgstr "" -#: ../Doc/c-api/sequence.rst:101 +#: ../Doc/c-api/sequence.rst:100 msgid "" "Determine if *o* contains *value*. If an item in *o* is equal to *value*, " "return ``1``, otherwise return ``0``. On error, return ``-1``. This is " "equivalent to the Python expression ``value in o``." msgstr "" -#: ../Doc/c-api/sequence.rst:108 +#: ../Doc/c-api/sequence.rst:107 msgid "" "Return the first index *i* for which ``o[i] == value``. On error, return " "``-1``. This is equivalent to the Python expression ``o.index(value)``." msgstr "" -#: ../Doc/c-api/sequence.rst:114 +#: ../Doc/c-api/sequence.rst:113 msgid "" "Return a list object with the same contents as the sequence or iterable *o*, " "or *NULL* on failure. The returned list is guaranteed to be new. This is " "equivalent to the Python expression ``list(o)``." msgstr "" -#: ../Doc/c-api/sequence.rst:123 +#: ../Doc/c-api/sequence.rst:122 msgid "" "Return a tuple object with the same contents as the arbitrary sequence *o* " "or *NULL* on failure. If *o* is a tuple, a new reference will be returned, " @@ -139,7 +138,7 @@ msgid "" "is equivalent to the Python expression ``tuple(o)``." msgstr "" -#: ../Doc/c-api/sequence.rst:131 +#: ../Doc/c-api/sequence.rst:130 msgid "" "Return the sequence *o* as a list, unless it is already a tuple or list, in " "which case *o* is returned. Use :c:func:`PySequence_Fast_GET_ITEM` to " @@ -147,26 +146,26 @@ msgid "" "is not a sequence, raises :exc:`TypeError` with *m* as the message text." msgstr "" -#: ../Doc/c-api/sequence.rst:139 +#: ../Doc/c-api/sequence.rst:138 msgid "" "Return the *i*\\ th element of *o*, assuming that *o* was returned by :c:" "func:`PySequence_Fast`, *o* is not *NULL*, and that *i* is within bounds." msgstr "" -#: ../Doc/c-api/sequence.rst:145 +#: ../Doc/c-api/sequence.rst:144 msgid "" "Return the underlying array of PyObject pointers. Assumes that *o* was " "returned by :c:func:`PySequence_Fast` and *o* is not *NULL*." msgstr "" -#: ../Doc/c-api/sequence.rst:148 +#: ../Doc/c-api/sequence.rst:147 msgid "" "Note, if a list gets resized, the reallocation may relocate the items array. " "So, only use the underlying array pointer in contexts where the sequence " "cannot change." msgstr "" -#: ../Doc/c-api/sequence.rst:155 +#: ../Doc/c-api/sequence.rst:154 msgid "" "Return the *i*\\ th element of *o* or *NULL* on failure. Macro form of :c:" "func:`PySequence_GetItem` but without checking that :c:func:" @@ -174,7 +173,7 @@ msgid "" "indices." msgstr "" -#: ../Doc/c-api/sequence.rst:163 +#: ../Doc/c-api/sequence.rst:162 msgid "" "Returns the length of *o*, assuming that *o* was returned by :c:func:" "`PySequence_Fast` and that *o* is not *NULL*. The size can also be gotten " diff --git a/c-api/unicode.po b/c-api/unicode.po index 6845990d..fa04561c 100644 --- a/c-api/unicode.po +++ b/c-api/unicode.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-02-08 09:58+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -210,12 +210,6 @@ msgid "" "Unicode object (not checked)." msgstr "" -#: ../Doc/c-api/unicode.rst:213 ../Doc/c-api/unicode.rst:223 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Unicode API, please migrate to using PyUnicode_GET_LENGTH()." -msgstr "" - #: ../Doc/c-api/unicode.rst:213 ../Doc/c-api/unicode.rst:223 msgid "" "Part of the old-style Unicode API, please migrate to using :c:func:" @@ -247,13 +241,6 @@ msgid "" "`PyUnicode_WRITE` or :c:func:`PyUnicode_READ`." msgstr "" -#: ../Doc/c-api/unicode.rst:245 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Unicode API, please migrate to using the PyUnicode_nBYTE_DATA() " -"family of macros." -msgstr "" - #: ../Doc/c-api/unicode.rst:245 msgid "" "Part of the old-style Unicode API, please migrate to using the :c:func:" @@ -834,10 +821,6 @@ msgstr "" msgid "Deprecated Py_UNICODE APIs" msgstr "" -#: ../Doc/c-api/unicode.rst:661 -msgid "Deprecated since version 3.3, will be removed in version 4.0." -msgstr "" - #: ../Doc/c-api/unicode.rst:662 msgid "" "These API functions are deprecated with the implementation of :pep:`393`. " @@ -1229,13 +1212,6 @@ msgid "" "*NULL* if an exception was raised by the codec." msgstr "" -#: ../Doc/c-api/unicode.rst:1022 ../Doc/c-api/unicode.rst:1273 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using " -"PyUnicode_AsEncodedString()." -msgstr "" - #: ../Doc/c-api/unicode.rst:1022 ../Doc/c-api/unicode.rst:1273 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -1304,13 +1280,6 @@ msgid "" "by the codec." msgstr "" -#: ../Doc/c-api/unicode.rst:1087 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using PyUnicode_AsUTF8String(), " -"PyUnicode_AsUTF8AndSize() or PyUnicode_AsEncodedString()." -msgstr "" - #: ../Doc/c-api/unicode.rst:1087 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -1396,13 +1365,6 @@ msgid "" "single code point." msgstr "" -#: ../Doc/c-api/unicode.rst:1160 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using PyUnicode_AsUTF32String() " -"or PyUnicode_AsEncodedString()." -msgstr "" - #: ../Doc/c-api/unicode.rst:1160 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -1463,13 +1425,6 @@ msgid "" "`Py_UNICODE` values is interpreted as a UCS-2 character." msgstr "" -#: ../Doc/c-api/unicode.rst:1235 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using PyUnicode_AsUTF16String() " -"or PyUnicode_AsEncodedString()." -msgstr "" - #: ../Doc/c-api/unicode.rst:1235 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -1541,13 +1496,6 @@ msgid "" "by the codec." msgstr "" -#: ../Doc/c-api/unicode.rst:1303 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using " -"PyUnicode_AsUnicodeEscapeString()." -msgstr "" - #: ../Doc/c-api/unicode.rst:1303 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -1582,13 +1530,6 @@ msgid "" "by the codec." msgstr "" -#: ../Doc/c-api/unicode.rst:1335 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using " -"PyUnicode_AsRawUnicodeEscapeString() or PyUnicode_AsEncodedString()." -msgstr "" - #: ../Doc/c-api/unicode.rst:1335 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -1626,13 +1567,6 @@ msgid "" "the codec." msgstr "" -#: ../Doc/c-api/unicode.rst:1367 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using PyUnicode_AsLatin1String() " -"or PyUnicode_AsEncodedString()." -msgstr "" - #: ../Doc/c-api/unicode.rst:1367 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -1669,13 +1603,6 @@ msgid "" "the codec." msgstr "" -#: ../Doc/c-api/unicode.rst:1399 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using PyUnicode_AsASCIIString() " -"or PyUnicode_AsEncodedString()." -msgstr "" - #: ../Doc/c-api/unicode.rst:1399 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -1739,13 +1666,6 @@ msgid "" "an exception was raised by the codec." msgstr "" -#: ../Doc/c-api/unicode.rst:1451 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using " -"PyUnicode_AsCharmapString() or PyUnicode_AsEncodedString()." -msgstr "" - #: ../Doc/c-api/unicode.rst:1451 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -1778,13 +1698,6 @@ msgid "" "Return *NULL* when an exception was raised by the codec." msgstr "" -#: ../Doc/c-api/unicode.rst:1479 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using PyUnicode_Translate(). or " -"generic codec based API" -msgstr "" - #: ../Doc/c-api/unicode.rst:1479 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" @@ -1839,13 +1752,6 @@ msgid "" "the codec." msgstr "" -#: ../Doc/c-api/unicode.rst:1530 -msgid "" -"Deprecated since version 3.3, will be removed in version 4.0: Part of the " -"old-style Py_UNICODE API; please migrate to using PyUnicode_AsMBCSString(), " -"PyUnicode_EncodeCodePage() or PyUnicode_AsEncodedString()." -msgstr "" - #: ../Doc/c-api/unicode.rst:1530 msgid "" "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:" diff --git a/extending/newtypes.po b/extending/newtypes.po index 8918bfb0..f2c7ed20 100644 --- a/extending/newtypes.po +++ b/extending/newtypes.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-12-01 07:43+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -390,7 +390,7 @@ msgid "" "The initializer isn't called when unpickling objects and it can be " "overridden. Our initializer accepts arguments to provide initial values for " "our instance. Initializers always accept positional and keyword arguments. " -"Initializers should return either 0 on success or -1 on error." +"Initializers should return either ``0`` on success or ``-1`` on error." msgstr "" #: ../Doc/extending/newtypes.rst:397 diff --git a/faq/extending.po b/faq/extending.po index 20913afd..3c66407d 100644 --- a/faq/extending.po +++ b/faq/extending.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-01-04 15:51+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2018-02-15 00:37+0100\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -93,8 +93,8 @@ msgstr "" msgid "" "The highest-level function to do this is :c:func:`PyRun_SimpleString` which " "takes a single string argument to be executed in the context of the module " -"``__main__`` and returns 0 for success and -1 when an exception occurred " -"(including ``SyntaxError``). If you want more control, use :c:func:" +"``__main__`` and returns ``0`` for success and ``-1`` when an exception " +"occurred (including ``SyntaxError``). If you want more control, use :c:func:" "`PyRun_String`; see the source for :c:func:`PyRun_SimpleString` in ``Python/" "pythonrun.c``." msgstr "" diff --git a/library/abc.po b/library/abc.po index f64f8b85..afeefa8b 100644 --- a/library/abc.po +++ b/library/abc.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-09-12 13:37+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -159,8 +159,9 @@ msgid "" msgstr "" #: ../Doc/library/abc.rst:163 -msgid "The :mod:`abc` module also provides the following decorators:" -msgstr "" +#, fuzzy +msgid "The :mod:`abc` module also provides the following decorator:" +msgstr "Le module fournit les classes suivantes :" #: ../Doc/library/abc.rst:167 msgid "A decorator indicating abstract methods." @@ -210,106 +211,98 @@ msgid "" "inheritance." msgstr "" -#: ../Doc/library/abc.rst:241 -msgid "" -"A subclass of the built-in :func:`classmethod`, indicating an abstract " -"classmethod. Otherwise it is similar to :func:`abstractmethod`." +#: ../Doc/library/abc.rst:239 +msgid "The :mod:`abc` module also supports the following legacy decorators:" msgstr "" #: ../Doc/library/abc.rst:244 msgid "" -"This special case is deprecated, as the :func:`classmethod` decorator is now " -"correctly identified as abstract when applied to an abstract method::" -msgstr "" - -#: ../Doc/library/abc.rst:255 -msgid "" "It is now possible to use :class:`classmethod` with :func:`abstractmethod`, " "making this decorator redundant." msgstr "" -#: ../Doc/library/abc.rst:262 +#: ../Doc/library/abc.rst:248 msgid "" -"A subclass of the built-in :func:`staticmethod`, indicating an abstract " -"staticmethod. Otherwise it is similar to :func:`abstractmethod`." +"A subclass of the built-in :func:`classmethod`, indicating an abstract " +"classmethod. Otherwise it is similar to :func:`abstractmethod`." +msgstr "" + +#: ../Doc/library/abc.rst:251 +msgid "" +"This special case is deprecated, as the :func:`classmethod` decorator is now " +"correctly identified as abstract when applied to an abstract method::" msgstr "" #: ../Doc/library/abc.rst:265 msgid "" -"This special case is deprecated, as the :func:`staticmethod` decorator is " -"now correctly identified as abstract when applied to an abstract method::" -msgstr "" - -#: ../Doc/library/abc.rst:276 -msgid "" "It is now possible to use :class:`staticmethod` with :func:`abstractmethod`, " "making this decorator redundant." msgstr "" -#: ../Doc/library/abc.rst:283 +#: ../Doc/library/abc.rst:269 msgid "" -"A subclass of the built-in :func:`property`, indicating an abstract property." +"A subclass of the built-in :func:`staticmethod`, indicating an abstract " +"staticmethod. Otherwise it is similar to :func:`abstractmethod`." msgstr "" -#: ../Doc/library/abc.rst:286 +#: ../Doc/library/abc.rst:272 msgid "" -"Using this function requires that the class's metaclass is :class:`ABCMeta` " -"or is derived from it. A class that has a metaclass derived from :class:" -"`ABCMeta` cannot be instantiated unless all of its abstract methods and " -"properties are overridden. The abstract properties can be called using any " -"of the normal 'super' call mechanisms." +"This special case is deprecated, as the :func:`staticmethod` decorator is " +"now correctly identified as abstract when applied to an abstract method::" msgstr "" -#: ../Doc/library/abc.rst:292 -msgid "" -"This special case is deprecated, as the :func:`property` decorator is now " -"correctly identified as abstract when applied to an abstract method::" -msgstr "" - -#: ../Doc/library/abc.rst:302 -msgid "" -"The above example defines a read-only property; you can also define a read-" -"write abstract property by appropriately marking one or more of the " -"underlying methods as abstract::" -msgstr "" - -#: ../Doc/library/abc.rst:316 -msgid "" -"If only some components are abstract, only those components need to be " -"updated to create a concrete property in a subclass::" -msgstr "" - -#: ../Doc/library/abc.rst:325 +#: ../Doc/library/abc.rst:285 msgid "" "It is now possible to use :class:`property`, :meth:`property.getter`, :meth:" "`property.setter` and :meth:`property.deleter` with :func:`abstractmethod`, " "making this decorator redundant." msgstr "" -#: ../Doc/library/abc.rst:331 +#: ../Doc/library/abc.rst:290 +msgid "" +"A subclass of the built-in :func:`property`, indicating an abstract property." +msgstr "" + +#: ../Doc/library/abc.rst:293 +msgid "" +"This special case is deprecated, as the :func:`property` decorator is now " +"correctly identified as abstract when applied to an abstract method::" +msgstr "" + +#: ../Doc/library/abc.rst:303 +msgid "" +"The above example defines a read-only property; you can also define a read-" +"write abstract property by appropriately marking one or more of the " +"underlying methods as abstract::" +msgstr "" + +#: ../Doc/library/abc.rst:317 +msgid "" +"If only some components are abstract, only those components need to be " +"updated to create a concrete property in a subclass::" +msgstr "" + +#: ../Doc/library/abc.rst:326 msgid "The :mod:`abc` module also provides the following functions:" msgstr "" -#: ../Doc/library/abc.rst:335 +#: ../Doc/library/abc.rst:330 msgid "Returns the current abstract base class cache token." msgstr "" -#: ../Doc/library/abc.rst:337 +#: ../Doc/library/abc.rst:332 msgid "" "The token is an opaque object (that supports equality testing) identifying " "the current version of the abstract base class cache for virtual subclasses. " "The token changes with every call to :meth:`ABCMeta.register` on any ABC." msgstr "" -#: ../Doc/library/abc.rst:345 +#: ../Doc/library/abc.rst:340 msgid "Footnotes" msgstr "Notes" -#: ../Doc/library/abc.rst:346 +#: ../Doc/library/abc.rst:341 msgid "" "C++ programmers should note that Python's virtual base class concept is not " "the same as C++'s." msgstr "" - -#~ msgid "This module provides the following classes:" -#~ msgstr "Le module fournit les classes suivantes :" diff --git a/library/array.po b/library/array.po index 47861b8e..d3084c55 100644 --- a/library/array.po +++ b/library/array.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-05-27 19:40+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2018-01-21 23:14+0100\n" "Last-Translator: Julien Palard \n" "Language-Team: \n" @@ -219,10 +219,6 @@ msgid "" "API." msgstr "" -#: ../Doc/library/array.rst:59 -msgid "Deprecated since version 3.3, will be removed in version 4.0." -msgstr "" - #: ../Doc/library/array.rst:61 msgid "" "The ``'q'`` and ``'Q'`` type codes are available only if the platform C " diff --git a/library/ast.po b/library/ast.po index 9b8780bc..d30c6853 100644 --- a/library/ast.po +++ b/library/ast.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-04-02 22:11+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2018-02-15 00:41+0100\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -148,7 +148,13 @@ msgid "" "filename, mode, ast.PyCF_ONLY_AST)``." msgstr "" -#: ../Doc/library/ast.rst:119 +#: ../Doc/library/ast.rst:117 ../Doc/library/ast.rst:135 +msgid "" +"It is possible to crash the Python interpreter with a sufficiently large/" +"complex string due to stack depth limitations in Python's AST compiler." +msgstr "" + +#: ../Doc/library/ast.rst:124 msgid "" "Safely evaluate an expression node or a string containing a Python literal " "or container display. The string or node provided may only consist of the " @@ -156,7 +162,7 @@ msgid "" "dicts, sets, booleans, and ``None``." msgstr "" -#: ../Doc/library/ast.rst:124 +#: ../Doc/library/ast.rst:129 msgid "" "This can be used for safely evaluating strings containing Python values from " "untrusted sources without the need to parse the values oneself. It is not " @@ -164,11 +170,11 @@ msgid "" "operators or indexing." msgstr "" -#: ../Doc/library/ast.rst:129 +#: ../Doc/library/ast.rst:139 msgid "Now allows bytes and set literals." msgstr "Accepte maintenant les *bytes* et *sets* écrits littéralement." -#: ../Doc/library/ast.rst:135 +#: ../Doc/library/ast.rst:145 msgid "" "Return the docstring of the given *node* (which must be a :class:" "`FunctionDef`, :class:`ClassDef` or :class:`Module` node), or ``None`` if it " @@ -176,7 +182,7 @@ msgid "" "with :func:`inspect.cleandoc`." msgstr "" -#: ../Doc/library/ast.rst:143 +#: ../Doc/library/ast.rst:153 msgid "" "When you compile a node tree with :func:`compile`, the compiler expects :" "attr:`lineno` and :attr:`col_offset` attributes for every node that supports " @@ -185,81 +191,81 @@ msgid "" "the values of the parent node. It works recursively starting at *node*." msgstr "" -#: ../Doc/library/ast.rst:152 +#: ../Doc/library/ast.rst:162 msgid "" "Increment the line number of each node in the tree starting at *node* by " "*n*. This is useful to \"move code\" to a different location in a file." msgstr "" -#: ../Doc/library/ast.rst:158 +#: ../Doc/library/ast.rst:168 msgid "" "Copy source location (:attr:`lineno` and :attr:`col_offset`) from *old_node* " "to *new_node* if possible, and return *new_node*." msgstr "" -#: ../Doc/library/ast.rst:164 +#: ../Doc/library/ast.rst:174 msgid "" "Yield a tuple of ``(fieldname, value)`` for each field in ``node._fields`` " "that is present on *node*." msgstr "" -#: ../Doc/library/ast.rst:170 +#: ../Doc/library/ast.rst:180 msgid "" "Yield all direct child nodes of *node*, that is, all fields that are nodes " "and all items of fields that are lists of nodes." msgstr "" -#: ../Doc/library/ast.rst:176 +#: ../Doc/library/ast.rst:186 msgid "" "Recursively yield all descendant nodes in the tree starting at *node* " "(including *node* itself), in no specified order. This is useful if you " "only want to modify nodes in place and don't care about the context." msgstr "" -#: ../Doc/library/ast.rst:183 +#: ../Doc/library/ast.rst:193 msgid "" "A node visitor base class that walks the abstract syntax tree and calls a " "visitor function for every node found. This function may return a value " "which is forwarded by the :meth:`visit` method." msgstr "" -#: ../Doc/library/ast.rst:187 +#: ../Doc/library/ast.rst:197 msgid "" "This class is meant to be subclassed, with the subclass adding visitor " "methods." msgstr "" -#: ../Doc/library/ast.rst:192 +#: ../Doc/library/ast.rst:202 msgid "" "Visit a node. The default implementation calls the method called :samp:" "`self.visit_{classname}` where *classname* is the name of the node class, " "or :meth:`generic_visit` if that method doesn't exist." msgstr "" -#: ../Doc/library/ast.rst:198 +#: ../Doc/library/ast.rst:208 msgid "This visitor calls :meth:`visit` on all children of the node." msgstr "" -#: ../Doc/library/ast.rst:200 +#: ../Doc/library/ast.rst:210 msgid "" "Note that child nodes of nodes that have a custom visitor method won't be " "visited unless the visitor calls :meth:`generic_visit` or visits them itself." msgstr "" -#: ../Doc/library/ast.rst:204 +#: ../Doc/library/ast.rst:214 msgid "" "Don't use the :class:`NodeVisitor` if you want to apply changes to nodes " "during traversal. For this a special visitor exists (:class:" "`NodeTransformer`) that allows modifications." msgstr "" -#: ../Doc/library/ast.rst:211 +#: ../Doc/library/ast.rst:221 msgid "" "A :class:`NodeVisitor` subclass that walks the abstract syntax tree and " "allows modification of nodes." msgstr "" -#: ../Doc/library/ast.rst:214 +#: ../Doc/library/ast.rst:224 msgid "" "The :class:`NodeTransformer` will walk the AST and use the return value of " "the visitor methods to replace or remove the old node. If the return value " @@ -268,31 +274,31 @@ msgid "" "may be the original node in which case no replacement takes place." msgstr "" -#: ../Doc/library/ast.rst:220 +#: ../Doc/library/ast.rst:230 msgid "" "Here is an example transformer that rewrites all occurrences of name lookups " "(``foo``) to ``data['foo']``::" msgstr "" -#: ../Doc/library/ast.rst:232 +#: ../Doc/library/ast.rst:242 msgid "" "Keep in mind that if the node you're operating on has child nodes you must " "either transform the child nodes yourself or call the :meth:`generic_visit` " "method for the node first." msgstr "" -#: ../Doc/library/ast.rst:236 +#: ../Doc/library/ast.rst:246 msgid "" "For nodes that were part of a collection of statements (that applies to all " "statement nodes), the visitor may also return a list of nodes rather than " "just a single node." msgstr "" -#: ../Doc/library/ast.rst:240 +#: ../Doc/library/ast.rst:250 msgid "Usually you use the transformer like this::" msgstr "Utilisation typique du *transformer* ::" -#: ../Doc/library/ast.rst:247 +#: ../Doc/library/ast.rst:257 msgid "" "Return a formatted dump of the tree in *node*. This is mainly useful for " "debugging purposes. The returned string will show the names and the values " @@ -302,7 +308,7 @@ msgid "" "*include_attributes* can be set to ``True``." msgstr "" -#: ../Doc/library/ast.rst:256 +#: ../Doc/library/ast.rst:266 msgid "" "`Green Tree Snakes `_, an external " "documentation resource, has good details on working with Python ASTs." diff --git a/library/base64.po b/library/base64.po index 347c7251..c1a1c212 100644 --- a/library/base64.po +++ b/library/base64.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-05-27 19:40+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2017-08-10 00:59+0200\n" "Last-Translator: Julien Palard \n" "Language-Team: \n" @@ -272,20 +272,11 @@ msgid "" "necessary." msgstr "" -#: ../Doc/library/base64.rst:222 -msgid "" -"Both Base85 and Ascii85 have an expansion factor of 5 to 4 (5 Base85 or " -"Ascii85 characters can encode 4 binary bytes), while the better-known Base64 " -"has an expansion factor of 6 to 4. They are therefore more efficient when " -"space expensive. They differ by details such as the character map used for " -"encoding." -msgstr "" - -#: ../Doc/library/base64.rst:229 +#: ../Doc/library/base64.rst:221 msgid "The legacy interface:" msgstr "L'interface historique :" -#: ../Doc/library/base64.rst:233 +#: ../Doc/library/base64.rst:225 msgid "" "Decode the contents of the binary *input* file and write the resulting " "binary data to the *output* file. *input* and *output* must be :term:`file " @@ -293,17 +284,17 @@ msgid "" "returns an empty bytes object." msgstr "" -#: ../Doc/library/base64.rst:241 +#: ../Doc/library/base64.rst:233 msgid "" "Decode the :term:`bytes-like object` *s*, which must contain one or more " "lines of base64 encoded data, and return the decoded :class:`bytes`." msgstr "" -#: ../Doc/library/base64.rst:248 +#: ../Doc/library/base64.rst:240 msgid "Deprecated alias of :func:`decodebytes`." msgstr "" -#: ../Doc/library/base64.rst:255 +#: ../Doc/library/base64.rst:247 msgid "" "Encode the contents of the binary *input* file and write the resulting " "base64 encoded data to the *output* file. *input* and *output* must be :term:" @@ -313,7 +304,7 @@ msgid "" "the output always ends with a newline, as per :rfc:`2045` (MIME)." msgstr "" -#: ../Doc/library/base64.rst:265 +#: ../Doc/library/base64.rst:257 msgid "" "Encode the :term:`bytes-like object` *s*, which can contain arbitrary binary " "data, and return :class:`bytes` containing the base64-encoded data, with " @@ -321,33 +312,33 @@ msgid "" "that there is a trailing newline, as per :rfc:`2045` (MIME)." msgstr "" -#: ../Doc/library/base64.rst:274 +#: ../Doc/library/base64.rst:266 msgid "Deprecated alias of :func:`encodebytes`." msgstr "" -#: ../Doc/library/base64.rst:279 +#: ../Doc/library/base64.rst:271 msgid "An example usage of the module:" msgstr "Un exemple d'utilisation du module :" -#: ../Doc/library/base64.rst:293 +#: ../Doc/library/base64.rst:285 msgid "Module :mod:`binascii`" msgstr "Module :mod:`binascii`" -#: ../Doc/library/base64.rst:293 +#: ../Doc/library/base64.rst:285 msgid "" "Support module containing ASCII-to-binary and binary-to-ASCII conversions." msgstr "" "Module secondaire contenant les conversions ASCII-à-binaire et binaire-à-" "ASCII." -#: ../Doc/library/base64.rst:296 +#: ../Doc/library/base64.rst:288 msgid "" ":rfc:`1521` - MIME (Multipurpose Internet Mail Extensions) Part One: " "Mechanisms for Specifying and Describing the Format of Internet Message " "Bodies" msgstr "" -#: ../Doc/library/base64.rst:296 +#: ../Doc/library/base64.rst:288 msgid "" "Section 5.2, \"Base64 Content-Transfer-Encoding,\" provides the definition " "of the base64 encoding." diff --git a/library/constants.po b/library/constants.po index 922fbd8f..b0c9079e 100644 --- a/library/constants.po +++ b/library/constants.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-09-21 09:15+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2017-09-24 23:11+0200\n" "Last-Translator: \n" "Language-Team: \n" @@ -157,10 +157,17 @@ msgstr "" "quit() or Ctrl-D (i.e. EOF) to exit\", et lorsqu'ils sont appelés, lèvent " "un :exc:`SystemExit` avec le code de retour spécifié." -#: ../Doc/library/constants.rst:92 +#: ../Doc/library/constants.rst:91 msgid "" -"Objects that when printed, print a message like \"Type license() to see the " -"full license text\", and when called, display the corresponding text in a " +"Objects that when printed or called, print the text of copyright or credits, " +"respectively." +msgstr "" + +#: ../Doc/library/constants.rst:96 +#, fuzzy +msgid "" +"Object that when printed, prints the message \"Type license() to see the " +"full license text\", and when called, displays the full license text in a " "pager-like fashion (one screen at a time)." msgstr "" "Objets qui, lorsqu'ils sont représentés, affichent un message comme \"Type " diff --git a/library/dbm.po b/library/dbm.po index 74525372..846740da 100644 --- a/library/dbm.po +++ b/library/dbm.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-08-10 00:49+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -417,12 +417,6 @@ msgid "" "``'n'``." msgstr "" -#: ../Doc/library/dbm.rst:357 -msgid "" -"Deprecated since version 3.6, will be removed in version 3.8: Creating " -"database in 'r' and 'w' modes. Modifying database in 'r' mode." -msgstr "" - #: ../Doc/library/dbm.rst:357 msgid "" "Creating database in ``'r'`` and ``'w'`` modes. Modifying database in " diff --git a/library/fileinput.po b/library/fileinput.po index 1b72efda..f8162523 100644 --- a/library/fileinput.po +++ b/library/fileinput.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-04-02 22:11+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -109,12 +109,6 @@ msgstr "" msgid "Can be used as a context manager." msgstr "" -#: ../Doc/library/fileinput.rst:76 ../Doc/library/fileinput.rst:170 -msgid "" -"Deprecated since version 3.6, will be removed in version 3.8: The bufsize " -"parameter." -msgstr "" - #: ../Doc/library/fileinput.rst:76 ../Doc/library/fileinput.rst:170 msgid "The *bufsize* parameter." msgstr "" diff --git a/library/functions.po b/library/functions.po index 9e78722a..12270ba7 100644 --- a/library/functions.po +++ b/library/functions.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-02-08 09:58+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2018-02-15 00:43+0100\n" "Last-Translator: Julien Palard \n" "Language-Team: \n" @@ -360,8 +360,8 @@ msgstr "" "Que le préfixe \"0b\" soit souhaité ou non, vous pouvez utiliser les moyens " "suivants." -#: ../Doc/library/functions.rst:101 ../Doc/library/functions.rst:672 -#: ../Doc/library/functions.rst:926 +#: ../Doc/library/functions.rst:101 ../Doc/library/functions.rst:678 +#: ../Doc/library/functions.rst:935 msgid "See also :func:`format` for more information." msgstr "Voir aussi :func:`format` pour plus d'information." @@ -687,7 +687,14 @@ msgstr "" "retour à la ligne. Cela permet de faciliter la distinction entre les " "instructions complètes et incomplètes dans le module :mod:`code`." -#: ../Doc/library/functions.rst:263 +#: ../Doc/library/functions.rst:265 +msgid "" +"It is possible to crash the Python interpreter with a sufficiently large/" +"complex string when compiling to an AST object due to stack depth " +"limitations in Python's AST compiler." +msgstr "" + +#: ../Doc/library/functions.rst:269 msgid "" "Allowed use of Windows and Mac newlines. Also input in ``'exec'`` mode does " "not have to end in a newline anymore. Added the *optimize* parameter." @@ -696,7 +703,7 @@ msgstr "" "chaîne donnée à ``'exec'`` n'a plus besoin de terminer par un retour à la " "ligne. Ajout du paramètre *optimize*." -#: ../Doc/library/functions.rst:267 +#: ../Doc/library/functions.rst:273 msgid "" "Previously, :exc:`TypeError` was raised when null bytes were encountered in " "*source*." @@ -704,7 +711,7 @@ msgstr "" "Précédemment, l'exception :exc:`TypeError` était levée quand un caractère " "nul était rencontré dans *source*." -#: ../Doc/library/functions.rst:274 +#: ../Doc/library/functions.rst:280 msgid "" "Return a complex number with the value *real* + *imag*\\*1j or convert a " "string or number to a complex number. If the first parameter is a string, " @@ -724,7 +731,7 @@ msgstr "" "constructeur effectue alors une simple conversion numérique comme le font :" "class:`int` ou :class:`float`. Si aucun argument n'est fourni, donne ``0j``." -#: ../Doc/library/functions.rst:285 +#: ../Doc/library/functions.rst:291 msgid "" "When converting from a string, the string must not contain whitespace around " "the central ``+`` or ``-`` operator. For example, ``complex('1+2j')`` is " @@ -735,18 +742,18 @@ msgstr "" "``complex('1+2j')`` est bon, mais ``complex('1 + 2j')`` lève une :exc:" "`ValueError`." -#: ../Doc/library/functions.rst:290 +#: ../Doc/library/functions.rst:296 msgid "The complex type is described in :ref:`typesnumeric`." msgstr "Le type complexe est décrit dans :ref:`typesnumeric`." -#: ../Doc/library/functions.rst:292 ../Doc/library/functions.rst:555 -#: ../Doc/library/functions.rst:739 +#: ../Doc/library/functions.rst:298 ../Doc/library/functions.rst:561 +#: ../Doc/library/functions.rst:748 msgid "Grouping digits with underscores as in code literals is allowed." msgstr "" "Les chiffres peuvent être groupés avec des tirets bas comme dans les " "expressions littérales." -#: ../Doc/library/functions.rst:298 +#: ../Doc/library/functions.rst:304 msgid "" "This is a relative of :func:`setattr`. The arguments are an object and a " "string. The string must be the name of one of the object's attributes. The " @@ -758,7 +765,7 @@ msgstr "" "fonction supprime l'attribut nommé, si l'objet l'y autorise. Par exemple " "``delattr(x, 'foobar')`` est l'équivalent de ``del x.foobar``." -#: ../Doc/library/functions.rst:310 +#: ../Doc/library/functions.rst:316 msgid "" "Create a new dictionary. The :class:`dict` object is the dictionary class. " "See :class:`dict` and :ref:`typesmapping` for documentation about this class." @@ -767,7 +774,7 @@ msgstr "" "dictionnaire. Voir :class:`dict` et :ref:`typesmapping` pour vous documenter " "sur cette classe." -#: ../Doc/library/functions.rst:313 +#: ../Doc/library/functions.rst:319 msgid "" "For other containers see the built-in :class:`list`, :class:`set`, and :" "class:`tuple` classes, as well as the :mod:`collections` module." @@ -775,7 +782,7 @@ msgstr "" "Pour les autres conteneurs, voir les classes natives :class:`list`, :class:" "`set`, et :class:`typle`. ainsi que le module :mod:`collections`." -#: ../Doc/library/functions.rst:319 +#: ../Doc/library/functions.rst:325 msgid "" "Without arguments, return the list of names in the current local scope. " "With an argument, attempt to return a list of valid attributes for that " @@ -785,7 +792,7 @@ msgstr "" "Avec un argument, elle essaye de donner une liste d'attributs valides pour " "cet objet." -#: ../Doc/library/functions.rst:322 +#: ../Doc/library/functions.rst:328 msgid "" "If the object has a method named :meth:`__dir__`, this method will be called " "and must return the list of attributes. This allows objects that implement a " @@ -797,7 +804,7 @@ msgstr "" "`__getattr__` ou :func:`__getattribute__` de personnaliser ce que donnera :" "func:`dir`." -#: ../Doc/library/functions.rst:327 +#: ../Doc/library/functions.rst:333 msgid "" "If the object does not provide :meth:`__dir__`, the function tries its best " "to gather information from the object's :attr:`~object.__dict__` attribute, " @@ -811,7 +818,7 @@ msgstr "" "n'est pas nécessairement complète, et peut être inadaptée quand l'objet a " "un :func:`__getattr__` personnalisé." -#: ../Doc/library/functions.rst:332 +#: ../Doc/library/functions.rst:338 msgid "" "The default :func:`dir` mechanism behaves differently with different types " "of objects, as it attempts to produce the most relevant, rather than " @@ -821,7 +828,7 @@ msgstr "" "différents types d'objets, car elle préfère donner une information " "pertinente plutôt qu'exhaustive :" -#: ../Doc/library/functions.rst:336 +#: ../Doc/library/functions.rst:342 msgid "" "If the object is a module object, the list contains the names of the " "module's attributes." @@ -829,7 +836,7 @@ msgstr "" "Si l'objet est un module, la liste contiendra les noms des attributs du " "module." -#: ../Doc/library/functions.rst:339 +#: ../Doc/library/functions.rst:345 msgid "" "If the object is a type or class object, the list contains the names of its " "attributes, and recursively of the attributes of its bases." @@ -837,7 +844,7 @@ msgstr "" "Si l'objet est un type ou une classe, la liste contiendra les noms de ses " "attributs, et récursivement, des attributs de ses parents." -#: ../Doc/library/functions.rst:342 +#: ../Doc/library/functions.rst:348 msgid "" "Otherwise, the list contains the object's attributes' names, the names of " "its class's attributes, and recursively of the attributes of its class's " @@ -847,11 +854,11 @@ msgstr "" "attributs de la classe, et récursivement des attributs des parents de la " "classe." -#: ../Doc/library/functions.rst:346 +#: ../Doc/library/functions.rst:352 msgid "The resulting list is sorted alphabetically. For example:" msgstr "La liste donnée est triée par ordre alphabétique, par exemple :" -#: ../Doc/library/functions.rst:365 +#: ../Doc/library/functions.rst:371 msgid "" "Because :func:`dir` is supplied primarily as a convenience for use at an " "interactive prompt, it tries to supply an interesting set of names more than " @@ -865,7 +872,7 @@ msgstr "" "aussi changer d'une version à l'autre. Par exemple, les attributs de méta-" "classes ne sont pas données lorsque l'argument est une classe." -#: ../Doc/library/functions.rst:375 +#: ../Doc/library/functions.rst:381 msgid "" "Take two (non complex) numbers as arguments and return a pair of numbers " "consisting of their quotient and remainder when using integer division. " @@ -885,7 +892,7 @@ msgstr "" "b + a % b`` est très proche de *a*. Si ``a % b`` est différent de zéro, il a " "le même signe que *b*, et ``0 <= abs(a % b) < abs(b)``." -#: ../Doc/library/functions.rst:387 +#: ../Doc/library/functions.rst:393 msgid "" "Return an enumerate object. *iterable* must be a sequence, an :term:" "`iterator`, or some other object which supports iteration. The :meth:" @@ -899,11 +906,11 @@ msgstr "" "tuple contenant un compte (démarrant à *start*, 0 par défaut) et les valeurs " "obtenues de l'itération sur *iterable*." -#: ../Doc/library/functions.rst:399 +#: ../Doc/library/functions.rst:405 msgid "Equivalent to::" msgstr "Équivalent à : ::" -#: ../Doc/library/functions.rst:410 +#: ../Doc/library/functions.rst:416 msgid "" "The arguments are a string and optional globals and locals. If provided, " "*globals* must be a dictionary. If provided, *locals* can be any mapping " @@ -913,7 +920,7 @@ msgstr "" "globales. S'il est fourni, *globals* doit être un dictionnaire. S'il est " "fourni, *locals* peut être n'importe quel objet *mapping*." -#: ../Doc/library/functions.rst:414 +#: ../Doc/library/functions.rst:420 msgid "" "The *expression* argument is parsed and evaluated as a Python expression " "(technically speaking, a condition list) using the *globals* and *locals* " @@ -940,7 +947,7 @@ msgstr "" "donnée par *eval* est le résultat de l'exressipn évaluée. Les erreurs de " "syntaxe sont rapportées via des exceptions. Exemple :" -#: ../Doc/library/functions.rst:429 +#: ../Doc/library/functions.rst:435 msgid "" "This function can also be used to execute arbitrary code objects (such as " "those created by :func:`compile`). In this case pass a code object instead " @@ -952,7 +959,7 @@ msgstr "" "code plutôt qu'une chaîne. Si l'objet code à été compilé avec ``'exec'`` en " "argument pour *mode*, :func:`eval` donnera ``None``." -#: ../Doc/library/functions.rst:434 +#: ../Doc/library/functions.rst:440 msgid "" "Hints: dynamic execution of statements is supported by the :func:`exec` " "function. The :func:`globals` and :func:`locals` functions returns the " @@ -964,7 +971,7 @@ msgstr "" "respectivement les dictionnaires globaux et locaux, qui peuvent être utiles " "lors de l'usage de :func:`eval` et :func:`exec`." -#: ../Doc/library/functions.rst:439 +#: ../Doc/library/functions.rst:445 msgid "" "See :func:`ast.literal_eval` for a function that can safely evaluate strings " "with expressions containing only literals." @@ -973,7 +980,7 @@ msgstr "" "peut évaluer en toute sécurité des chaînes avec des expressions ne contenant " "que des valeurs littérales." -#: ../Doc/library/functions.rst:446 +#: ../Doc/library/functions.rst:452 msgid "" "This function supports dynamic execution of Python code. *object* must be " "either a string or a code object. If it is a string, the string is parsed " @@ -995,7 +1002,7 @@ msgstr "" "`return` et :keyword:`yield` ne peuvent pas être utilisés en dehors d'une " "fonction, même dans du code passé à :func:`exec`. La fonction donne ``None``." -#: ../Doc/library/functions.rst:456 +#: ../Doc/library/functions.rst:462 msgid "" "In all cases, if the optional parts are omitted, the code is executed in the " "current scope. If only *globals* is provided, it must be a dictionary, " @@ -1016,7 +1023,7 @@ msgstr "" "*globals* et *locals*, le code sera exécuté comme s'il était inclus dans une " "définition de classe." -#: ../Doc/library/functions.rst:465 +#: ../Doc/library/functions.rst:471 msgid "" "If the *globals* dictionary does not contain a value for the key " "``__builtins__``, a reference to the dictionary of the built-in module :mod:" @@ -1030,7 +1037,7 @@ msgstr "" "exposées au code exécuté en insérant votre propre dictionnaire " "``__builtins__`` dans *globals* avant de le donner à :func:`exec`." -#: ../Doc/library/functions.rst:473 +#: ../Doc/library/functions.rst:479 msgid "" "The built-in functions :func:`globals` and :func:`locals` return the current " "global and local dictionary, respectively, which may be useful to pass " @@ -1040,7 +1047,7 @@ msgstr "" "respectivement les dictionnaires globaux et locaux, qui peuvent être utiles " "en deuxième et troisième argument de :func:`exec`." -#: ../Doc/library/functions.rst:479 +#: ../Doc/library/functions.rst:485 msgid "" "The default *locals* act as described for function :func:`locals` below: " "modifications to the default *locals* dictionary should not be attempted. " @@ -1053,7 +1060,7 @@ msgstr "" "observer l'effet du code sur les variables locales, après que :func:`exec` " "soit terminée." -#: ../Doc/library/functions.rst:487 +#: ../Doc/library/functions.rst:493 msgid "" "Construct an iterator from those elements of *iterable* for which *function* " "returns true. *iterable* may be either a sequence, a container which " @@ -1067,7 +1074,7 @@ msgstr "" "``None``, la fonction identité est prise, c'est à dire que tous les éléments " "faux d'*iterable* sont supprimés." -#: ../Doc/library/functions.rst:493 +#: ../Doc/library/functions.rst:499 msgid "" "Note that ``filter(function, iterable)`` is equivalent to the generator " "expression ``(item for item in iterable if function(item))`` if function is " @@ -1079,7 +1086,7 @@ msgstr "" "``None`` et de ``(item for item in iterable if item)`` si *function* est " "``None``." -#: ../Doc/library/functions.rst:498 +#: ../Doc/library/functions.rst:504 msgid "" "See :func:`itertools.filterfalse` for the complementary function that " "returns elements of *iterable* for which *function* returns false." @@ -1087,12 +1094,12 @@ msgstr "" "Voir :func:`itertools.filterfalse` pour la fonction complémentaire qui donne " "les éléments d'*iterable* pour lesquels *fonction* donne ``False``." -#: ../Doc/library/functions.rst:508 +#: ../Doc/library/functions.rst:514 msgid "Return a floating point number constructed from a number or string *x*." msgstr "" "Donne un nombre a virgule flottante depuis un nombre ou une chaîne *x*." -#: ../Doc/library/functions.rst:510 +#: ../Doc/library/functions.rst:516 msgid "" "If the argument is a string, it should contain a decimal number, optionally " "preceded by a sign, and optionally embedded in whitespace. The optional " @@ -1110,7 +1117,7 @@ msgstr "" "Plus précisément, l'argument doit se conformer à la grammaire suivante, " "après que les espaces en début et fin de chaîne aient été retirés :" -#: ../Doc/library/functions.rst:525 +#: ../Doc/library/functions.rst:531 msgid "" "Here ``floatnumber`` is the form of a Python floating-point literal, " "described in :ref:`floating`. Case is not significant, so, for example, " @@ -1122,7 +1129,7 @@ msgstr "" "exemple, \"inf\", \" Inf\", \"INFINITY\", et \" iNfiNity\" sont tous des " "orthographes valides pour un infini positif." -#: ../Doc/library/functions.rst:530 +#: ../Doc/library/functions.rst:536 msgid "" "Otherwise, if the argument is an integer or a floating point number, a " "floating point number with the same value (within Python's floating point " @@ -1135,26 +1142,26 @@ msgstr "" "dehors de l'intervalle d'un nombre a virgule flottante pour Python, :exc:" "`OverflowError` est levée." -#: ../Doc/library/functions.rst:535 +#: ../Doc/library/functions.rst:541 msgid "" "For a general Python object ``x``, ``float(x)`` delegates to ``x." "__float__()``." msgstr "" "Pour un objet Python ``x``, ``float(x)`` est délégué à ``x.__float__()``." -#: ../Doc/library/functions.rst:538 +#: ../Doc/library/functions.rst:544 msgid "If no argument is given, ``0.0`` is returned." msgstr "Dans argument, ``0.0`` est donné." -#: ../Doc/library/functions.rst:540 +#: ../Doc/library/functions.rst:546 msgid "Examples::" msgstr "Exemples : ::" -#: ../Doc/library/functions.rst:553 +#: ../Doc/library/functions.rst:559 msgid "The float type is described in :ref:`typesnumeric`." msgstr "Le type *float* est décrit dans :ref:`typesnumeric`." -#: ../Doc/library/functions.rst:565 +#: ../Doc/library/functions.rst:571 msgid "" "Convert a *value* to a \"formatted\" representation, as controlled by " "*format_spec*. The interpretation of *format_spec* will depend on the type " @@ -1166,7 +1173,7 @@ msgstr "" "valeur, cependant il existe une syntaxe standard utilisée par la plupart des " "types natifs : :ref:`formatspec`." -#: ../Doc/library/functions.rst:570 +#: ../Doc/library/functions.rst:576 msgid "" "The default *format_spec* is an empty string which usually gives the same " "effect as calling :func:`str(value) `." @@ -1174,7 +1181,7 @@ msgstr "" "Par défaut, *format_spec* est une chaîne vide qui généralement donne le même " "effet qu'appeler :func:`str(value) `." -#: ../Doc/library/functions.rst:573 +#: ../Doc/library/functions.rst:579 msgid "" "A call to ``format(value, format_spec)`` is translated to ``type(value)." "__format__(value, format_spec)`` which bypasses the instance dictionary when " @@ -1190,7 +1197,7 @@ msgstr "" "mod:`object` et que *format_spec* n'est pas vide, ou si soit *format_spec* " "soit la le résultat ne sont pas des chaînes." -#: ../Doc/library/functions.rst:580 +#: ../Doc/library/functions.rst:586 msgid "" "``object().__format__(format_spec)`` raises :exc:`TypeError` if " "*format_spec* is not an empty string." @@ -1198,7 +1205,7 @@ msgstr "" "``object().__format__(format_spec)`` lève :exc:`TypeError` si *format_spec* " "n'est pas une chaîne vide." -#: ../Doc/library/functions.rst:589 +#: ../Doc/library/functions.rst:595 msgid "" "Return a new :class:`frozenset` object, optionally with elements taken from " "*iterable*. ``frozenset`` is a built-in class. See :class:`frozenset` and :" @@ -1208,7 +1215,7 @@ msgstr "" "tirés d'*iterable*. ``frozenset`` est une classe native. Voir :class:" "`frozenset` et :ref:`types-set` pour leurs documentation." -#: ../Doc/library/functions.rst:593 +#: ../Doc/library/functions.rst:599 msgid "" "For other containers see the built-in :class:`set`, :class:`list`, :class:" "`tuple`, and :class:`dict` classes, as well as the :mod:`collections` module." @@ -1217,7 +1224,7 @@ msgstr "" "`list`, :class:`tuple`, et :class:`dict`, ainsi que le module :mod:" "`collections`." -#: ../Doc/library/functions.rst:600 +#: ../Doc/library/functions.rst:606 msgid "" "Return the value of the named attribute of *object*. *name* must be a " "string. If the string is the name of one of the object's attributes, the " @@ -1233,7 +1240,7 @@ msgstr "" "que *default* est fourni, il est renvoyé, sinon l'exception :exc:" "`AttributeError` est levée." -#: ../Doc/library/functions.rst:609 +#: ../Doc/library/functions.rst:615 msgid "" "Return a dictionary representing the current global symbol table. This is " "always the dictionary of the current module (inside a function or method, " @@ -1245,7 +1252,7 @@ msgstr "" "fonction ou méthode, c'est le module où elle est définie, et non le module " "d'où elle est appelée)." -#: ../Doc/library/functions.rst:616 +#: ../Doc/library/functions.rst:622 msgid "" "The arguments are an object and a string. The result is ``True`` if the " "string is the name of one of the object's attributes, ``False`` if not. " @@ -1257,7 +1264,7 @@ msgstr "" "(L'implémentation appelle ``getattr(object, name)`` et regarde si une " "exception :exc:`AttributeError` à été levée.)" -#: ../Doc/library/functions.rst:624 +#: ../Doc/library/functions.rst:630 msgid "" "Return the hash value of the object (if it has one). Hash values are " "integers. They are used to quickly compare dictionary keys during a " @@ -1270,7 +1277,7 @@ msgstr "" "même *hash* (même si leurs types sont différents, comme pour ``1`` et " "``1.0``)." -#: ../Doc/library/functions.rst:631 +#: ../Doc/library/functions.rst:637 msgid "" "For objects with custom :meth:`__hash__` methods, note that :func:`hash` " "truncates the return value based on the bit width of the host machine. See :" @@ -1280,7 +1287,7 @@ msgstr "" "func:`hash` tronque la valeur donnée en fonction du nombre de bits de la " "machine hôte. Voir :meth:`__hash__` pour plus d'informations." -#: ../Doc/library/functions.rst:637 +#: ../Doc/library/functions.rst:643 msgid "" "Invoke the built-in help system. (This function is intended for interactive " "use.) If no argument is given, the interactive help system starts on the " @@ -1296,14 +1303,14 @@ msgstr "" "ce nom est recherché, et une page d'aide est affichée sur la console. Si " "l'argument est d'un autre type, une page d'aide sur cet objet est générée." -#: ../Doc/library/functions.rst:644 +#: ../Doc/library/functions.rst:650 msgid "" "This function is added to the built-in namespace by the :mod:`site` module." msgstr "" "Cette fonction est ajoutée à l'espace de noms natif par le module :mod:" "`site`." -#: ../Doc/library/functions.rst:646 +#: ../Doc/library/functions.rst:652 msgid "" "Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures " "for callables are now more comprehensive and consistent." @@ -1311,7 +1318,7 @@ msgstr "" "Les changements aux modules :mod:`pydoc` et :mod:`inspect` rendent les " "signatures des appelables plus compréhensible et cohérente." -#: ../Doc/library/functions.rst:653 +#: ../Doc/library/functions.rst:659 msgid "" "Convert an integer number to a lowercase hexadecimal string prefixed with " "\"0x\". If x is not a Python :class:`int` object, it has to define an " @@ -1321,7 +1328,7 @@ msgstr "" "pas un :class:`int`, il doit définir une méthode __index__() qui donne un " "entier. Quelques exemples :" -#: ../Doc/library/functions.rst:662 +#: ../Doc/library/functions.rst:668 msgid "" "If you want to convert an integer number to an uppercase or lower " "hexadecimal string with prefix or not, you can use either of the following " @@ -1330,7 +1337,7 @@ msgstr "" "Si vous voulez convertir un nombre entier en chaîne hexadécimale, en " "majuscule ou non, préfixée ou non, vous pouvez utiliser les moyens suivants :" -#: ../Doc/library/functions.rst:674 +#: ../Doc/library/functions.rst:680 msgid "" "See also :func:`int` for converting a hexadecimal string to an integer using " "a base of 16." @@ -1338,7 +1345,7 @@ msgstr "" "Voir aussi :func:`int` pour convertir une chaîne hexadécimale en un entier " "en lui spécifiant 16 comme base." -#: ../Doc/library/functions.rst:679 +#: ../Doc/library/functions.rst:685 msgid "" "To obtain a hexadecimal string representation for a float, use the :meth:" "`float.hex` method." @@ -1346,7 +1353,7 @@ msgstr "" "Pour obtenir une représentation hexadécimale sous forme de chaîne d'un " "nombre à virgule flottante, utilisez la méthode :meth:`float.hex`." -#: ../Doc/library/functions.rst:685 +#: ../Doc/library/functions.rst:691 msgid "" "Return the \"identity\" of an object. This is an integer which is " "guaranteed to be unique and constant for this object during its lifetime. " @@ -1357,7 +1364,7 @@ msgstr "" "constant pour cet objet durant sa durée de vie. Deux objets sont les durées " "de vie ne se chevauchent pas peuvent partager le même :func:`id`." -#: ../Doc/library/functions.rst:695 +#: ../Doc/library/functions.rst:701 msgid "" "If the *prompt* argument is present, it is written to standard output " "without a trailing newline. The function then reads a line from input, " @@ -1369,7 +1376,7 @@ msgstr "" "standard et la convertit en chaîne (supprimant le retour à la ligne final) " "quelle donne. Lorsque EOF est lu, :exc:`EOFError` est levée. Exemple : ::" -#: ../Doc/library/functions.rst:705 +#: ../Doc/library/functions.rst:711 msgid "" "If the :mod:`readline` module was loaded, then :func:`input` will use it to " "provide elaborate line editing and history features." @@ -1377,19 +1384,22 @@ msgstr "" "Si le module :mod:`readline` est chargé, :func:`input` l'utilisera pour " "fournir des fonctionnalités d'édition et d'historique élaborées." -#: ../Doc/library/functions.rst:712 +#: ../Doc/library/functions.rst:718 +#, fuzzy msgid "" "Return an integer object constructed from a number or string *x*, or return " "``0`` if no arguments are given. If *x* is a number, return :meth:`x." -"__int__() `. For floating point numbers, this truncates " -"towards zero." +"__int__() `. If *x* defines :meth:`x.__trunc__() ` but not :meth:`x.__int__() `, then return if :" +"meth:`x.__trunc__() `. For floating point numbers, this " +"truncates towards zero." msgstr "" "Donne un entier construit depuis un nombre ou une chaîne *x*, ou ``0`` si " "aucun argument n'est fourni. Si *x* est un nombre, :meth:`__int__() ` est donné. Les nombres à virgule flottante sont tronquées vers " "zéro." -#: ../Doc/library/functions.rst:717 +#: ../Doc/library/functions.rst:726 msgid "" "If *x* is not a number or if *base* is given, then *x* must be a string, :" "class:`bytes`, or :class:`bytearray` instance representing an :ref:`integer " @@ -1418,11 +1428,11 @@ msgstr "" "0)`` n'est pas légal, alors que ``int('010')`` l'est tout comme ``int('010', " "8)``." -#: ../Doc/library/functions.rst:730 +#: ../Doc/library/functions.rst:739 msgid "The integer type is described in :ref:`typesnumeric`." msgstr "Le type des entiers est décrit dans :ref:`typesnumeric`." -#: ../Doc/library/functions.rst:732 +#: ../Doc/library/functions.rst:741 msgid "" "If *base* is not an instance of :class:`int` and the *base* object has a :" "meth:`base.__index__ ` method, that method is called to " @@ -1435,7 +1445,7 @@ msgstr "" "meth:`base.__int__ ` au lieu de :meth:`base.__index__ " "`." -#: ../Doc/library/functions.rst:745 +#: ../Doc/library/functions.rst:754 msgid "" "Return true if the *object* argument is an instance of the *classinfo* " "argument, or of a (direct, indirect or :term:`virtual `) of *classinfo*. A class is considered a subclass of " @@ -1468,7 +1478,7 @@ msgstr "" "cas la vérification sera faite pour chaque classe de *classinfo*. Dans tous " "les autres cas, :exc:`TypeError` est levée." -#: ../Doc/library/functions.rst:766 +#: ../Doc/library/functions.rst:775 msgid "" "Return an :term:`iterator` object. The first argument is interpreted very " "differently depending on the presence of the second argument. Without a " @@ -1494,11 +1504,11 @@ msgstr "" "est égale à *sentinel* :exc:`StopIteration` est levée, autrement la valeur " "est donnée." -#: ../Doc/library/functions.rst:779 +#: ../Doc/library/functions.rst:788 msgid "See also :ref:`typeiter`." msgstr "Voir aussi :ref:`typeiter`." -#: ../Doc/library/functions.rst:781 +#: ../Doc/library/functions.rst:790 msgid "" "One useful application of the second form of :func:`iter` is to read lines " "of a file until a certain line is reached. The following example reads a " @@ -1510,7 +1520,7 @@ msgstr "" "L'exemple suivant lis un fichier jusqu'à ce que :meth:`~io.TextIOBase." "readline` donne une ligne vide : ::" -#: ../Doc/library/functions.rst:792 +#: ../Doc/library/functions.rst:801 msgid "" "Return the length (the number of items) of an object. The argument may be a " "sequence (such as a string, bytes, tuple, list, or range) or a collection " @@ -1520,7 +1530,7 @@ msgstr "" "séquence (tel qu'une chaîne, un objet ``bytes``, ``tuple``, ``list`` ou " "``range``) ou une collection (tel qu'un ``dict``, ``set`` ou ``frozenset``)." -#: ../Doc/library/functions.rst:801 +#: ../Doc/library/functions.rst:810 msgid "" "Rather than being a function, :class:`list` is actually a mutable sequence " "type, as documented in :ref:`typesseq-list` and :ref:`typesseq`." @@ -1528,7 +1538,7 @@ msgstr "" "Plutôt qu'être une fonction, :class:`list` est en fait un type de séquence " "variable, tel que documenté dans :ref:`typesseq-list` et :ref:`typesseq`." -#: ../Doc/library/functions.rst:807 +#: ../Doc/library/functions.rst:816 msgid "" "Update and return a dictionary representing the current local symbol table. " "Free variables are returned by :func:`locals` when it is called in function " @@ -1538,7 +1548,7 @@ msgstr "" "locaux. Les variables libres sont données par :func:`locals` lorsqu'elle est " "appelée dans le corps d'une fonction, mais pas dans le corps d'une classe." -#: ../Doc/library/functions.rst:812 +#: ../Doc/library/functions.rst:821 msgid "" "The contents of this dictionary should not be modified; changes may not " "affect the values of local and free variables used by the interpreter." @@ -1547,7 +1557,7 @@ msgstr "" "peuvent ne pas affecter les valeurs des variables locales ou libres " "utilisées par l'interpréteur." -#: ../Doc/library/functions.rst:817 +#: ../Doc/library/functions.rst:826 msgid "" "Return an iterator that applies *function* to every item of *iterable*, " "yielding the results. If additional *iterable* arguments are passed, " @@ -1564,7 +1574,7 @@ msgstr "" "où les arguments seraient déjà rangés sous forme de tuples, voir :func:" "`itertools.starmap`." -#: ../Doc/library/functions.rst:828 +#: ../Doc/library/functions.rst:837 msgid "" "Return the largest item in an iterable or the largest of two or more " "arguments." @@ -1572,7 +1582,7 @@ msgstr "" "Donne l'élément le plus grand dans un iterable, ou l'argument le plus grand " "parmi au moins deux arguments." -#: ../Doc/library/functions.rst:831 +#: ../Doc/library/functions.rst:840 msgid "" "If one positional argument is provided, it should be an :term:`iterable`. " "The largest item in the iterable is returned. If two or more positional " @@ -1582,7 +1592,7 @@ msgstr "" "Le plus grand élément de l'itérable est donné. Si au moins deux arguments " "positionnels sont fournis, l'argument le plus grand sera donné." -#: ../Doc/library/functions.rst:836 ../Doc/library/functions.rst:870 +#: ../Doc/library/functions.rst:845 ../Doc/library/functions.rst:879 msgid "" "There are two optional keyword-only arguments. The *key* argument specifies " "a one-argument ordering function like that used for :meth:`list.sort`. The " @@ -1596,7 +1606,7 @@ msgstr "" "l'itérable fourni est vide. Si l'itérable est vide et que *default* n'est " "pas fourni, :exc:`ValueError` est levée." -#: ../Doc/library/functions.rst:842 +#: ../Doc/library/functions.rst:851 msgid "" "If multiple items are maximal, the function returns the first one " "encountered. This is consistent with other sort-stability preserving tools " @@ -1608,11 +1618,11 @@ msgstr "" "stabilité lors du tri, tel que ``sorted(iterable, key=keyfunc, reverse=True)" "[0]`` et ``heapq.nlargest(1, iterable, key=keyfunc)``." -#: ../Doc/library/functions.rst:847 ../Doc/library/functions.rst:881 +#: ../Doc/library/functions.rst:856 ../Doc/library/functions.rst:890 msgid "The *default* keyword-only argument." msgstr "L'argument exclusivement par mot clef *default*." -#: ../Doc/library/functions.rst:855 +#: ../Doc/library/functions.rst:864 msgid "" "Return a \"memory view\" object created from the given argument. See :ref:" "`typememoryview` for more information." @@ -1620,7 +1630,7 @@ msgstr "" "Donne une \"vue mémoire\" (*memory view*) créée depuis l'argument. Voir :ref:" "`typememoryview` pour plus d'informations." -#: ../Doc/library/functions.rst:862 +#: ../Doc/library/functions.rst:871 msgid "" "Return the smallest item in an iterable or the smallest of two or more " "arguments." @@ -1628,7 +1638,7 @@ msgstr "" "Donne le plus petit élément d'un itérable ou le plus petit d'au moins deux " "arguments." -#: ../Doc/library/functions.rst:865 +#: ../Doc/library/functions.rst:874 msgid "" "If one positional argument is provided, it should be an :term:`iterable`. " "The smallest item in the iterable is returned. If two or more positional " @@ -1638,7 +1648,7 @@ msgstr "" "élément de l'itérable est donné. Si au moins deux arguments positionnels " "sont fournis le plus petit argument positionnel est donné." -#: ../Doc/library/functions.rst:876 +#: ../Doc/library/functions.rst:885 msgid "" "If multiple items are minimal, the function returns the first one " "encountered. This is consistent with other sort-stability preserving tools " @@ -1650,7 +1660,7 @@ msgstr "" "``sorted(iterable, key=keyfunc)[0]`` et ``heapq.nsmallest(1, iterable, " "key=keyfunc)``." -#: ../Doc/library/functions.rst:887 +#: ../Doc/library/functions.rst:896 msgid "" "Retrieve the next item from the *iterator* by calling its :meth:`~iterator." "__next__` method. If *default* is given, it is returned if the iterator is " @@ -1660,7 +1670,7 @@ msgstr "" "__next__`. Si *default* est fourni, il sera donné si l'itérateur est épousé, " "sinon :exc:`StopIteration` est levée." -#: ../Doc/library/functions.rst:894 +#: ../Doc/library/functions.rst:903 msgid "" "Return a new featureless object. :class:`object` is a base for all classes. " "It has the methods that are common to all instances of Python classes. This " @@ -1670,7 +1680,7 @@ msgstr "" "classes. C'est elle qui porte les méthodes communes à toutes les instances " "de classes en Python. Cette fonction n'accepte aucun argument." -#: ../Doc/library/functions.rst:900 +#: ../Doc/library/functions.rst:909 msgid "" ":class:`object` does *not* have a :attr:`~object.__dict__`, so you can't " "assign arbitrary attributes to an instance of the :class:`object` class." @@ -1679,7 +1689,7 @@ msgstr "" "pouvez donc pas assigner d'attributs arbitraire à une instance d':class:" "`object`." -#: ../Doc/library/functions.rst:906 +#: ../Doc/library/functions.rst:915 msgid "" "Convert an integer number to an octal string prefixed with \"0o\". The " "result is a valid Python expression. If *x* is not a Python :class:`int` " @@ -1691,7 +1701,7 @@ msgstr "" "objet :class:`int`, il doit définir une méthode :meth:`__index__` qui donne " "un entier, par exemple :" -#: ../Doc/library/functions.rst:916 +#: ../Doc/library/functions.rst:925 msgid "" "If you want to convert an integer number to octal string either with prefix " "\"0o\" or not, you can use either of the following ways." @@ -1699,7 +1709,7 @@ msgstr "" "Si vous voulez convertir un nombre entier en chaîne octale, avec ou sans le " "préfixe \"0o\", vous pouvez utiliser les moyens suivants." -#: ../Doc/library/functions.rst:933 +#: ../Doc/library/functions.rst:942 msgid "" "Open *file* and return a corresponding :term:`file object`. If the file " "cannot be opened, an :exc:`OSError` is raised." @@ -1707,7 +1717,7 @@ msgstr "" "Ouvre *file* et donne un :term:`file object` correspondant. Si le fichier ne " "peut pas être ouvert, une :exc:`OSError` est levée." -#: ../Doc/library/functions.rst:936 +#: ../Doc/library/functions.rst:945 msgid "" "*file* is a :term:`path-like object` giving the pathname (absolute or " "relative to the current working directory) of the file to be opened or an " @@ -1721,7 +1731,7 @@ msgstr "" "donné, il sera fermé en même temps que l'objet *I/O* renvoyé, sauf si " "*closefd* est mis à ``False``.)" -#: ../Doc/library/functions.rst:942 +#: ../Doc/library/functions.rst:951 msgid "" "*mode* is an optional string that specifies the mode in which the file is " "opened. It defaults to ``'r'`` which means open for reading in text mode. " @@ -1747,79 +1757,79 @@ msgstr "" "utilisez le mode binaire en laissant *encoding* non spécifié.) Les modes " "disponibles sont :" -#: ../Doc/library/functions.rst:954 +#: ../Doc/library/functions.rst:963 msgid "Character" msgstr "Caractère" -#: ../Doc/library/functions.rst:954 +#: ../Doc/library/functions.rst:963 msgid "Meaning" msgstr "Signification" -#: ../Doc/library/functions.rst:956 +#: ../Doc/library/functions.rst:965 msgid "``'r'``" msgstr "``'r'``" -#: ../Doc/library/functions.rst:956 +#: ../Doc/library/functions.rst:965 msgid "open for reading (default)" msgstr "ouvre en lecture (par défaut)" -#: ../Doc/library/functions.rst:957 +#: ../Doc/library/functions.rst:966 msgid "``'w'``" msgstr "``'w'``" -#: ../Doc/library/functions.rst:957 +#: ../Doc/library/functions.rst:966 msgid "open for writing, truncating the file first" msgstr "ouvre en écriture, tronquant le fichier" -#: ../Doc/library/functions.rst:958 +#: ../Doc/library/functions.rst:967 msgid "``'x'``" msgstr "``'x'``" -#: ../Doc/library/functions.rst:958 +#: ../Doc/library/functions.rst:967 msgid "open for exclusive creation, failing if the file already exists" msgstr "ouvre pour une création exclusive, échouant si le fichier existe déjà" -#: ../Doc/library/functions.rst:959 +#: ../Doc/library/functions.rst:968 msgid "``'a'``" msgstr "``'a'``" -#: ../Doc/library/functions.rst:959 +#: ../Doc/library/functions.rst:968 msgid "open for writing, appending to the end of the file if it exists" msgstr "ouvre en écriture, ajoutant à la fin du fichier s'il existe" -#: ../Doc/library/functions.rst:960 +#: ../Doc/library/functions.rst:969 msgid "``'b'``" msgstr "``'b'``" -#: ../Doc/library/functions.rst:960 +#: ../Doc/library/functions.rst:969 msgid "binary mode" msgstr "mode binaire" -#: ../Doc/library/functions.rst:961 +#: ../Doc/library/functions.rst:970 msgid "``'t'``" msgstr "``'t'``" -#: ../Doc/library/functions.rst:961 +#: ../Doc/library/functions.rst:970 msgid "text mode (default)" msgstr "mode texte (par défaut)" -#: ../Doc/library/functions.rst:962 +#: ../Doc/library/functions.rst:971 msgid "``'+'``" msgstr "``'+'``" -#: ../Doc/library/functions.rst:962 +#: ../Doc/library/functions.rst:971 msgid "open a disk file for updating (reading and writing)" msgstr "ouvre un fichier pour le modifier (lire et écrire)" -#: ../Doc/library/functions.rst:963 +#: ../Doc/library/functions.rst:972 msgid "``'U'``" msgstr "``'U'``" -#: ../Doc/library/functions.rst:963 +#: ../Doc/library/functions.rst:972 msgid ":term:`universal newlines` mode (deprecated)" msgstr "mode :term:`universal newlines` (déprécié)" -#: ../Doc/library/functions.rst:966 +#: ../Doc/library/functions.rst:975 msgid "" "The default mode is ``'r'`` (open for reading text, synonym of ``'rt'``). " "For binary read-write access, the mode ``'w+b'`` opens and truncates the " @@ -1829,7 +1839,7 @@ msgstr "" "``'rt'``). Pour un accès en lecture écriture binaire, le mode ``'w+b'`` " "ouvre et vide le fichier. ``'r+b'`` ouvre le fichier sans le vider." -#: ../Doc/library/functions.rst:970 +#: ../Doc/library/functions.rst:979 msgid "" "As mentioned in the :ref:`io-overview`, Python distinguishes between binary " "and text I/O. Files opened in binary mode (including ``'b'`` in the *mode* " @@ -1847,7 +1857,7 @@ msgstr "" "été décodés au préalable en utilisant un encodage deduit de l'environnement " "ou *encoding* s'il est donné." -#: ../Doc/library/functions.rst:980 +#: ../Doc/library/functions.rst:989 msgid "" "Python doesn't depend on the underlying operating system's notion of text " "files; all the processing is done by Python itself, and is therefore " @@ -1857,7 +1867,7 @@ msgstr "" "jacent, tout est effectué par Python lui même, et ainsi indépendant de la " "plateforme." -#: ../Doc/library/functions.rst:984 +#: ../Doc/library/functions.rst:993 msgid "" "*buffering* is an optional integer used to set the buffering policy. Pass 0 " "to switch buffering off (only allowed in binary mode), 1 to select line " @@ -1872,7 +1882,7 @@ msgstr "" "en octets d'un tampon de taille fixe. Sans l'argument *buffering*, les " "comportements par défaut sont les suivants :" -#: ../Doc/library/functions.rst:990 +#: ../Doc/library/functions.rst:999 msgid "" "Binary files are buffered in fixed-size chunks; the size of the buffer is " "chosen using a heuristic trying to determine the underlying device's \"block " @@ -1885,7 +1895,7 @@ msgstr "" "DEFAULT_BUFFER_SIZE`. Sur de nombreux systèmes, le tampon sera de 4096 ou " "8192 octets." -#: ../Doc/library/functions.rst:995 +#: ../Doc/library/functions.rst:1004 msgid "" "\"Interactive\" text files (files for which :meth:`~io.IOBase.isatty` " "returns ``True``) use line buffering. Other text files use the policy " @@ -1895,7 +1905,7 @@ msgstr "" "isatty` donne ``True``) utilisent un tampon par lignes. Les autres fichiers " "texte sont traités comme les fichiers binaires." -#: ../Doc/library/functions.rst:999 +#: ../Doc/library/functions.rst:1008 msgid "" "*encoding* is the name of the encoding used to decode or encode the file. " "This should only be used in text mode. The default encoding is platform " @@ -1909,7 +1919,7 @@ msgstr "" "mais n'importe quel :term:`text encoding` supporté par Python peut être " "utilisé. Voir :mod:`codecs` pour une liste des encodages supportés." -#: ../Doc/library/functions.rst:1006 +#: ../Doc/library/functions.rst:1015 msgid "" "*errors* is an optional string that specifies how encoding and decoding " "errors are to be handled—this cannot be used in binary mode. A variety of " @@ -1924,7 +1934,7 @@ msgstr "" "enregistré avec :func:`codecs.register_error` est aussi un argument valide. " "Les noms standards sont :" -#: ../Doc/library/functions.rst:1014 +#: ../Doc/library/functions.rst:1023 msgid "" "``'strict'`` to raise a :exc:`ValueError` exception if there is an encoding " "error. The default value of ``None`` has the same effect." @@ -1932,7 +1942,7 @@ msgstr "" "``'strict'`` pour lever une :exc:`ValueError` si une erreur d'encodage est " "rencontrée. La valeur par défaut, ``None``, a le même effet." -#: ../Doc/library/functions.rst:1018 +#: ../Doc/library/functions.rst:1027 msgid "" "``'ignore'`` ignores errors. Note that ignoring encoding errors can lead to " "data loss." @@ -1940,7 +1950,7 @@ msgstr "" "``'ignore'`` ignore les erreures. Notez qu'ignorer les erreurs d'encodage " "peut mener à des pertes de données." -#: ../Doc/library/functions.rst:1021 +#: ../Doc/library/functions.rst:1030 msgid "" "``'replace'`` causes a replacement marker (such as ``'?'``) to be inserted " "where there is malformed data." @@ -1948,7 +1958,7 @@ msgstr "" "``'replace'`` insère un marqueur de substitution (tel que ``'?'``) en place " "des données malformées." -#: ../Doc/library/functions.rst:1024 +#: ../Doc/library/functions.rst:1033 msgid "" "``'surrogateescape'`` will represent any incorrect bytes as code points in " "the Unicode Private Use Area ranging from U+DC80 to U+DCFF. These private " @@ -1963,7 +1973,7 @@ msgstr "" "l'écriture de la donnée. C'est utile pour traiter des fichiers d'un encodage " "inconnu." -#: ../Doc/library/functions.rst:1031 +#: ../Doc/library/functions.rst:1040 msgid "" "``'xmlcharrefreplace'`` is only supported when writing to a file. Characters " "not supported by the encoding are replaced with the appropriate XML " @@ -1973,7 +1983,7 @@ msgstr "" "Les caractères non gérés par l'encodage sont remplacés par une référence de " "caractère XML ``&#nnn;``." -#: ../Doc/library/functions.rst:1035 +#: ../Doc/library/functions.rst:1044 msgid "" "``'backslashreplace'`` replaces malformed data by Python's backslashed " "escape sequences." @@ -1981,7 +1991,7 @@ msgstr "" "``'backslashreplace'`` remplace les données malformée par des séquences " "d'échappement Python (utilisant des *backslash*)." -#: ../Doc/library/functions.rst:1038 +#: ../Doc/library/functions.rst:1047 msgid "" "``'namereplace'`` (also only supported when writing) replaces unsupported " "characters with ``\\N{...}`` escape sequences." @@ -1989,7 +1999,7 @@ msgstr "" "``'namereplace'`` (aussi supporté lors de l'écriture) remplace les " "caractères non supportés par des séquences d'échappement ``\\N{...}``." -#: ../Doc/library/functions.rst:1044 +#: ../Doc/library/functions.rst:1053 msgid "" "*newline* controls how :term:`universal newlines` mode works (it only " "applies to text mode). It can be ``None``, ``''``, ``'\\n'``, ``'\\r'``, " @@ -1999,7 +2009,7 @@ msgstr "" "(seulement en mode texte). Il eut être ``None``, ``''``, ``'\\n'``, " "``'\\r'``, and ``'\\r\\n'``. Il fonctionne comme suit :" -#: ../Doc/library/functions.rst:1048 +#: ../Doc/library/functions.rst:1057 msgid "" "When reading input from the stream, if *newline* is ``None``, universal " "newlines mode is enabled. Lines in the input can end in ``'\\n'``, " @@ -2017,7 +2027,7 @@ msgstr "" "autorisée, les lignes sont seulement terminées par la chaîne donnée, qui est " "rendue tel qu'elle." -#: ../Doc/library/functions.rst:1056 +#: ../Doc/library/functions.rst:1065 msgid "" "When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` " "characters written are translated to the system default line separator, :" @@ -2031,7 +2041,7 @@ msgstr "" "*newline* est un autre caractère valide, chaque ``'\\n'`` sera remplacé par " "la chaîne donnée." -#: ../Doc/library/functions.rst:1062 +#: ../Doc/library/functions.rst:1071 msgid "" "If *closefd* is ``False`` and a file descriptor rather than a filename was " "given, the underlying file descriptor will be kept open when the file is " @@ -2043,7 +2053,7 @@ msgstr "" "le fichier sera fermé. Si un nom de fichier est donné, *closefd* doit rester " "``True`` (la valeur par défaut) sans quoi une erreur est levée." -#: ../Doc/library/functions.rst:1067 +#: ../Doc/library/functions.rst:1076 msgid "" "A custom opener can be used by passing a callable as *opener*. The " "underlying file descriptor for the file object is then obtained by calling " @@ -2057,13 +2067,13 @@ msgstr "" "descripteur de fichier ouvert (fournir :mod:`os.open` en temps qu'*opener* " "aura le même effet que donner ``None``)." -#: ../Doc/library/functions.rst:1073 +#: ../Doc/library/functions.rst:1082 msgid "The newly created file is :ref:`non-inheritable `." msgstr "" "Il n'est :ref:`pas possible d'hériter du fichier ` " "nouvellement créé." -#: ../Doc/library/functions.rst:1075 +#: ../Doc/library/functions.rst:1084 msgid "" "The following example uses the :ref:`dir_fd ` parameter of the :func:" "`os.open` function to open a file relative to a given directory::" @@ -2071,7 +2081,7 @@ msgstr "" "L'exemple suivant utilise le paramètre :ref:`dir_fd ` de la " "fonction :func:`os.open` pour ouvrir un fichier relatif au dossier courant ::" -#: ../Doc/library/functions.rst:1088 +#: ../Doc/library/functions.rst:1097 msgid "" "The type of :term:`file object` returned by the :func:`open` function " "depends on the mode. When :func:`open` is used to open a file in a text " @@ -2097,7 +2107,7 @@ msgstr "" "désactivé, le flux brut, une classe fille de :class:`io.RawIOBase`, :class:" "`io.FileIO` est donnée." -#: ../Doc/library/functions.rst:1109 +#: ../Doc/library/functions.rst:1118 msgid "" "See also the file handling modules, such as, :mod:`fileinput`, :mod:`io` " "(where :func:`open` is declared), :mod:`os`, :mod:`os.path`, :mod:" @@ -2107,21 +2117,21 @@ msgstr "" "`fileinput`, :mod:`io` (où :func:`open` est déclarée), :mod:`os`, :mod:`os." "path`, :mod:`tmpfile`, et :mod:`shutil`." -#: ../Doc/library/functions.rst:1116 +#: ../Doc/library/functions.rst:1125 msgid "The *opener* parameter was added." msgstr "Le paramètre *opener* a été ajouté." -#: ../Doc/library/functions.rst:1117 +#: ../Doc/library/functions.rst:1126 msgid "The ``'x'`` mode was added." msgstr "Le mode ``'x'`` a été ajouté." -#: ../Doc/library/functions.rst:1118 +#: ../Doc/library/functions.rst:1127 msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`." msgstr "" ":exc:`IOError` était normalement levée, elle est maintenant un alias de :exc:" "`OSError`." -#: ../Doc/library/functions.rst:1119 +#: ../Doc/library/functions.rst:1128 msgid "" ":exc:`FileExistsError` is now raised if the file opened in exclusive " "creation mode (``'x'``) already exists." @@ -2129,21 +2139,15 @@ msgstr "" ":exc:`FileExistsError` est maintenant levée si le fichier ouvert en mode " "création exclusive (``'x'``) existe déjà." -#: ../Doc/library/functions.rst:1125 +#: ../Doc/library/functions.rst:1134 msgid "The file is now non-inheritable." msgstr "Il n'est plus possible d'hériter de *file*." -#: ../Doc/library/functions.rst:None -msgid "" -"Deprecated since version 3.4, will be removed in version 4.0: The 'U' mode." -msgstr "" -"Déprécié depuis la version 3.4, sera supprimé dans la 4.0 : Le mode 'U'." - -#: ../Doc/library/functions.rst:1129 +#: ../Doc/library/functions.rst:1138 msgid "The ``'U'`` mode." msgstr "Le mode '``U'``." -#: ../Doc/library/functions.rst:1134 +#: ../Doc/library/functions.rst:1143 msgid "" "If the system call is interrupted and the signal handler does not raise an " "exception, the function now retries the system call instead of raising an :" @@ -2153,15 +2157,15 @@ msgstr "" "aucune exception, la fonction réessaye l'appel système au lieu de lever une :" "exc:`InterruptedError` (voir la :pep:`475` à propos du raisonnement)." -#: ../Doc/library/functions.rst:1137 +#: ../Doc/library/functions.rst:1146 msgid "The ``'namereplace'`` error handler was added." msgstr "Le gestionnaire d'erreurs ``'namereplace'`` a été ajouté." -#: ../Doc/library/functions.rst:1142 +#: ../Doc/library/functions.rst:1151 msgid "Support added to accept objects implementing :class:`os.PathLike`." msgstr "Ajout du support des objets implémentant :class:`os.PathLike`." -#: ../Doc/library/functions.rst:1143 +#: ../Doc/library/functions.rst:1152 msgid "" "On Windows, opening a console buffer may return a subclass of :class:`io." "RawIOBase` other than :class:`io.FileIO`." @@ -2169,7 +2173,7 @@ msgstr "" "Sous Windows, ouvrir un *buffer* du terminal peut renvoyer une sous-classe " "de :class:`io.RawIOBase` autre que :class:`io.FileIO`." -#: ../Doc/library/functions.rst:1148 +#: ../Doc/library/functions.rst:1157 msgid "" "Given a string representing one Unicode character, return an integer " "representing the Unicode code point of that character. For example, " @@ -2181,7 +2185,7 @@ msgstr "" "nombre entier ``97`` et ``ord('€')`` (symbole Euro) renvoie ``8364``. Il " "s'agit de l'inverse de :func:`chr`." -#: ../Doc/library/functions.rst:1156 +#: ../Doc/library/functions.rst:1165 msgid "" "Return *x* to the power *y*; if *z* is present, return *x* to the power *y*, " "modulo *z* (computed more efficiently than ``pow(x, y) % z``). The two-" @@ -2192,7 +2196,7 @@ msgstr "" "modulo *z* (calculé de manière plus efficiente que ``pow(x, y) % z``). La " "forme à deux arguments est équivalent à ``x**y``." -#: ../Doc/library/functions.rst:1160 +#: ../Doc/library/functions.rst:1169 msgid "" "The arguments must have numeric types. With mixed operand types, the " "coercion rules for binary arithmetic operators apply. For :class:`int` " @@ -2213,7 +2217,7 @@ msgstr "" "argument est négatif, le troisième doit être omis. Si *z* est fourni, *x* et " "*y* doivent être des entiers et *y* positif." -#: ../Doc/library/functions.rst:1172 +#: ../Doc/library/functions.rst:1181 msgid "" "Print *objects* to the text stream *file*, separated by *sep* and followed " "by *end*. *sep*, *end*, *file* and *flush*, if present, must be given as " @@ -2223,7 +2227,7 @@ msgstr "" "*end*. *sep*, *end*, *file*, et *flush*, s'ils sont présents, doivent être " "données par mot clef." -#: ../Doc/library/functions.rst:1176 +#: ../Doc/library/functions.rst:1185 msgid "" "All non-keyword arguments are converted to strings like :func:`str` does and " "written to the stream, separated by *sep* and followed by *end*. Both *sep* " @@ -2237,7 +2241,7 @@ msgstr "" "les valeurs par défaut. Si aucun *objects* n'est donné :func:`print` écris " "seulement *end*." -#: ../Doc/library/functions.rst:1182 +#: ../Doc/library/functions.rst:1191 msgid "" "The *file* argument must be an object with a ``write(string)`` method; if it " "is not present or ``None``, :data:`sys.stdout` will be used. Since printed " @@ -2250,7 +2254,7 @@ msgstr "" "peut pas être utilisé avec des fichiers ouverts en mode binaire. Pour ceux " "ci utilisez plutôt ``file.write(...)``." -#: ../Doc/library/functions.rst:1187 +#: ../Doc/library/functions.rst:1196 msgid "" "Whether output is buffered is usually determined by *file*, but if the " "*flush* keyword argument is true, the stream is forcibly flushed." @@ -2258,15 +2262,15 @@ msgstr "" "Que la sortie utilise un *buffer* ou non est souvent décidé par *file*, mais " "si l'argument *flush* est vrai, le tampon du flux est vidé explicitement." -#: ../Doc/library/functions.rst:1190 +#: ../Doc/library/functions.rst:1199 msgid "Added the *flush* keyword argument." msgstr "Ajout de l'argument par mot clef *flush*." -#: ../Doc/library/functions.rst:1196 +#: ../Doc/library/functions.rst:1205 msgid "Return a property attribute." msgstr "Donne un attribut propriété." -#: ../Doc/library/functions.rst:1198 +#: ../Doc/library/functions.rst:1207 msgid "" "*fget* is a function for getting an attribute value. *fset* is a function " "for setting an attribute value. *fdel* is a function for deleting an " @@ -2277,11 +2281,11 @@ msgstr "" "supprimer la valeur d'un attribut, et *doc* créé une *docstring* pour " "l'attribut." -#: ../Doc/library/functions.rst:1202 +#: ../Doc/library/functions.rst:1211 msgid "A typical use is to define a managed attribute ``x``::" msgstr "Une utilisation typique : définir un attribut managé ``x`` : ::" -#: ../Doc/library/functions.rst:1219 +#: ../Doc/library/functions.rst:1228 msgid "" "If *c* is an instance of *C*, ``c.x`` will invoke the getter, ``c.x = " "value`` will invoke the setter and ``del c.x`` the deleter." @@ -2289,7 +2293,7 @@ msgstr "" "Si *c* est une instance de *C*, ``c.x`` appellera le *getter*, ``c.x = " "value`` invoquera le *setter*, et ``del x`` le *deleter*." -#: ../Doc/library/functions.rst:1222 +#: ../Doc/library/functions.rst:1231 msgid "" "If given, *doc* will be the docstring of the property attribute. Otherwise, " "the property will copy *fget*'s docstring (if it exists). This makes it " @@ -2301,7 +2305,7 @@ msgstr "" "création de propriétés en lecture seule en utilisant simplement :func:" "`property` comme un :term:`decorator` : ::" -#: ../Doc/library/functions.rst:1235 +#: ../Doc/library/functions.rst:1244 msgid "" "The ``@property`` decorator turns the :meth:`voltage` method into a \"getter" "\" for a read-only attribute with the same name, and it sets the docstring " @@ -2311,7 +2315,7 @@ msgstr "" "*getter* d'un attribut du même nom, et donne \"Get the current voltage\" " "comme *docstring* de *voltage*." -#: ../Doc/library/functions.rst:1239 +#: ../Doc/library/functions.rst:1248 msgid "" "A property object has :attr:`~property.getter`, :attr:`~property.setter`, " "and :attr:`~property.deleter` methods usable as decorators that create a " @@ -2323,7 +2327,7 @@ msgstr "" "une copie de la propriété avec les accesseurs correspondants définis par la " "fonction de décoration. C'est plus clair avec un exemple : ::" -#: ../Doc/library/functions.rst:1261 +#: ../Doc/library/functions.rst:1270 msgid "" "This code is exactly equivalent to the first example. Be sure to give the " "additional functions the same name as the original property (``x`` in this " @@ -2333,7 +2337,7 @@ msgstr "" "donner aux fonctions additionnelles le même nom que la propriété (``x`` dans " "ce cas.)" -#: ../Doc/library/functions.rst:1265 +#: ../Doc/library/functions.rst:1274 msgid "" "The returned property object also has the attributes ``fget``, ``fset``, and " "``fdel`` corresponding to the constructor arguments." @@ -2341,11 +2345,11 @@ msgstr "" "L'objet propriété donné à aussi les attributs ``fget``, ``fset`` et ``fdel`` " "correspondant correspondants aux arguments du constructeur." -#: ../Doc/library/functions.rst:1268 +#: ../Doc/library/functions.rst:1277 msgid "The docstrings of property objects are now writeable." msgstr "Les *docstrings* des objets propriété peuvent maintenant être écrits." -#: ../Doc/library/functions.rst:1277 +#: ../Doc/library/functions.rst:1286 msgid "" "Rather than being a function, :class:`range` is actually an immutable " "sequence type, as documented in :ref:`typesseq-range` and :ref:`typesseq`." @@ -2353,7 +2357,7 @@ msgstr "" "Plutôt qu'être une fonction, :class:`range` est en fait une séquence " "immuable, tel que documenté dans :ref:`typesseq-range` et :ref:`typesseq`." -#: ../Doc/library/functions.rst:1283 +#: ../Doc/library/functions.rst:1292 msgid "" "Return a string containing a printable representation of an object. For " "many types, this function makes an attempt to return a string that would " @@ -2371,7 +2375,7 @@ msgstr "" "l'objet. Une classe peut contrôler ce que cette fonction donne pour ses " "instances en définissant une méthode :meth:`_repr__`." -#: ../Doc/library/functions.rst:1294 +#: ../Doc/library/functions.rst:1303 msgid "" "Return a reverse :term:`iterator`. *seq* must be an object which has a :" "meth:`__reversed__` method or supports the sequence protocol (the :meth:" @@ -2383,7 +2387,7 @@ msgstr "" "meth:`__len__` et la méthode :meth:`__getitem__` avec des arguments entiers " "commençant à zéro)." -#: ../Doc/library/functions.rst:1302 +#: ../Doc/library/functions.rst:1311 msgid "" "Return *number* rounded to *ndigits* precision after the decimal point. If " "*ndigits* is omitted or is ``None``, it returns the nearest integer to its " @@ -2393,7 +2397,7 @@ msgstr "" "virgule. Si *ndigits* est omis ou est ``None``, l'entier le plus proche est " "renvoyé." -#: ../Doc/library/functions.rst:1306 +#: ../Doc/library/functions.rst:1315 msgid "" "For the built-in types supporting :func:`round`, values are rounded to the " "closest multiple of 10 to the power minus *ndigits*; if two multiples are " @@ -2411,7 +2415,7 @@ msgstr "" "(positif, zéro, ou négatif). La valeur rendue est un entier si elle *round* " "est appelée avec un seul argument, sinon elle sera du même type que *number*." -#: ../Doc/library/functions.rst:1314 +#: ../Doc/library/functions.rst:1323 msgid "" "For a general Python object ``number``, ``round(number, ndigits)`` delegates " "to ``number.__round__(ndigits)``." @@ -2419,7 +2423,7 @@ msgstr "" "Pour un objet Python ``number``, ``round(number, ndigits)`` est délégué à " "``number.__round__(ndigits)``." -#: ../Doc/library/functions.rst:1319 +#: ../Doc/library/functions.rst:1328 msgid "" "The behavior of :func:`round` for floats can be surprising: for example, " "``round(2.675, 2)`` gives ``2.67`` instead of the expected ``2.68``. This is " @@ -2433,7 +2437,7 @@ msgstr "" "de décimaux ne peuvent pas être représentés exactement en nombre a virgule " "flottante. Voir :ref:`tut-fp-issues` pour plus d'information." -#: ../Doc/library/functions.rst:1330 +#: ../Doc/library/functions.rst:1339 msgid "" "Return a new :class:`set` object, optionally with elements taken from " "*iterable*. ``set`` is a built-in class. See :class:`set` and :ref:`types-" @@ -2443,7 +2447,7 @@ msgstr "" "d'*iterable*. ``set`` est une classe native. Voir :class:`set` et :ref:" "`types-set` pour la documentation de cette classe." -#: ../Doc/library/functions.rst:1334 +#: ../Doc/library/functions.rst:1343 msgid "" "For other containers see the built-in :class:`frozenset`, :class:`list`, :" "class:`tuple`, and :class:`dict` classes, as well as the :mod:`collections` " @@ -2453,7 +2457,7 @@ msgstr "" "`list`, :class:`tuple`, et :class:`dict`, ainsi que le module :mod:" "`collections`." -#: ../Doc/library/functions.rst:1341 +#: ../Doc/library/functions.rst:1350 msgid "" "This is the counterpart of :func:`getattr`. The arguments are an object, a " "string and an arbitrary value. The string may name an existing attribute or " @@ -2467,7 +2471,7 @@ msgstr "" "si l'objet l'autorise. Par exemple, ``setattr(x, 'foobar', 123)`` équivaut à " "``x.foobar = 123``." -#: ../Doc/library/functions.rst:1353 +#: ../Doc/library/functions.rst:1362 msgid "" "Return a :term:`slice` object representing the set of indices specified by " "``range(start, stop, step)``. The *start* and *step* arguments default to " @@ -2491,16 +2495,16 @@ msgstr "" "étendue. Par exemple ``a[start:stop:step]`` ou ``a[start:stop, i]``. Voir :" "func:`itertools.islice` pour une version alternative donnant un itérateur." -#: ../Doc/library/functions.rst:1366 +#: ../Doc/library/functions.rst:1375 msgid "Return a new sorted list from the items in *iterable*." msgstr "Donne une nouvelle liste triée depuis les éléments d'*iterable*." -#: ../Doc/library/functions.rst:1368 +#: ../Doc/library/functions.rst:1377 msgid "" "Has two optional arguments which must be specified as keyword arguments." msgstr "A deux arguments optionnels qui doivent être fournis par mot clef." -#: ../Doc/library/functions.rst:1370 +#: ../Doc/library/functions.rst:1379 msgid "" "*key* specifies a function of one argument that is used to extract a " "comparison key from each list element: ``key=str.lower``. The default value " @@ -2510,7 +2514,7 @@ msgstr "" "comparaison de chaque élément de la liste : ``key=str.lower``. La valeur par " "défaut est ``None`` (compare les éléments directement)." -#: ../Doc/library/functions.rst:1374 +#: ../Doc/library/functions.rst:1383 msgid "" "*reverse* is a boolean value. If set to ``True``, then the list elements " "are sorted as if each comparison were reversed." @@ -2518,7 +2522,7 @@ msgstr "" "*reverse*, une valeur booléenne. Si elle est ``True``, la liste d'éléments " "est triée comme si toutes les comparaisons étaient inversées." -#: ../Doc/library/functions.rst:1377 +#: ../Doc/library/functions.rst:1386 msgid "" "Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function to a " "*key* function." @@ -2526,7 +2530,7 @@ msgstr "" "Utilisez :func:`functools.cmp_to_key` pour convertir l'ancienne notation " "*cmp* en une fonction *key*." -#: ../Doc/library/functions.rst:1380 +#: ../Doc/library/functions.rst:1389 msgid "" "The built-in :func:`sorted` function is guaranteed to be stable. A sort is " "stable if it guarantees not to change the relative order of elements that " @@ -2538,17 +2542,17 @@ msgstr "" "eux. C'est util pour trier en plusieurs passes, par exemple par département " "puis par salaire)." -#: ../Doc/library/functions.rst:1385 +#: ../Doc/library/functions.rst:1394 msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" "Pour des exemples de tris et un bref tutoriel, consultez :ref:`sortinghowto`." -#: ../Doc/library/functions.rst:1389 +#: ../Doc/library/functions.rst:1398 msgid "Transform a method into a static method." msgstr "Transforme une méthode en méthode statique." -#: ../Doc/library/functions.rst:1391 +#: ../Doc/library/functions.rst:1400 msgid "" "A static method does not receive an implicit first argument. To declare a " "static method, use this idiom::" @@ -2556,7 +2560,7 @@ msgstr "" "Une méthode statique ne reçoit pas de premier argument implicitement. Voilà " "comment déclarer une méthode statique : ::" -#: ../Doc/library/functions.rst:1398 +#: ../Doc/library/functions.rst:1407 msgid "" "The ``@staticmethod`` form is a function :term:`decorator` -- see the " "description of function definitions in :ref:`function` for details." @@ -2565,7 +2569,7 @@ msgstr "" "description des définitions de fonction dans :ref:`function` pour plus de " "détails." -#: ../Doc/library/functions.rst:1401 +#: ../Doc/library/functions.rst:1410 msgid "" "It can be called either on the class (such as ``C.f()``) or on an instance " "(such as ``C().f()``). The instance is ignored except for its class." @@ -2573,7 +2577,7 @@ msgstr "" "Elle peut être appelée soit sur une classe (tel que ``C.f()``) ou sur une " "instance (tel que ``C().f()``). L'instance est ignorée, sauf pour sa classe." -#: ../Doc/library/functions.rst:1404 +#: ../Doc/library/functions.rst:1413 msgid "" "Static methods in Python are similar to those found in Java or C++. Also " "see :func:`classmethod` for a variant that is useful for creating alternate " @@ -2583,7 +2587,7 @@ msgstr "" "ou en C++. Consultez :func:`classmethod` pour une variante utile pour créer " "des constructeurs alternatifs." -#: ../Doc/library/functions.rst:1408 +#: ../Doc/library/functions.rst:1417 #, fuzzy msgid "" "Like all decorators, it is also possible to call ``staticmethod`` as a " @@ -2598,7 +2602,7 @@ msgstr "" "depuis le corps d'une classe, et souhaiteriez éviter sa transformation en " "méthode d'instance. Pour ces cas, faites comme suit ::" -#: ../Doc/library/functions.rst:1417 +#: ../Doc/library/functions.rst:1426 msgid "" "For more information on static methods, consult the documentation on the " "standard type hierarchy in :ref:`types`." @@ -2606,14 +2610,14 @@ msgstr "" "Pour plus d'informations sur les méthodes statiques, consultez la " "documentation de la hiérarchie des types standards dans :ref:`types`." -#: ../Doc/library/functions.rst:1429 +#: ../Doc/library/functions.rst:1438 msgid "" "Return a :class:`str` version of *object*. See :func:`str` for details." msgstr "" "Donne une version sous forme de :class:`str` d'*object*. Voir :func:`str` " "pour plus de détails." -#: ../Doc/library/functions.rst:1431 +#: ../Doc/library/functions.rst:1440 msgid "" "``str`` is the built-in string :term:`class`. For general information about " "strings, see :ref:`textseq`." @@ -2621,7 +2625,7 @@ msgstr "" "``str`` est la :term:`class` native des chaînes de caractères. Pour des " "informations générales à propos des chaînes, consultez :ref:`textseq`." -#: ../Doc/library/functions.rst:1437 +#: ../Doc/library/functions.rst:1446 msgid "" "Sums *start* and the items of an *iterable* from left to right and returns " "the total. *start* defaults to ``0``. The *iterable*'s items are normally " @@ -2632,7 +2636,7 @@ msgstr "" "sont normalement des nombres, et la valeur de *start* ne peut pas être une " "chaîne." -#: ../Doc/library/functions.rst:1441 +#: ../Doc/library/functions.rst:1450 msgid "" "For some use cases, there are good alternatives to :func:`sum`. The " "preferred, fast way to concatenate a sequence of strings is by calling ``''." @@ -2646,7 +2650,7 @@ msgstr "" "meilleure précision, voir :func:`math.fsum`. Pour concaténer une série " "d'itérables, utilisez plutôt :func:`itertools.chain`." -#: ../Doc/library/functions.rst:1449 +#: ../Doc/library/functions.rst:1458 msgid "" "Return a proxy object that delegates method calls to a parent or sibling " "class of *type*. This is useful for accessing inherited methods that have " @@ -2659,7 +2663,7 @@ msgstr "" "même que celui utilisé par :func:`getattr` sauf que *type* lui même est " "sauté." -#: ../Doc/library/functions.rst:1454 +#: ../Doc/library/functions.rst:1463 msgid "" "The :attr:`~class.__mro__` attribute of the *type* lists the method " "resolution search order used by both :func:`getattr` and :func:`super`. The " @@ -2671,7 +2675,7 @@ msgstr "" "L'attribut est dynamique et peut changer lorsque la hiérarchie d'héritage " "est modifiée." -#: ../Doc/library/functions.rst:1459 +#: ../Doc/library/functions.rst:1468 msgid "" "If the second argument is omitted, the super object returned is unbound. If " "the second argument is an object, ``isinstance(obj, type)`` must be true. " @@ -2683,7 +2687,7 @@ msgstr "" "le second argument est un type, ``issubclass(type2, type)`` doit être vrai " "(c'est utile pour les méthodes de classe)." -#: ../Doc/library/functions.rst:1464 +#: ../Doc/library/functions.rst:1473 msgid "" "There are two typical use cases for *super*. In a class hierarchy with " "single inheritance, *super* can be used to refer to parent classes without " @@ -2696,7 +2700,7 @@ msgstr "" "maintenable. Cet usage se rapproche de l'usage de *super* dans d'autres " "langages de programmation." -#: ../Doc/library/functions.rst:1469 +#: ../Doc/library/functions.rst:1478 msgid "" "The second use case is to support cooperative multiple inheritance in a " "dynamic execution environment. This use case is unique to Python and is not " @@ -2719,12 +2723,12 @@ msgstr "" "changements dans la hiérarchie, et parce que l'ordre peut inclure des " "classes soeur inconnues avant l'exécution)." -#: ../Doc/library/functions.rst:1479 +#: ../Doc/library/functions.rst:1488 msgid "For both use cases, a typical superclass call looks like this::" msgstr "" "Dans tous les cas, un appel typique à une classe parente ressemble à : ::" -#: ../Doc/library/functions.rst:1486 +#: ../Doc/library/functions.rst:1495 msgid "" "Note that :func:`super` is implemented as part of the binding process for " "explicit dotted attribute lookups such as ``super().__getitem__(name)``. It " @@ -2741,7 +2745,7 @@ msgstr "" "n'est pas défini pour les recherches implicites via des instructions ou des " "opérateurs tel que ``super()[name]``." -#: ../Doc/library/functions.rst:1493 +#: ../Doc/library/functions.rst:1502 msgid "" "Also note that, aside from the zero argument form, :func:`super` is not " "limited to use inside methods. The two argument form specifies the " @@ -2758,7 +2762,7 @@ msgstr "" "propos de la classe en cours de définition, ainsi qu'accéder à l'instance " "courante pour les méthodes ordinaires." -#: ../Doc/library/functions.rst:1500 +#: ../Doc/library/functions.rst:1509 msgid "" "For practical suggestions on how to design cooperative classes using :func:" "`super`, see `guide to using super() `_." -#: ../Doc/library/functions.rst:1509 +#: ../Doc/library/functions.rst:1518 msgid "" "Rather than being a function, :class:`tuple` is actually an immutable " "sequence type, as documented in :ref:`typesseq-tuple` and :ref:`typesseq`." @@ -2776,7 +2780,7 @@ msgstr "" "Plutôt qu'être une fonction, :class:`tuple` est en fait un type de séquence " "immuable, tel que documenté dans :ref:`typesseq-tuple` et :ref:`typesseq`." -#: ../Doc/library/functions.rst:1518 +#: ../Doc/library/functions.rst:1527 msgid "" "With one argument, return the type of an *object*. The return value is a " "type object and generally the same object as returned by :attr:`object." @@ -2786,7 +2790,7 @@ msgstr "" "type et généralement la même que la valeur de l'attribut :attr:`object." "__class__ `." -#: ../Doc/library/functions.rst:1522 +#: ../Doc/library/functions.rst:1531 msgid "" "The :func:`isinstance` built-in function is recommended for testing the type " "of an object, because it takes subclasses into account." @@ -2794,7 +2798,7 @@ msgstr "" "La fonction native :func:`isinstance` est recommandée pour tester le type " "d'un objet car elle prend en compte l'héritage." -#: ../Doc/library/functions.rst:1526 +#: ../Doc/library/functions.rst:1535 msgid "" "With three arguments, return a new type object. This is essentially a " "dynamic form of the :keyword:`class` statement. The *name* string is the " @@ -2815,11 +2819,11 @@ msgstr "" "exemple, les deux instructions suivantes créent deux instances identiques " "de :class:`type`." -#: ../Doc/library/functions.rst:1540 +#: ../Doc/library/functions.rst:1549 msgid "See also :ref:`bltin-type-objects`." msgstr "Voir aussi :ref:`bltin-type-objects`." -#: ../Doc/library/functions.rst:1542 +#: ../Doc/library/functions.rst:1551 msgid "" "Subclasses of :class:`type` which don't override ``type.__new__`` may no " "longer use the one-argument form to get the type of an object." @@ -2828,7 +2832,7 @@ msgstr "" "ne devraient plus utiliser la forme à un argument pour récupérer le type " "d'un objet." -#: ../Doc/library/functions.rst:1548 +#: ../Doc/library/functions.rst:1557 msgid "" "Return the :attr:`~object.__dict__` attribute for a module, class, instance, " "or any other object with a :attr:`~object.__dict__` attribute." @@ -2837,7 +2841,7 @@ msgstr "" "instance ou de n'importe quel objet avec un attribut :attr:`~object." "__dict__`." -#: ../Doc/library/functions.rst:1551 +#: ../Doc/library/functions.rst:1560 msgid "" "Objects such as modules and instances have an updateable :attr:`~object." "__dict__` attribute; however, other objects may have write restrictions on " @@ -2850,7 +2854,7 @@ msgstr "" "exemple, les classes utilisent un :class:`types.MappingProxyType` pour " "éviter les modifications directes du dictionnaire)." -#: ../Doc/library/functions.rst:1556 +#: ../Doc/library/functions.rst:1565 msgid "" "Without an argument, :func:`vars` acts like :func:`locals`. Note, the " "locals dictionary is only useful for reads since updates to the locals " @@ -2860,11 +2864,11 @@ msgstr "" "dictionnaire des variables locales n'est utile qu'en lecture, car ses " "écritures sont ignorées." -#: ../Doc/library/functions.rst:1563 +#: ../Doc/library/functions.rst:1572 msgid "Make an iterator that aggregates elements from each of the iterables." msgstr "Construit un itérateur agrégeant les éléments de tous les itérables." -#: ../Doc/library/functions.rst:1565 +#: ../Doc/library/functions.rst:1574 msgid "" "Returns an iterator of tuples, where the *i*-th tuple contains the *i*-th " "element from each of the argument sequences or iterables. The iterator " @@ -2878,7 +2882,7 @@ msgstr "" "elle donne un itérateur sur des *tuples* d'un élément. Sans arguments, elle " "donne un itérateur vide. Équivalent à : ::" -#: ../Doc/library/functions.rst:1584 +#: ../Doc/library/functions.rst:1593 msgid "" "The left-to-right evaluation order of the iterables is guaranteed. This " "makes possible an idiom for clustering a data series into n-length groups " @@ -2892,7 +2896,7 @@ msgstr "" "que le tuple obtenu contient le résultat de ``n`` appels à l'itérateur. Cela " "a pour effet de diviser la séquence en morceaux de taille *n*." -#: ../Doc/library/functions.rst:1590 +#: ../Doc/library/functions.rst:1599 msgid "" ":func:`zip` should only be used with unequal length inputs when you don't " "care about trailing, unmatched values from the longer iterables. If those " @@ -2903,7 +2907,7 @@ msgstr "" "peuvent être ignorées. Si c'est valeurs sont importantes, utilisez plutôt :" "func:`itertools.zip_longest`." -#: ../Doc/library/functions.rst:1594 +#: ../Doc/library/functions.rst:1603 msgid "" ":func:`zip` in conjunction with the ``*`` operator can be used to unzip a " "list::" @@ -2911,7 +2915,7 @@ msgstr "" ":func:`zip` peut être utilisée conjointement avec l'opérateur ``*`` pour de-" "*zip*-per une liste : ::" -#: ../Doc/library/functions.rst:1615 +#: ../Doc/library/functions.rst:1624 msgid "" "This is an advanced function that is not needed in everyday Python " "programming, unlike :func:`importlib.import_module`." @@ -2919,7 +2923,7 @@ msgstr "" "C'est une fonction avancée qui n'est pas fréquemment nécessaire, " "contrairement à :func:`importlib.import_module`." -#: ../Doc/library/functions.rst:1618 +#: ../Doc/library/functions.rst:1627 msgid "" "This function is invoked by the :keyword:`import` statement. It can be " "replaced (by importing the :mod:`builtins` module and assigning to " @@ -2939,7 +2943,7 @@ msgstr "" "L'usage direct de :func:`__import__` est aussi déconseillé en faveur de :" "func:`importlib.import_module`." -#: ../Doc/library/functions.rst:1627 +#: ../Doc/library/functions.rst:1636 msgid "" "The function imports the module *name*, potentially using the given " "*globals* and *locals* to determine how to interpret the name in a package " @@ -2955,7 +2959,7 @@ msgstr "" "l'argument *locals* et n'utilise *globals* que pour déterminer le contexte " "du paquet de l'instruction :keyword:`import`." -#: ../Doc/library/functions.rst:1634 +#: ../Doc/library/functions.rst:1643 msgid "" "*level* specifies whether to use absolute or relative imports. ``0`` (the " "default) means only perform absolute imports. Positive values for *level* " @@ -2968,7 +2972,7 @@ msgstr "" "le nombre de dossiers parents relatifvement au dossier du module appelant :" "func:`__import__` (voir la :pep:`328`)." -#: ../Doc/library/functions.rst:1640 +#: ../Doc/library/functions.rst:1649 msgid "" "When the *name* variable is of the form ``package.module``, normally, the " "top-level package (the name up till the first dot) is returned, *not* the " @@ -2980,7 +2984,7 @@ msgstr "" "le module nommé par *name*. Cependant, lorsqu'un argument *fromlist* est " "fourni, le module nommé par *name* est donné." -#: ../Doc/library/functions.rst:1645 +#: ../Doc/library/functions.rst:1654 msgid "" "For example, the statement ``import spam`` results in bytecode resembling " "the following code::" @@ -2988,11 +2992,11 @@ msgstr "" "Par exemple, l'instruction ``import spam`` donne un bytecode ressemblant ai " "code suivant : ::" -#: ../Doc/library/functions.rst:1650 +#: ../Doc/library/functions.rst:1659 msgid "The statement ``import spam.ham`` results in this call::" msgstr "L'instruction ``import ham.ham`` appelle : ::" -#: ../Doc/library/functions.rst:1654 +#: ../Doc/library/functions.rst:1663 msgid "" "Note how :func:`__import__` returns the toplevel module here because this is " "the object that is bound to a name by the :keyword:`import` statement." @@ -3000,7 +3004,7 @@ msgstr "" "Notez comment :func:`__import__` donne le module le plus haut ici parce que " "c'est l'objet lié à un nom par l'nstruction :keyword:`import`." -#: ../Doc/library/functions.rst:1657 +#: ../Doc/library/functions.rst:1666 msgid "" "On the other hand, the statement ``from spam.ham import eggs, sausage as " "saus`` results in ::" @@ -3008,7 +3012,7 @@ msgstr "" "En revanche, l'instruction ``from spam.ham import eggs, saucage as saus`` " "donne : ::" -#: ../Doc/library/functions.rst:1664 +#: ../Doc/library/functions.rst:1673 msgid "" "Here, the ``spam.ham`` module is returned from :func:`__import__`. From " "this object, the names to import are retrieved and assigned to their " @@ -3017,7 +3021,7 @@ msgstr "" "Ici le module ``spam.ham`` est donné par :func:`__import__`. De cet objet, " "les noms à importer sont récupérés et assignés à leurs noms respectifs." -#: ../Doc/library/functions.rst:1668 +#: ../Doc/library/functions.rst:1677 msgid "" "If you simply want to import a module (potentially within a package) by " "name, use :func:`importlib.import_module`." @@ -3025,7 +3029,7 @@ msgstr "" "Si vous voulez simplement importer un module (potentiellement dans un " "paquet) par son nom, utilisez :func:`importlib.import_module`." -#: ../Doc/library/functions.rst:1671 +#: ../Doc/library/functions.rst:1680 msgid "" "Negative values for *level* are no longer supported (which also changes the " "default value to 0)." @@ -3033,11 +3037,11 @@ msgstr "" "Des valeurs négatives pour *level* ne sont plus gérées (ce qui change la " "valeur par défaut pour 0)." -#: ../Doc/library/functions.rst:1677 +#: ../Doc/library/functions.rst:1686 msgid "Footnotes" msgstr "Notes" -#: ../Doc/library/functions.rst:1678 +#: ../Doc/library/functions.rst:1687 msgid "" "Note that the parser only accepts the Unix-style end of line convention. If " "you are reading the code from a file, make sure to use newline conversion " @@ -3047,6 +3051,12 @@ msgstr "" "lisez le code depuis un fichier, assurez-vous d'utiliser la conversion de " "retours à la ligne pour convertir les fin de lignes Windows et Mac." +#~ msgid "" +#~ "Deprecated since version 3.4, will be removed in version 4.0: The 'U' " +#~ "mode." +#~ msgstr "" +#~ "Déprécié depuis la version 3.4, sera supprimé dans la 4.0 : Le mode 'U'." + #~ msgid "class C:" #~ msgstr "class C:" diff --git a/library/importlib.po b/library/importlib.po index 56cfd26f..967cc645 100644 --- a/library/importlib.po +++ b/library/importlib.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-02-08 09:58+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2017-08-10 01:00+0200\n" "Last-Translator: Julien Palard \n" "Language-Team: \n" @@ -1257,7 +1257,7 @@ msgid "" "Name of the place from which the module is loaded, e.g. \"builtin\" for " "built-in modules and the filename for modules loaded from source. Normally " "\"origin\" should be set, but it may be ``None`` (the default) which " -"indicates it is unspecified (e.g. for namespace packages)." +"indicates it is unspecified." msgstr "" #: ../Doc/library/importlib.rst:1084 diff --git a/library/ipaddress.po b/library/ipaddress.po index b32be376..669cb3aa 100644 --- a/library/ipaddress.po +++ b/library/ipaddress.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-04-02 22:11+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -108,20 +108,22 @@ msgid "" "The :class:`IPv4Address` and :class:`IPv6Address` objects share a lot of " "common attributes. Some attributes that are only meaningful for IPv6 " "addresses are also implemented by :class:`IPv4Address` objects, in order to " -"make it easier to write code that handles both IP versions correctly." +"make it easier to write code that handles both IP versions correctly. " +"Address objects are :term:`hashable`, so they can be used as keys in " +"dictionaries." msgstr "" -#: ../Doc/library/ipaddress.rst:96 +#: ../Doc/library/ipaddress.rst:97 msgid "" "Construct an IPv4 address. An :exc:`AddressValueError` is raised if " "*address* is not a valid IPv4 address." msgstr "" -#: ../Doc/library/ipaddress.rst:99 +#: ../Doc/library/ipaddress.rst:100 msgid "The following constitutes a valid IPv4 address:" msgstr "" -#: ../Doc/library/ipaddress.rst:101 +#: ../Doc/library/ipaddress.rst:102 msgid "" "A string in decimal-dot notation, consisting of four decimal integers in the " "inclusive range 0--255, separated by dots (e.g. ``192.168.0.1``). Each " @@ -130,39 +132,39 @@ msgid "" "decimal and octal interpretations of such strings)." msgstr "" -#: ../Doc/library/ipaddress.rst:106 +#: ../Doc/library/ipaddress.rst:107 msgid "An integer that fits into 32 bits." msgstr "" -#: ../Doc/library/ipaddress.rst:107 +#: ../Doc/library/ipaddress.rst:108 msgid "" "An integer packed into a :class:`bytes` object of length 4 (most significant " "octet first)." msgstr "" -#: ../Doc/library/ipaddress.rst:119 +#: ../Doc/library/ipaddress.rst:120 msgid "The appropriate version number: ``4`` for IPv4, ``6`` for IPv6." msgstr "" -#: ../Doc/library/ipaddress.rst:123 +#: ../Doc/library/ipaddress.rst:124 msgid "" "The total number of bits in the address representation for this version: " "``32`` for IPv4, ``128`` for IPv6." msgstr "" -#: ../Doc/library/ipaddress.rst:126 +#: ../Doc/library/ipaddress.rst:127 msgid "" "The prefix defines the number of leading bits in an address that are " "compared to determine whether or not an address is part of a network." msgstr "" -#: ../Doc/library/ipaddress.rst:133 +#: ../Doc/library/ipaddress.rst:134 msgid "" "The string representation in dotted decimal notation. Leading zeroes are " "never included in the representation." msgstr "" -#: ../Doc/library/ipaddress.rst:136 +#: ../Doc/library/ipaddress.rst:137 msgid "" "As IPv4 does not define a shorthand notation for addresses with octets set " "to zero, these two attributes are always the same as ``str(addr)`` for IPv4 " @@ -170,73 +172,73 @@ msgid "" "that can handle both IPv4 and IPv6 addresses." msgstr "" -#: ../Doc/library/ipaddress.rst:143 +#: ../Doc/library/ipaddress.rst:144 msgid "" "The binary representation of this address - a :class:`bytes` object of the " "appropriate length (most significant octet first). This is 4 bytes for IPv4 " "and 16 bytes for IPv6." msgstr "" -#: ../Doc/library/ipaddress.rst:149 +#: ../Doc/library/ipaddress.rst:150 msgid "The name of the reverse DNS PTR record for the IP address, e.g.::" msgstr "" -#: ../Doc/library/ipaddress.rst:156 +#: ../Doc/library/ipaddress.rst:157 msgid "" "This is the name that could be used for performing a PTR lookup, not the " "resolved hostname itself." msgstr "" -#: ../Doc/library/ipaddress.rst:163 +#: ../Doc/library/ipaddress.rst:164 msgid "" "``True`` if the address is reserved for multicast use. See :RFC:`3171` (for " "IPv4) or :RFC:`2373` (for IPv6)." msgstr "" -#: ../Doc/library/ipaddress.rst:168 +#: ../Doc/library/ipaddress.rst:169 msgid "" "``True`` if the address is allocated for private networks. See iana-ipv4-" "special-registry_ (for IPv4) or iana-ipv6-special-registry_ (for IPv6)." msgstr "" -#: ../Doc/library/ipaddress.rst:174 +#: ../Doc/library/ipaddress.rst:175 msgid "" "``True`` if the address is allocated for public networks. See iana-ipv4-" "special-registry_ (for IPv4) or iana-ipv6-special-registry_ (for IPv6)." msgstr "" -#: ../Doc/library/ipaddress.rst:182 +#: ../Doc/library/ipaddress.rst:183 msgid "" "``True`` if the address is unspecified. See :RFC:`5735` (for IPv4) or :RFC:" "`2373` (for IPv6)." msgstr "" -#: ../Doc/library/ipaddress.rst:187 +#: ../Doc/library/ipaddress.rst:188 msgid "``True`` if the address is otherwise IETF reserved." msgstr "" -#: ../Doc/library/ipaddress.rst:191 +#: ../Doc/library/ipaddress.rst:192 msgid "" "``True`` if this is a loopback address. See :RFC:`3330` (for IPv4) or :RFC:" "`2373` (for IPv6)." msgstr "" -#: ../Doc/library/ipaddress.rst:196 +#: ../Doc/library/ipaddress.rst:197 msgid "" "``True`` if the address is reserved for link-local usage. See :RFC:`3927`." msgstr "" -#: ../Doc/library/ipaddress.rst:205 +#: ../Doc/library/ipaddress.rst:206 msgid "" "Construct an IPv6 address. An :exc:`AddressValueError` is raised if " "*address* is not a valid IPv6 address." msgstr "" -#: ../Doc/library/ipaddress.rst:208 +#: ../Doc/library/ipaddress.rst:209 msgid "The following constitutes a valid IPv6 address:" msgstr "" -#: ../Doc/library/ipaddress.rst:210 +#: ../Doc/library/ipaddress.rst:211 msgid "" "A string consisting of eight groups of four hexadecimal digits, each group " "representing 16 bits. The groups are separated by colons. This describes an " @@ -246,43 +248,43 @@ msgid "" "to ``\"::abc:7:def\"``." msgstr "" -#: ../Doc/library/ipaddress.rst:217 +#: ../Doc/library/ipaddress.rst:218 msgid "An integer that fits into 128 bits." msgstr "" -#: ../Doc/library/ipaddress.rst:218 +#: ../Doc/library/ipaddress.rst:219 msgid "" "An integer packed into a :class:`bytes` object of length 16, big-endian." msgstr "" -#: ../Doc/library/ipaddress.rst:225 +#: ../Doc/library/ipaddress.rst:226 msgid "" "The short form of the address representation, with leading zeroes in groups " "omitted and the longest sequence of groups consisting entirely of zeroes " "collapsed to a single empty group." msgstr "" -#: ../Doc/library/ipaddress.rst:229 +#: ../Doc/library/ipaddress.rst:230 msgid "This is also the value returned by ``str(addr)`` for IPv6 addresses." msgstr "" -#: ../Doc/library/ipaddress.rst:233 +#: ../Doc/library/ipaddress.rst:234 msgid "" "The long form of the address representation, with all leading zeroes and " "groups consisting entirely of zeroes included." msgstr "" -#: ../Doc/library/ipaddress.rst:237 +#: ../Doc/library/ipaddress.rst:238 msgid "" -"For the following attributes, see the corresponding documention of the :" +"For the following attributes, see the corresponding documentation of the :" "class:`IPv4Address` class:" msgstr "" -#: ../Doc/library/ipaddress.rst:252 +#: ../Doc/library/ipaddress.rst:253 msgid "is_global" msgstr "" -#: ../Doc/library/ipaddress.rst:257 +#: ../Doc/library/ipaddress.rst:258 msgid "" "``True`` if the address is reserved for site-local usage. Note that the " "site-local address space has been deprecated by :RFC:`3879`. Use :attr:" @@ -290,14 +292,14 @@ msgid "" "local addresses as defined by :RFC:`4193`." msgstr "" -#: ../Doc/library/ipaddress.rst:264 +#: ../Doc/library/ipaddress.rst:265 msgid "" "For addresses that appear to be IPv4 mapped addresses (starting with ``::" "FFFF/96``), this property will report the embedded IPv4 address. For any " "other address, this property will be ``None``." msgstr "" -#: ../Doc/library/ipaddress.rst:270 +#: ../Doc/library/ipaddress.rst:271 msgid "" "For addresses that appear to be 6to4 addresses (starting with " "``2002::/16``) as defined by :RFC:`3056`, this property will report the " @@ -305,7 +307,7 @@ msgid "" "``None``." msgstr "" -#: ../Doc/library/ipaddress.rst:277 +#: ../Doc/library/ipaddress.rst:278 msgid "" "For addresses that appear to be Teredo addresses (starting with " "``2001::/32``) as defined by :RFC:`4380`, this property will report the " @@ -313,52 +315,53 @@ msgid "" "property will be ``None``." msgstr "" -#: ../Doc/library/ipaddress.rst:284 +#: ../Doc/library/ipaddress.rst:285 msgid "Conversion to Strings and Integers" msgstr "" -#: ../Doc/library/ipaddress.rst:286 +#: ../Doc/library/ipaddress.rst:287 msgid "" "To interoperate with networking interfaces such as the socket module, " "addresses must be converted to strings or integers. This is handled using " "the :func:`str` and :func:`int` builtin functions::" msgstr "" -#: ../Doc/library/ipaddress.rst:301 ../Doc/library/ipaddress.rst:631 +#: ../Doc/library/ipaddress.rst:302 ../Doc/library/ipaddress.rst:649 +#: ../Doc/library/ipaddress.rst:785 msgid "Operators" msgstr "Opérateurs" -#: ../Doc/library/ipaddress.rst:303 +#: ../Doc/library/ipaddress.rst:304 msgid "" "Address objects support some operators. Unless stated otherwise, operators " "can only be applied between compatible objects (i.e. IPv4 with IPv4, IPv6 " "with IPv6)." msgstr "" -#: ../Doc/library/ipaddress.rst:309 +#: ../Doc/library/ipaddress.rst:310 msgid "Comparison operators" msgstr "" -#: ../Doc/library/ipaddress.rst:311 +#: ../Doc/library/ipaddress.rst:312 msgid "" "Address objects can be compared with the usual set of comparison operators. " "Some examples::" msgstr "" -#: ../Doc/library/ipaddress.rst:323 +#: ../Doc/library/ipaddress.rst:324 msgid "Arithmetic operators" msgstr "" -#: ../Doc/library/ipaddress.rst:325 +#: ../Doc/library/ipaddress.rst:326 msgid "" "Integers can be added to or subtracted from address objects. Some examples::" msgstr "" -#: ../Doc/library/ipaddress.rst:338 +#: ../Doc/library/ipaddress.rst:339 msgid "IP Network definitions" msgstr "" -#: ../Doc/library/ipaddress.rst:340 +#: ../Doc/library/ipaddress.rst:341 msgid "" "The :class:`IPv4Network` and :class:`IPv6Network` objects provide a " "mechanism for defining and inspecting IP network definitions. A network " @@ -369,11 +372,11 @@ msgid "" "addresses in the inclusive range ``192.168.1.0`` to ``192.168.1.255``." msgstr "" -#: ../Doc/library/ipaddress.rst:350 +#: ../Doc/library/ipaddress.rst:351 msgid "Prefix, net mask and host mask" msgstr "" -#: ../Doc/library/ipaddress.rst:352 +#: ../Doc/library/ipaddress.rst:353 msgid "" "There are several equivalent ways to specify IP network masks. A *prefix* " "``/`` is a notation that denotes how many high-order bits are set in " @@ -385,55 +388,57 @@ msgid "" "mask equivalent to ``/24`` in IPv4 is ``0.0.0.255``." msgstr "" -#: ../Doc/library/ipaddress.rst:363 +#: ../Doc/library/ipaddress.rst:364 msgid "Network objects" msgstr "" -#: ../Doc/library/ipaddress.rst:365 +#: ../Doc/library/ipaddress.rst:366 msgid "" "All attributes implemented by address objects are implemented by network " "objects as well. In addition, network objects implement additional " "attributes. All of these are common between :class:`IPv4Network` and :class:" "`IPv6Network`, so to avoid duplication they are only documented for :class:" -"`IPv4Network`." +"`IPv4Network`. Network objects are :term:`hashable`, so they can be used as " +"keys in dictionaries." msgstr "" -#: ../Doc/library/ipaddress.rst:372 +#: ../Doc/library/ipaddress.rst:375 msgid "" "Construct an IPv4 network definition. *address* can be one of the following:" msgstr "" -#: ../Doc/library/ipaddress.rst:374 +#: ../Doc/library/ipaddress.rst:377 msgid "" "A string consisting of an IP address and an optional mask, separated by a " "slash (``/``). The IP address is the network address, and the mask can be " "either a single number, which means it's a *prefix*, or a string " "representation of an IPv4 address. If it's the latter, the mask is " "interpreted as a *net mask* if it starts with a non-zero field, or as a " -"*host mask* if it starts with a zero field. If no mask is provided, it's " -"considered to be ``/32``." +"*host mask* if it starts with a zero field, with the single exception of an " +"all-zero mask which is treated as a *net mask*. If no mask is provided, " +"it's considered to be ``/32``." msgstr "" -#: ../Doc/library/ipaddress.rst:382 +#: ../Doc/library/ipaddress.rst:386 msgid "" "For example, the following *address* specifications are equivalent: " "``192.168.1.0/24``, ``192.168.1.0/255.255.255.0`` and " "``192.168.1.0/0.0.0.255``." msgstr "" -#: ../Doc/library/ipaddress.rst:386 +#: ../Doc/library/ipaddress.rst:390 msgid "" "An integer that fits into 32 bits. This is equivalent to a single-address " "network, with the network address being *address* and the mask being ``/32``." msgstr "" -#: ../Doc/library/ipaddress.rst:390 +#: ../Doc/library/ipaddress.rst:394 msgid "" "An integer packed into a :class:`bytes` object of length 4, big-endian. The " "interpretation is similar to an integer *address*." msgstr "" -#: ../Doc/library/ipaddress.rst:393 +#: ../Doc/library/ipaddress.rst:397 msgid "" "A two-tuple of an address description and a netmask, where the address " "description is either a string, a 32-bits integer, a 4-bytes packed integer, " @@ -442,108 +447,114 @@ msgid "" "prefix mask (e.g. ``255.255.255.0``)." msgstr "" -#: ../Doc/library/ipaddress.rst:399 +#: ../Doc/library/ipaddress.rst:403 msgid "" "An :exc:`AddressValueError` is raised if *address* is not a valid IPv4 " "address. A :exc:`NetmaskValueError` is raised if the mask is not valid for " "an IPv4 address." msgstr "" -#: ../Doc/library/ipaddress.rst:403 ../Doc/library/ipaddress.rst:588 +#: ../Doc/library/ipaddress.rst:407 ../Doc/library/ipaddress.rst:599 msgid "" "If *strict* is ``True`` and host bits are set in the supplied address, then :" "exc:`ValueError` is raised. Otherwise, the host bits are masked out to " "determine the appropriate network address." msgstr "" -#: ../Doc/library/ipaddress.rst:407 +#: ../Doc/library/ipaddress.rst:411 msgid "" "Unless stated otherwise, all network methods accepting other network/address " "objects will raise :exc:`TypeError` if the argument's IP version is " -"incompatible to ``self``" +"incompatible to ``self``." msgstr "" -#: ../Doc/library/ipaddress.rst:413 ../Doc/library/ipaddress.rst:594 +#: ../Doc/library/ipaddress.rst:417 ../Doc/library/ipaddress.rst:605 msgid "Added the two-tuple form for the *address* constructor parameter." msgstr "" -#: ../Doc/library/ipaddress.rst:418 +#: ../Doc/library/ipaddress.rst:422 msgid "" -"Refer to the corresponding attribute documentation in :class:`IPv4Address`" +"Refer to the corresponding attribute documentation in :class:`IPv4Address`." msgstr "" -#: ../Doc/library/ipaddress.rst:428 +#: ../Doc/library/ipaddress.rst:432 msgid "" "These attributes are true for the network as a whole if they are true for " -"both the network address and the broadcast address" +"both the network address and the broadcast address." msgstr "" -#: ../Doc/library/ipaddress.rst:433 +#: ../Doc/library/ipaddress.rst:437 msgid "" "The network address for the network. The network address and the prefix " "length together uniquely define a network." msgstr "" -#: ../Doc/library/ipaddress.rst:438 +#: ../Doc/library/ipaddress.rst:442 msgid "" "The broadcast address for the network. Packets sent to the broadcast address " "should be received by every host on the network." msgstr "" -#: ../Doc/library/ipaddress.rst:443 -msgid "The host mask, as a string." +#: ../Doc/library/ipaddress.rst:447 +msgid "The host mask, as an :class:`IPv4Address` object." msgstr "" -#: ../Doc/library/ipaddress.rst:449 +#: ../Doc/library/ipaddress.rst:451 +msgid "The net mask, as an :class:`IPv4Address` object." +msgstr "" + +#: ../Doc/library/ipaddress.rst:457 msgid "" "A string representation of the network, with the mask in prefix notation." msgstr "" -#: ../Doc/library/ipaddress.rst:452 +#: ../Doc/library/ipaddress.rst:460 msgid "" "``with_prefixlen`` and ``compressed`` are always the same as " "``str(network)``. ``exploded`` uses the exploded form the network address." msgstr "" -#: ../Doc/library/ipaddress.rst:458 +#: ../Doc/library/ipaddress.rst:466 msgid "" "A string representation of the network, with the mask in net mask notation." msgstr "" -#: ../Doc/library/ipaddress.rst:463 +#: ../Doc/library/ipaddress.rst:471 msgid "" "A string representation of the network, with the mask in host mask notation." msgstr "" -#: ../Doc/library/ipaddress.rst:468 +#: ../Doc/library/ipaddress.rst:476 msgid "The total number of addresses in the network." msgstr "" -#: ../Doc/library/ipaddress.rst:472 +#: ../Doc/library/ipaddress.rst:480 msgid "Length of the network prefix, in bits." msgstr "" -#: ../Doc/library/ipaddress.rst:476 +#: ../Doc/library/ipaddress.rst:484 msgid "" "Returns an iterator over the usable hosts in the network. The usable hosts " "are all the IP addresses that belong to the network, except the network " -"address itself and the network broadcast address." +"address itself and the network broadcast address. For networks with a mask " +"length of 31, the network address and network broadcast address are also " +"included in the result." msgstr "" -#: ../Doc/library/ipaddress.rst:487 +#: ../Doc/library/ipaddress.rst:499 msgid "" "``True`` if this network is partly or wholly contained in *other* or *other* " "is wholly contained in this network." msgstr "" -#: ../Doc/library/ipaddress.rst:492 +#: ../Doc/library/ipaddress.rst:504 msgid "" "Computes the network definitions resulting from removing the given *network* " "from this one. Returns an iterator of network objects. Raises :exc:" "`ValueError` if *network* is not completely contained in this network." msgstr "" -#: ../Doc/library/ipaddress.rst:505 +#: ../Doc/library/ipaddress.rst:517 msgid "" "The subnets that join to make the current network definition, depending on " "the argument values. *prefixlen_diff* is the amount our prefix length " @@ -553,7 +564,7 @@ msgid "" "network objects." msgstr "" -#: ../Doc/library/ipaddress.rst:530 +#: ../Doc/library/ipaddress.rst:542 msgid "" "The supernet containing this network definition, depending on the argument " "values. *prefixlen_diff* is the amount our prefix length should be " @@ -562,48 +573,46 @@ msgid "" "*new_prefix* must be set. Returns a single network object." msgstr "" -#: ../Doc/library/ipaddress.rst:546 +#: ../Doc/library/ipaddress.rst:558 msgid "" "Compare this network to *other*. In this comparison only the network " "addresses are considered; host bits aren't. Returns either ``-1``, ``0`` or " "``1``." msgstr "" -#: ../Doc/library/ipaddress.rst:560 +#: ../Doc/library/ipaddress.rst:572 msgid "" "Construct an IPv6 network definition. *address* can be one of the following:" msgstr "" -#: ../Doc/library/ipaddress.rst:562 +#: ../Doc/library/ipaddress.rst:574 msgid "" -"A string consisting of an IP address and an optional mask, separated by a " -"slash (``/``). The IP address is the network address, and the mask can be " -"either a single number, which means it's a *prefix*, or a string " -"representation of an IPv6 address. If it's the latter, the mask is " -"interpreted as a *net mask*. If no mask is provided, it's considered to be " -"``/128``." +"A string consisting of an IP address and an optional prefix length, " +"separated by a slash (``/``). The IP address is the network address, and " +"the prefix length must be a single number, the *prefix*. If no prefix " +"length is provided, it's considered to be ``/128``." msgstr "" -#: ../Doc/library/ipaddress.rst:569 +#: ../Doc/library/ipaddress.rst:579 msgid "" -"For example, the following *address* specifications are equivalent: ``2001:" -"db00::0/24`` and ``2001:db00::0/ffff:ff00::``." +"Note that currently expanded netmasks are not supported. That means ``2001:" +"db00::0/24`` is a valid argument while ``2001:db00::0/ffff:ff00::`` not." msgstr "" -#: ../Doc/library/ipaddress.rst:572 +#: ../Doc/library/ipaddress.rst:583 msgid "" "An integer that fits into 128 bits. This is equivalent to a single-address " "network, with the network address being *address* and the mask being " "``/128``." msgstr "" -#: ../Doc/library/ipaddress.rst:576 +#: ../Doc/library/ipaddress.rst:587 msgid "" "An integer packed into a :class:`bytes` object of length 16, big-endian. The " "interpretation is similar to an integer *address*." msgstr "" -#: ../Doc/library/ipaddress.rst:579 +#: ../Doc/library/ipaddress.rst:590 msgid "" "A two-tuple of an address description and a netmask, where the address " "description is either a string, a 128-bits integer, a 16-bytes packed " @@ -611,129 +620,171 @@ msgid "" "representing the prefix length." msgstr "" -#: ../Doc/library/ipaddress.rst:584 +#: ../Doc/library/ipaddress.rst:595 msgid "" "An :exc:`AddressValueError` is raised if *address* is not a valid IPv6 " "address. A :exc:`NetmaskValueError` is raised if the mask is not valid for " "an IPv6 address." msgstr "" -#: ../Doc/library/ipaddress.rst:621 +#: ../Doc/library/ipaddress.rst:628 msgid "" -"Refer to the corresponding attribute documentation in :class:`IPv4Network`" +"Returns an iterator over the usable hosts in the network. The usable hosts " +"are all the IP addresses that belong to the network, except the Subnet-" +"Router anycast address. For networks with a mask length of 127, the Subnet-" +"Router anycast address is also included in the result." msgstr "" -#: ../Doc/library/ipaddress.rst:626 +#: ../Doc/library/ipaddress.rst:639 +msgid "" +"Refer to the corresponding attribute documentation in :class:`IPv4Network`." +msgstr "" + +#: ../Doc/library/ipaddress.rst:644 msgid "" "These attribute is true for the network as a whole if it is true for both " -"the network address and the broadcast address" +"the network address and the broadcast address." msgstr "" -#: ../Doc/library/ipaddress.rst:633 +#: ../Doc/library/ipaddress.rst:651 msgid "" "Network objects support some operators. Unless stated otherwise, operators " "can only be applied between compatible objects (i.e. IPv4 with IPv4, IPv6 " "with IPv6)." msgstr "" -#: ../Doc/library/ipaddress.rst:639 +#: ../Doc/library/ipaddress.rst:657 ../Doc/library/ipaddress.rst:793 msgid "Logical operators" msgstr "" -#: ../Doc/library/ipaddress.rst:641 +#: ../Doc/library/ipaddress.rst:659 msgid "" -"Network objects can be compared with the usual set of logical operators, " -"similarly to address objects." +"Network objects can be compared with the usual set of logical operators. " +"Network objects are ordered first by network address, then by net mask." msgstr "" -#: ../Doc/library/ipaddress.rst:646 +#: ../Doc/library/ipaddress.rst:664 msgid "Iteration" msgstr "" -#: ../Doc/library/ipaddress.rst:648 +#: ../Doc/library/ipaddress.rst:666 msgid "" "Network objects can be iterated to list all the addresses belonging to the " "network. For iteration, *all* hosts are returned, including unusable hosts " "(for usable hosts, use the :meth:`~IPv4Network.hosts` method). An example::" msgstr "" -#: ../Doc/library/ipaddress.rst:675 +#: ../Doc/library/ipaddress.rst:693 msgid "Networks as containers of addresses" msgstr "" -#: ../Doc/library/ipaddress.rst:677 +#: ../Doc/library/ipaddress.rst:695 msgid "Network objects can act as containers of addresses. Some examples::" msgstr "" -#: ../Doc/library/ipaddress.rst:690 +#: ../Doc/library/ipaddress.rst:708 msgid "Interface objects" msgstr "" -#: ../Doc/library/ipaddress.rst:694 +#: ../Doc/library/ipaddress.rst:710 +msgid "" +"Interface objects are :term:`hashable`, so they can be used as keys in " +"dictionaries." +msgstr "" + +#: ../Doc/library/ipaddress.rst:715 msgid "" "Construct an IPv4 interface. The meaning of *address* is as in the " "constructor of :class:`IPv4Network`, except that arbitrary host addresses " "are always accepted." msgstr "" -#: ../Doc/library/ipaddress.rst:698 +#: ../Doc/library/ipaddress.rst:719 msgid "" ":class:`IPv4Interface` is a subclass of :class:`IPv4Address`, so it inherits " "all the attributes from that class. In addition, the following attributes " "are available:" msgstr "" -#: ../Doc/library/ipaddress.rst:704 +#: ../Doc/library/ipaddress.rst:725 msgid "The address (:class:`IPv4Address`) without network information." msgstr "" -#: ../Doc/library/ipaddress.rst:712 +#: ../Doc/library/ipaddress.rst:733 msgid "The network (:class:`IPv4Network`) this interface belongs to." msgstr "" -#: ../Doc/library/ipaddress.rst:720 +#: ../Doc/library/ipaddress.rst:741 msgid "" "A string representation of the interface with the mask in prefix notation." msgstr "" -#: ../Doc/library/ipaddress.rst:728 +#: ../Doc/library/ipaddress.rst:749 msgid "" "A string representation of the interface with the network as a net mask." msgstr "" -#: ../Doc/library/ipaddress.rst:736 +#: ../Doc/library/ipaddress.rst:757 msgid "" "A string representation of the interface with the network as a host mask." msgstr "" -#: ../Doc/library/ipaddress.rst:745 +#: ../Doc/library/ipaddress.rst:766 msgid "" "Construct an IPv6 interface. The meaning of *address* is as in the " "constructor of :class:`IPv6Network`, except that arbitrary host addresses " "are always accepted." msgstr "" -#: ../Doc/library/ipaddress.rst:749 +#: ../Doc/library/ipaddress.rst:770 msgid "" ":class:`IPv6Interface` is a subclass of :class:`IPv6Address`, so it inherits " "all the attributes from that class. In addition, the following attributes " "are available:" msgstr "" -#: ../Doc/library/ipaddress.rst:759 +#: ../Doc/library/ipaddress.rst:780 msgid "" "Refer to the corresponding attribute documentation in :class:`IPv4Interface`." msgstr "" -#: ../Doc/library/ipaddress.rst:764 +#: ../Doc/library/ipaddress.rst:787 +msgid "" +"Interface objects support some operators. Unless stated otherwise, " +"operators can only be applied between compatible objects (i.e. IPv4 with " +"IPv4, IPv6 with IPv6)." +msgstr "" + +#: ../Doc/library/ipaddress.rst:795 +msgid "" +"Interface objects can be compared with the usual set of logical operators." +msgstr "" + +#: ../Doc/library/ipaddress.rst:797 +msgid "" +"For equality comparison (``==`` and ``!=``), both the IP address and network " +"must be the same for the objects to be equal. An interface will not compare " +"equal to any address or network object." +msgstr "" + +#: ../Doc/library/ipaddress.rst:801 +msgid "" +"For ordering (``<``, ``>``, etc) the rules are different. Interface and " +"address objects with the same IP version can be compared, and the address " +"objects will always sort before the interface objects. Two interface " +"objects are first compared by their networks and, if those are the same, " +"then by their IP addresses." +msgstr "" + +#: ../Doc/library/ipaddress.rst:809 msgid "Other Module Level Functions" msgstr "" -#: ../Doc/library/ipaddress.rst:766 +#: ../Doc/library/ipaddress.rst:811 msgid "The module also provides the following module level functions:" msgstr "" -#: ../Doc/library/ipaddress.rst:770 +#: ../Doc/library/ipaddress.rst:815 msgid "" "Represent an address as 4 packed bytes in network (big-endian) order. " "*address* is an integer representation of an IPv4 IP address. A :exc:" @@ -741,7 +792,7 @@ msgid "" "IP address." msgstr "" -#: ../Doc/library/ipaddress.rst:783 +#: ../Doc/library/ipaddress.rst:828 msgid "" "Represent an address as 16 packed bytes in network (big-endian) order. " "*address* is an integer representation of an IPv6 IP address. A :exc:" @@ -749,7 +800,7 @@ msgid "" "IP address." msgstr "" -#: ../Doc/library/ipaddress.rst:791 +#: ../Doc/library/ipaddress.rst:836 msgid "" "Return an iterator of the summarized network range given the first and last " "IP addresses. *first* is the first :class:`IPv4Address` or :class:" @@ -760,7 +811,7 @@ msgid "" "address version is not 4 or 6." msgstr "" -#: ../Doc/library/ipaddress.rst:807 +#: ../Doc/library/ipaddress.rst:852 msgid "" "Return an iterator of the collapsed :class:`IPv4Network` or :class:" "`IPv6Network` objects. *addresses* is an iterator of :class:`IPv4Network` " @@ -768,38 +819,38 @@ msgid "" "*addresses* contains mixed version objects." msgstr "" -#: ../Doc/library/ipaddress.rst:820 +#: ../Doc/library/ipaddress.rst:865 msgid "" "Return a key suitable for sorting between networks and addresses. Address " "and Network objects are not sortable by default; they're fundamentally " "different, so the expression::" msgstr "" -#: ../Doc/library/ipaddress.rst:826 +#: ../Doc/library/ipaddress.rst:871 msgid "" "doesn't make sense. There are some times however, where you may wish to " "have :mod:`ipaddress` sort these anyway. If you need to do this, you can " -"use this function as the ``key`` argument to :func:`sorted()`." +"use this function as the *key* argument to :func:`sorted()`." msgstr "" -#: ../Doc/library/ipaddress.rst:830 +#: ../Doc/library/ipaddress.rst:875 msgid "*obj* is either a network or address object." msgstr "" -#: ../Doc/library/ipaddress.rst:834 +#: ../Doc/library/ipaddress.rst:879 msgid "Custom Exceptions" msgstr "" -#: ../Doc/library/ipaddress.rst:836 +#: ../Doc/library/ipaddress.rst:881 msgid "" "To support more specific error reporting from class constructors, the module " "defines the following exceptions:" msgstr "" -#: ../Doc/library/ipaddress.rst:841 +#: ../Doc/library/ipaddress.rst:886 msgid "Any value error related to the address." msgstr "" -#: ../Doc/library/ipaddress.rst:846 -msgid "Any value error related to the netmask." +#: ../Doc/library/ipaddress.rst:891 +msgid "Any value error related to the net mask." msgstr "" diff --git a/library/math.po b/library/math.po index 344c342b..6a0559aa 100644 --- a/library/math.po +++ b/library/math.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-05-27 19:40+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2017-09-24 20:20+0200\n" "Last-Translator: Julien Palard \n" "Language-Team: \n" @@ -291,9 +291,11 @@ msgstr "" "le signe de *x* et sont flottants." #: ../Doc/library/math.rst:180 +#, fuzzy msgid "" "Return the :class:`~numbers.Real` value *x* truncated to an :class:`~numbers." -"Integral` (usually an integer). Delegates to ``x.__trunc__()``." +"Integral` (usually an integer). Delegates to :meth:`x.__trunc__() `." msgstr "" "Renvoie la valeur :class:`~numbers.Real` *x* tronquée en un :class:`~numbers." "Integral` (habituellement un entier). Délègue à ``x.__trunc()__``." diff --git a/library/platform.po b/library/platform.po index 15bb06f4..2bcbb6d4 100644 --- a/library/platform.po +++ b/library/platform.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-04-02 22:11+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -304,10 +304,6 @@ msgstr "" msgid "This is another name for :func:`linux_distribution`." msgstr "" -#: ../Doc/library/platform.rst:251 ../Doc/library/platform.rst:269 -msgid "Deprecated since version 3.5, will be removed in version 3.7." -msgstr "" - #: ../Doc/library/platform.rst:255 msgid "Tries to determine the name of the Linux OS distribution name." msgstr "" diff --git a/library/re.po b/library/re.po index 1bfc66a7..526da2b9 100644 --- a/library/re.po +++ b/library/re.po @@ -5,7 +5,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-01-04 15:51+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2018-02-15 00:47+0100\n" "Last-Translator: Julien Palard \n" "Language-Team: \n" @@ -1644,17 +1644,6 @@ msgstr "" "Les séquences d'échappement inconnues dans *pattern* formées par ``'\\'`` et " "une lettre ASCII sont maintenant des erreurs." -#: ../Doc/library/re.rst:805 -msgid "" -"Deprecated since version 3.5, will be removed in version 3.7: Unknown " -"escapes in repl consisting of '\\' and an ASCII letter now raise a " -"deprecation warning and will be forbidden in Python 3.7." -msgstr "" -"Déprécié depuis la version 3.5, sera supprimé dans la 3.7 : Les séquences " -"d'échappement dans *repl* formées d'un '\\' et d'une lettre ASCII lèvent " -"maintenant un avertissement de dépréciation et seront interdites en Python " -"3.7." - #: ../Doc/library/re.rst:805 msgid "" "Unknown escapes in *repl* consisting of ``'\\'`` and an ASCII letter now " @@ -2488,6 +2477,16 @@ msgstr "" msgid "The tokenizer produces the following output::" msgstr "L'analyseur produit la sortie suivante : ::" +#~ msgid "" +#~ "Deprecated since version 3.5, will be removed in version 3.7: Unknown " +#~ "escapes in repl consisting of '\\' and an ASCII letter now raise a " +#~ "deprecation warning and will be forbidden in Python 3.7." +#~ msgstr "" +#~ "Déprécié depuis la version 3.5, sera supprimé dans la 3.7 : Les séquences " +#~ "d'échappement dans *repl* formées d'un '\\' et d'une lettre ASCII lèvent " +#~ "maintenant un avertissement de dépréciation et seront interdites en " +#~ "Python 3.7." + #~ msgid "``'.'``" #~ msgstr "``'.'``" diff --git a/library/socket.po b/library/socket.po index 6903e8d4..34ad15f0 100644 --- a/library/socket.po +++ b/library/socket.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-10-13 22:28+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -99,8 +99,8 @@ msgid "" "Previously, :const:`AF_UNIX` socket paths were assumed to use UTF-8 encoding." msgstr "" -#: ../Doc/library/socket.rst:63 ../Doc/library/socket.rst:715 -#: ../Doc/library/socket.rst:757 ../Doc/library/socket.rst:1399 +#: ../Doc/library/socket.rst:63 ../Doc/library/socket.rst:719 +#: ../Doc/library/socket.rst:761 ../Doc/library/socket.rst:1403 msgid "Writable :term:`bytes-like object` is now accepted." msgstr "N'importe quel :term:`bytes-like object` est maintenant accepté." @@ -400,104 +400,110 @@ msgid "" "``TCP_USER_TIMEOUT``, ``TCP_CONGESTION`` were added." msgstr "" -#: ../Doc/library/socket.rst:311 ../Doc/library/socket.rst:346 +#: ../Doc/library/socket.rst:306 +msgid "" +"On Windows, ``TCP_FASTOPEN``, ``TCP_KEEPCNT`` appear if run-time Windows " +"supports." +msgstr "" + +#: ../Doc/library/socket.rst:315 ../Doc/library/socket.rst:350 msgid "" "Many constants of these forms, documented in the Linux documentation, are " "also defined in the socket module." msgstr "" -#: ../Doc/library/socket.rst:314 ../Doc/library/socket.rst:325 +#: ../Doc/library/socket.rst:318 ../Doc/library/socket.rst:329 msgid "Availability: Linux >= 2.6.25." msgstr "" -#: ../Doc/library/socket.rst:321 +#: ../Doc/library/socket.rst:325 msgid "" "CAN_BCM, in the CAN protocol family, is the broadcast manager (BCM) " "protocol. Broadcast manager constants, documented in the Linux " "documentation, are also defined in the socket module." msgstr "" -#: ../Doc/library/socket.rst:331 +#: ../Doc/library/socket.rst:335 msgid "" "Enables CAN FD support in a CAN_RAW socket. This is disabled by default. " "This allows your application to send both CAN and CAN FD frames; however, " "you one must accept both CAN and CAN FD frames when reading from the socket." msgstr "" -#: ../Doc/library/socket.rst:335 +#: ../Doc/library/socket.rst:339 msgid "This constant is documented in the Linux documentation." msgstr "" -#: ../Doc/library/socket.rst:337 +#: ../Doc/library/socket.rst:341 msgid "Availability: Linux >= 3.6." msgstr "" -#: ../Doc/library/socket.rst:349 +#: ../Doc/library/socket.rst:353 msgid "Availability: Linux >= 2.6.30." msgstr "" -#: ../Doc/library/socket.rst:359 +#: ../Doc/library/socket.rst:363 msgid "" "Constants for Windows' WSAIoctl(). The constants are used as arguments to " "the :meth:`~socket.socket.ioctl` method of socket objects." msgstr "" -#: ../Doc/library/socket.rst:362 ../Doc/library/socket.rst:1039 +#: ../Doc/library/socket.rst:366 ../Doc/library/socket.rst:1043 msgid "``SIO_LOOPBACK_FAST_PATH`` was added." msgstr "" -#: ../Doc/library/socket.rst:368 +#: ../Doc/library/socket.rst:372 msgid "" "TIPC related constants, matching the ones exported by the C socket API. See " "the TIPC documentation for more information." msgstr "" -#: ../Doc/library/socket.rst:375 +#: ../Doc/library/socket.rst:379 msgid "Constants for Linux Kernel cryptography." msgstr "" -#: ../Doc/library/socket.rst:377 +#: ../Doc/library/socket.rst:381 msgid "Availability: Linux >= 2.6.38." msgstr "" -#: ../Doc/library/socket.rst:383 +#: ../Doc/library/socket.rst:387 msgid "Availability: BSD, OSX." msgstr "" -#: ../Doc/library/socket.rst:389 +#: ../Doc/library/socket.rst:393 msgid "" "This constant contains a boolean value which indicates if IPv6 is supported " "on this platform." msgstr "" -#: ../Doc/library/socket.rst:395 +#: ../Doc/library/socket.rst:399 msgid "" "These are string constants containing Bluetooth addresses with special " "meanings. For example, :const:`BDADDR_ANY` can be used to indicate any " "address when specifying the binding socket with :const:`BTPROTO_RFCOMM`." msgstr "" -#: ../Doc/library/socket.rst:404 +#: ../Doc/library/socket.rst:408 msgid "" "For use with :const:`BTPROTO_HCI`. :const:`HCI_FILTER` is not available for " "NetBSD or DragonFlyBSD. :const:`HCI_TIME_STAMP` and :const:`HCI_DATA_DIR` " "are not available for FreeBSD, NetBSD, or DragonFlyBSD." msgstr "" -#: ../Doc/library/socket.rst:410 +#: ../Doc/library/socket.rst:414 msgid "Functions" msgstr "Fonctions" -#: ../Doc/library/socket.rst:413 +#: ../Doc/library/socket.rst:417 msgid "Creating sockets" msgstr "" -#: ../Doc/library/socket.rst:415 +#: ../Doc/library/socket.rst:419 msgid "" "The following functions all create :ref:`socket objects `." msgstr "" -#: ../Doc/library/socket.rst:420 +#: ../Doc/library/socket.rst:424 msgid "" "Create a new socket using the given address family, socket type and protocol " "number. The address family should be :const:`AF_INET` (the default), :const:" @@ -513,26 +519,26 @@ msgid "" "meth:`socket.close()`." msgstr "" -#: ../Doc/library/socket.rst:433 ../Doc/library/socket.rst:500 -#: ../Doc/library/socket.rst:883 ../Doc/library/socket.rst:966 +#: ../Doc/library/socket.rst:437 ../Doc/library/socket.rst:504 +#: ../Doc/library/socket.rst:887 ../Doc/library/socket.rst:970 msgid "The newly created socket is :ref:`non-inheritable `." msgstr "" "Il n'est :ref:`pas possible d'hériter ` de la *socket* " "nouvellement créé." -#: ../Doc/library/socket.rst:435 +#: ../Doc/library/socket.rst:439 msgid "The AF_CAN family was added. The AF_RDS family was added." msgstr "" -#: ../Doc/library/socket.rst:439 +#: ../Doc/library/socket.rst:443 msgid "The CAN_BCM protocol was added." msgstr "" -#: ../Doc/library/socket.rst:442 ../Doc/library/socket.rst:502 +#: ../Doc/library/socket.rst:446 ../Doc/library/socket.rst:506 msgid "The returned socket is now non-inheritable." msgstr "" -#: ../Doc/library/socket.rst:448 +#: ../Doc/library/socket.rst:452 msgid "" "Build a pair of connected socket objects using the given address family, " "socket type, and protocol number. Address family, socket type, and protocol " @@ -541,25 +547,25 @@ msgid "" "`AF_INET`." msgstr "" -#: ../Doc/library/socket.rst:453 +#: ../Doc/library/socket.rst:457 msgid "The newly created sockets are :ref:`non-inheritable `." msgstr "" -#: ../Doc/library/socket.rst:455 +#: ../Doc/library/socket.rst:459 msgid "" "The returned socket objects now support the whole socket API, rather than a " "subset." msgstr "" -#: ../Doc/library/socket.rst:459 +#: ../Doc/library/socket.rst:463 msgid "The returned sockets are now non-inheritable." msgstr "" -#: ../Doc/library/socket.rst:462 +#: ../Doc/library/socket.rst:466 msgid "Windows support added." msgstr "" -#: ../Doc/library/socket.rst:468 +#: ../Doc/library/socket.rst:472 msgid "" "Connect to a TCP service listening on the Internet *address* (a 2-tuple " "``(host, port)``), and return the socket object. This is a higher-level " @@ -570,25 +576,25 @@ msgid "" "IPv4 and IPv6." msgstr "" -#: ../Doc/library/socket.rst:476 +#: ../Doc/library/socket.rst:480 msgid "" "Passing the optional *timeout* parameter will set the timeout on the socket " "instance before attempting to connect. If no *timeout* is supplied, the " "global default timeout setting returned by :func:`getdefaulttimeout` is used." msgstr "" -#: ../Doc/library/socket.rst:481 +#: ../Doc/library/socket.rst:485 msgid "" "If supplied, *source_address* must be a 2-tuple ``(host, port)`` for the " "socket to bind to as its source address before connecting. If host or port " "are '' or 0 respectively the OS default behavior will be used." msgstr "" -#: ../Doc/library/socket.rst:485 +#: ../Doc/library/socket.rst:489 msgid "*source_address* was added." msgstr "" -#: ../Doc/library/socket.rst:491 +#: ../Doc/library/socket.rst:495 msgid "" "Duplicate the file descriptor *fd* (an integer as returned by a file " "object's :meth:`fileno` method) and build a socket object from the result. " @@ -601,31 +607,31 @@ msgid "" "socket is assumed to be in blocking mode." msgstr "" -#: ../Doc/library/socket.rst:508 +#: ../Doc/library/socket.rst:512 msgid "" "Instantiate a socket from data obtained from the :meth:`socket.share` " "method. The socket is assumed to be in blocking mode." msgstr "" -#: ../Doc/library/socket.rst:511 ../Doc/library/socket.rst:1423 +#: ../Doc/library/socket.rst:515 ../Doc/library/socket.rst:1427 msgid "Availability: Windows." msgstr "Disponibilité : Windows." -#: ../Doc/library/socket.rst:518 +#: ../Doc/library/socket.rst:522 msgid "" "This is a Python type object that represents the socket object type. It is " "the same as ``type(socket(...))``." msgstr "" -#: ../Doc/library/socket.rst:523 +#: ../Doc/library/socket.rst:527 msgid "Other functions" msgstr "" -#: ../Doc/library/socket.rst:525 +#: ../Doc/library/socket.rst:529 msgid "The :mod:`socket` module also offers various network-related services:" msgstr "" -#: ../Doc/library/socket.rst:530 +#: ../Doc/library/socket.rst:534 msgid "" "Translate the *host*/*port* argument into a sequence of 5-tuples that " "contain all the necessary arguments for creating a socket connected to that " @@ -635,7 +641,7 @@ msgid "" "and *port*, you can pass ``NULL`` to the underlying C API." msgstr "" -#: ../Doc/library/socket.rst:537 +#: ../Doc/library/socket.rst:541 msgid "" "The *family*, *type* and *proto* arguments can be optionally specified in " "order to narrow the list of addresses returned. Passing zero as a value for " @@ -646,15 +652,15 @@ msgid "" "domain name." msgstr "" -#: ../Doc/library/socket.rst:545 +#: ../Doc/library/socket.rst:549 msgid "The function returns a list of 5-tuples with the following structure:" msgstr "" -#: ../Doc/library/socket.rst:547 +#: ../Doc/library/socket.rst:551 msgid "``(family, type, proto, canonname, sockaddr)``" msgstr "" -#: ../Doc/library/socket.rst:549 +#: ../Doc/library/socket.rst:553 msgid "" "In these tuples, *family*, *type*, *proto* are all integers and are meant to " "be passed to the :func:`.socket` function. *canonname* will be a string " @@ -666,18 +672,18 @@ msgid "" "be passed to the :meth:`socket.connect` method." msgstr "" -#: ../Doc/library/socket.rst:559 +#: ../Doc/library/socket.rst:563 msgid "" "The following example fetches address information for a hypothetical TCP " "connection to ``example.org`` on port 80 (results may differ on your system " "if IPv6 isn't enabled)::" msgstr "" -#: ../Doc/library/socket.rst:569 +#: ../Doc/library/socket.rst:573 msgid "parameters can now be passed using keyword arguments." msgstr "" -#: ../Doc/library/socket.rst:574 +#: ../Doc/library/socket.rst:578 msgid "" "Return a fully qualified domain name for *name*. If *name* is omitted or " "empty, it is interpreted as the local host. To find the fully qualified " @@ -687,7 +693,7 @@ msgid "" "hostname as returned by :func:`gethostname` is returned." msgstr "" -#: ../Doc/library/socket.rst:584 +#: ../Doc/library/socket.rst:588 msgid "" "Translate a host name to IPv4 address format. The IPv4 address is returned " "as a string, such as ``'100.50.200.5'``. If the host name is an IPv4 " @@ -697,7 +703,7 @@ msgid "" "stack support." msgstr "" -#: ../Doc/library/socket.rst:593 +#: ../Doc/library/socket.rst:597 msgid "" "Translate a host name to IPv4 address format, extended interface. Return a " "triple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the primary " @@ -709,19 +715,19 @@ msgid "" "IPv4/v6 dual stack support." msgstr "" -#: ../Doc/library/socket.rst:605 +#: ../Doc/library/socket.rst:609 msgid "" "Return a string containing the hostname of the machine where the Python " "interpreter is currently executing." msgstr "" -#: ../Doc/library/socket.rst:608 +#: ../Doc/library/socket.rst:612 msgid "" "Note: :func:`gethostname` doesn't always return the fully qualified domain " "name; use :func:`getfqdn` for that." msgstr "" -#: ../Doc/library/socket.rst:614 +#: ../Doc/library/socket.rst:618 msgid "" "Return a triple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is " "the primary host name responding to the given *ip_address*, *aliaslist* is a " @@ -732,7 +738,7 @@ msgid "" "`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" -#: ../Doc/library/socket.rst:625 +#: ../Doc/library/socket.rst:629 msgid "" "Translate a socket address *sockaddr* into a 2-tuple ``(host, port)``. " "Depending on the settings of *flags*, the result can contain a fully-" @@ -740,7 +746,7 @@ msgid "" "Similarly, *port* can contain a string port name or a numeric port number." msgstr "" -#: ../Doc/library/socket.rst:633 +#: ../Doc/library/socket.rst:637 msgid "" "Translate an Internet protocol name (for example, ``'icmp'``) to a constant " "suitable for passing as the (optional) third argument to the :func:`.socket` " @@ -749,49 +755,49 @@ msgid "" "chosen automatically if the protocol is omitted or zero." msgstr "" -#: ../Doc/library/socket.rst:642 +#: ../Doc/library/socket.rst:646 msgid "" "Translate an Internet service name and protocol name to a port number for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" -#: ../Doc/library/socket.rst:649 +#: ../Doc/library/socket.rst:653 msgid "" "Translate an Internet port number and protocol name to a service name for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" -#: ../Doc/library/socket.rst:656 +#: ../Doc/library/socket.rst:660 msgid "" "Convert 32-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" -#: ../Doc/library/socket.rst:663 +#: ../Doc/library/socket.rst:667 msgid "" "Convert 16-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" -#: ../Doc/library/socket.rst:670 +#: ../Doc/library/socket.rst:674 msgid "" "Convert 32-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" -#: ../Doc/library/socket.rst:677 +#: ../Doc/library/socket.rst:681 msgid "" "Convert 16-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" -#: ../Doc/library/socket.rst:684 +#: ../Doc/library/socket.rst:688 msgid "" "Convert an IPv4 address from dotted-quad string format (for example, " "'123.45.67.89') to 32-bit packed binary format, as a bytes object four " @@ -801,26 +807,26 @@ msgid "" "returns." msgstr "" -#: ../Doc/library/socket.rst:690 +#: ../Doc/library/socket.rst:694 msgid "" ":func:`inet_aton` also accepts strings with less than three dots; see the " "Unix manual page :manpage:`inet(3)` for details." msgstr "" -#: ../Doc/library/socket.rst:693 +#: ../Doc/library/socket.rst:697 msgid "" "If the IPv4 address string passed to this function is invalid, :exc:" "`OSError` will be raised. Note that exactly what is valid depends on the " "underlying C implementation of :c:func:`inet_aton`." msgstr "" -#: ../Doc/library/socket.rst:697 +#: ../Doc/library/socket.rst:701 msgid "" ":func:`inet_aton` does not support IPv6, and :func:`inet_pton` should be " "used instead for IPv4/v6 dual stack support." msgstr "" -#: ../Doc/library/socket.rst:703 +#: ../Doc/library/socket.rst:707 msgid "" "Convert a 32-bit packed IPv4 address (a :term:`bytes-like object` four bytes " "in length) to its standard dotted-quad string representation (for example, " @@ -830,7 +836,7 @@ msgid "" "an argument." msgstr "" -#: ../Doc/library/socket.rst:710 +#: ../Doc/library/socket.rst:714 msgid "" "If the byte sequence passed to this function is not exactly 4 bytes in " "length, :exc:`OSError` will be raised. :func:`inet_ntoa` does not support " @@ -838,7 +844,7 @@ msgid "" "support." msgstr "" -#: ../Doc/library/socket.rst:721 +#: ../Doc/library/socket.rst:725 msgid "" "Convert an IP address from its family-specific string format to a packed, " "binary format. :func:`inet_pton` is useful when a library or network " @@ -846,7 +852,7 @@ msgid "" "func:`inet_aton`) or :c:type:`struct in6_addr`." msgstr "" -#: ../Doc/library/socket.rst:726 +#: ../Doc/library/socket.rst:730 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the IP address string *ip_string* is invalid, :exc:" @@ -855,15 +861,15 @@ msgid "" "`inet_pton`." msgstr "" -#: ../Doc/library/socket.rst:732 ../Doc/library/socket.rst:752 +#: ../Doc/library/socket.rst:736 ../Doc/library/socket.rst:756 msgid "Availability: Unix (maybe not all platforms), Windows." msgstr "" -#: ../Doc/library/socket.rst:734 ../Doc/library/socket.rst:754 +#: ../Doc/library/socket.rst:738 ../Doc/library/socket.rst:758 msgid "Windows support added" msgstr "Ajout du support Windows." -#: ../Doc/library/socket.rst:740 +#: ../Doc/library/socket.rst:744 msgid "" "Convert a packed IP address (a :term:`bytes-like object` of some number of " "bytes) to its standard, family-specific string representation (for example, " @@ -872,7 +878,7 @@ msgid "" "in_addr` (similar to :func:`inet_ntoa`) or :c:type:`struct in6_addr`." msgstr "" -#: ../Doc/library/socket.rst:747 +#: ../Doc/library/socket.rst:751 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the bytes object *packed_ip* is not the correct length " @@ -880,7 +886,7 @@ msgid "" "`OSError` is raised for errors from the call to :func:`inet_ntop`." msgstr "" -#: ../Doc/library/socket.rst:769 +#: ../Doc/library/socket.rst:773 msgid "" "Return the total length, without trailing padding, of an ancillary data item " "with associated data of the given *length*. This value can often be used as " @@ -891,13 +897,13 @@ msgid "" "the permissible range of values." msgstr "" -#: ../Doc/library/socket.rst:778 ../Doc/library/socket.rst:799 -#: ../Doc/library/socket.rst:1170 ../Doc/library/socket.rst:1212 -#: ../Doc/library/socket.rst:1316 +#: ../Doc/library/socket.rst:782 ../Doc/library/socket.rst:803 +#: ../Doc/library/socket.rst:1174 ../Doc/library/socket.rst:1216 +#: ../Doc/library/socket.rst:1320 msgid "Availability: most Unix platforms, possibly others." msgstr "" -#: ../Doc/library/socket.rst:785 +#: ../Doc/library/socket.rst:789 msgid "" "Return the buffer size needed for :meth:`~socket.recvmsg` to receive an " "ancillary data item with associated data of the given *length*, along with " @@ -907,7 +913,7 @@ msgid "" "values." msgstr "" -#: ../Doc/library/socket.rst:793 +#: ../Doc/library/socket.rst:797 msgid "" "Note that some systems might support ancillary data without providing this " "function. Also note that setting the buffer size using the results of this " @@ -915,66 +921,66 @@ msgid "" "received, since additional data may be able to fit into the padding area." msgstr "" -#: ../Doc/library/socket.rst:806 +#: ../Doc/library/socket.rst:810 msgid "" "Return the default timeout in seconds (float) for new socket objects. A " "value of ``None`` indicates that new socket objects have no timeout. When " "the socket module is first imported, the default is ``None``." msgstr "" -#: ../Doc/library/socket.rst:813 +#: ../Doc/library/socket.rst:817 msgid "" "Set the default timeout in seconds (float) for new socket objects. When the " "socket module is first imported, the default is ``None``. See :meth:" "`~socket.settimeout` for possible values and their respective meanings." msgstr "" -#: ../Doc/library/socket.rst:821 +#: ../Doc/library/socket.rst:825 msgid "" "Set the machine's hostname to *name*. This will raise an :exc:`OSError` if " "you don't have enough rights." msgstr "" -#: ../Doc/library/socket.rst:824 ../Doc/library/socket.rst:835 -#: ../Doc/library/socket.rst:846 ../Doc/library/socket.rst:857 +#: ../Doc/library/socket.rst:828 ../Doc/library/socket.rst:839 +#: ../Doc/library/socket.rst:850 ../Doc/library/socket.rst:861 msgid "Availability: Unix." msgstr "Disponibilité : Unix." -#: ../Doc/library/socket.rst:831 +#: ../Doc/library/socket.rst:835 msgid "" "Return a list of network interface information (index int, name string) " "tuples. :exc:`OSError` if the system call fails." msgstr "" -#: ../Doc/library/socket.rst:842 +#: ../Doc/library/socket.rst:846 msgid "" "Return a network interface index number corresponding to an interface name. :" "exc:`OSError` if no interface with the given name exists." msgstr "" -#: ../Doc/library/socket.rst:853 +#: ../Doc/library/socket.rst:857 msgid "" "Return a network interface name corresponding to an interface index number. :" "exc:`OSError` if no interface with the given index exists." msgstr "" -#: ../Doc/library/socket.rst:865 +#: ../Doc/library/socket.rst:869 msgid "Socket Objects" msgstr "" -#: ../Doc/library/socket.rst:867 +#: ../Doc/library/socket.rst:871 msgid "" "Socket objects have the following methods. Except for :meth:`~socket." "makefile`, these correspond to Unix system calls applicable to sockets." msgstr "" -#: ../Doc/library/socket.rst:871 +#: ../Doc/library/socket.rst:875 msgid "" "Support for the :term:`context manager` protocol was added. Exiting the " "context manager is equivalent to calling :meth:`~socket.close`." msgstr "" -#: ../Doc/library/socket.rst:878 +#: ../Doc/library/socket.rst:882 msgid "" "Accept a connection. The socket must be bound to an address and listening " "for connections. The return value is a pair ``(conn, address)`` where *conn* " @@ -983,14 +989,14 @@ msgid "" "connection." msgstr "" -#: ../Doc/library/socket.rst:885 ../Doc/library/socket.rst:968 +#: ../Doc/library/socket.rst:889 ../Doc/library/socket.rst:972 msgid "The socket is now non-inheritable." msgstr "" -#: ../Doc/library/socket.rst:888 ../Doc/library/socket.rst:1089 -#: ../Doc/library/socket.rst:1103 ../Doc/library/socket.rst:1174 -#: ../Doc/library/socket.rst:1245 ../Doc/library/socket.rst:1264 -#: ../Doc/library/socket.rst:1279 ../Doc/library/socket.rst:1320 +#: ../Doc/library/socket.rst:892 ../Doc/library/socket.rst:1093 +#: ../Doc/library/socket.rst:1107 ../Doc/library/socket.rst:1178 +#: ../Doc/library/socket.rst:1249 ../Doc/library/socket.rst:1268 +#: ../Doc/library/socket.rst:1283 ../Doc/library/socket.rst:1324 msgid "" "If the system call is interrupted and the signal handler does not raise an " "exception, the method now retries the system call instead of raising an :exc:" @@ -1000,13 +1006,13 @@ msgstr "" "aucune exception, la fonction réessaye l'appel système au lieu de lever une :" "exc:`InterruptedError` (voir la :pep:`475` à propos du raisonnement)." -#: ../Doc/library/socket.rst:896 +#: ../Doc/library/socket.rst:900 msgid "" "Bind the socket to *address*. The socket must not already be bound. (The " "format of *address* depends on the address family --- see above.)" msgstr "" -#: ../Doc/library/socket.rst:902 +#: ../Doc/library/socket.rst:906 msgid "" "Mark the socket closed. The underlying system resource (e.g. a file " "descriptor) is also closed when all file objects from :meth:`makefile()` are " @@ -1015,20 +1021,20 @@ msgid "" "flushed)." msgstr "" -#: ../Doc/library/socket.rst:908 +#: ../Doc/library/socket.rst:912 msgid "" "Sockets are automatically closed when they are garbage-collected, but it is " "recommended to :meth:`close` them explicitly, or to use a :keyword:`with` " "statement around them." msgstr "" -#: ../Doc/library/socket.rst:912 +#: ../Doc/library/socket.rst:916 msgid "" ":exc:`OSError` is now raised if an error occurs when the underlying :c:func:" "`close` call is made." msgstr "" -#: ../Doc/library/socket.rst:918 +#: ../Doc/library/socket.rst:922 msgid "" ":meth:`close()` releases the resource associated with a connection but does " "not necessarily close the connection immediately. If you want to close the " @@ -1036,13 +1042,13 @@ msgid "" "`close()`." msgstr "" -#: ../Doc/library/socket.rst:926 +#: ../Doc/library/socket.rst:930 msgid "" "Connect to a remote socket at *address*. (The format of *address* depends on " "the address family --- see above.)" msgstr "" -#: ../Doc/library/socket.rst:929 +#: ../Doc/library/socket.rst:933 msgid "" "If the connection is interrupted by a signal, the method waits until the " "connection completes, or raise a :exc:`socket.timeout` on timeout, if the " @@ -1052,7 +1058,7 @@ msgid "" "(or the exception raised by the signal handler)." msgstr "" -#: ../Doc/library/socket.rst:936 +#: ../Doc/library/socket.rst:940 msgid "" "The method now waits until the connection completes instead of raising an :" "exc:`InterruptedError` exception if the connection is interrupted by a " @@ -1060,7 +1066,7 @@ msgid "" "blocking or has a timeout (see the :pep:`475` for the rationale)." msgstr "" -#: ../Doc/library/socket.rst:945 +#: ../Doc/library/socket.rst:949 msgid "" "Like ``connect(address)``, but return an error indicator instead of raising " "an exception for errors returned by the C-level :c:func:`connect` call " @@ -1070,38 +1076,38 @@ msgid "" "asynchronous connects." msgstr "" -#: ../Doc/library/socket.rst:955 +#: ../Doc/library/socket.rst:959 msgid "" "Put the socket object into closed state without actually closing the " "underlying file descriptor. The file descriptor is returned, and can be " "reused for other purposes." msgstr "" -#: ../Doc/library/socket.rst:964 +#: ../Doc/library/socket.rst:968 msgid "Duplicate the socket." msgstr "" -#: ../Doc/library/socket.rst:974 +#: ../Doc/library/socket.rst:978 msgid "" "Return the socket's file descriptor (a small integer), or -1 on failure. " "This is useful with :func:`select.select`." msgstr "" -#: ../Doc/library/socket.rst:977 +#: ../Doc/library/socket.rst:981 msgid "" "Under Windows the small integer returned by this method cannot be used where " "a file descriptor can be used (such as :func:`os.fdopen`). Unix does not " "have this limitation." msgstr "" -#: ../Doc/library/socket.rst:983 +#: ../Doc/library/socket.rst:987 msgid "" "Get the :ref:`inheritable flag ` of the socket's file " "descriptor or socket's handle: ``True`` if the socket can be inherited in " "child processes, ``False`` if it cannot." msgstr "" -#: ../Doc/library/socket.rst:992 +#: ../Doc/library/socket.rst:996 msgid "" "Return the remote address to which the socket is connected. This is useful " "to find out the port number of a remote IPv4/v6 socket, for instance. (The " @@ -1109,14 +1115,14 @@ msgid "" "above.) On some systems this function is not supported." msgstr "" -#: ../Doc/library/socket.rst:1000 +#: ../Doc/library/socket.rst:1004 msgid "" "Return the socket's own address. This is useful to find out the port number " "of an IPv4/v6 socket, for instance. (The format of the address returned " "depends on the address family --- see above.)" msgstr "" -#: ../Doc/library/socket.rst:1007 +#: ../Doc/library/socket.rst:1011 msgid "" "Return the value of the given socket option (see the Unix man page :manpage:" "`getsockopt(2)`). The needed symbolic constants (:const:`SO_\\*` etc.) are " @@ -1128,7 +1134,7 @@ msgid "" "`struct` for a way to decode C structures encoded as byte strings)." msgstr "" -#: ../Doc/library/socket.rst:1019 +#: ../Doc/library/socket.rst:1023 msgid "" "Return the timeout in seconds (float) associated with socket operations, or " "``None`` if no timeout is set. This reflects the last call to :meth:" @@ -1139,30 +1145,30 @@ msgstr "" msgid "platform" msgstr "" -#: ../Doc/library/socket.rst:1026 +#: ../Doc/library/socket.rst:1030 msgid "Windows" msgstr "Windows" -#: ../Doc/library/socket.rst:1028 +#: ../Doc/library/socket.rst:1032 msgid "" "The :meth:`ioctl` method is a limited interface to the WSAIoctl system " "interface. Please refer to the `Win32 documentation `_ for more information." msgstr "" -#: ../Doc/library/socket.rst:1033 +#: ../Doc/library/socket.rst:1037 msgid "" "On other platforms, the generic :func:`fcntl.fcntl` and :func:`fcntl.ioctl` " "functions may be used; they accept a socket object as their first argument." msgstr "" -#: ../Doc/library/socket.rst:1036 +#: ../Doc/library/socket.rst:1040 msgid "" "Currently only the following control codes are supported: ``SIO_RCVALL``, " "``SIO_KEEPALIVE_VALS``, and ``SIO_LOOPBACK_FAST_PATH``." msgstr "" -#: ../Doc/library/socket.rst:1044 +#: ../Doc/library/socket.rst:1048 msgid "" "Enable a server to accept connections. If *backlog* is specified, it must " "be at least 0 (if it is lower, it is set to 0); it specifies the number of " @@ -1170,11 +1176,11 @@ msgid "" "connections. If not specified, a default reasonable value is chosen." msgstr "" -#: ../Doc/library/socket.rst:1049 +#: ../Doc/library/socket.rst:1053 msgid "The *backlog* parameter is now optional." msgstr "" -#: ../Doc/library/socket.rst:1057 +#: ../Doc/library/socket.rst:1061 msgid "" "Return a :term:`file object` associated with the socket. The exact returned " "type depends on the arguments given to :meth:`makefile`. These arguments " @@ -1183,28 +1189,28 @@ msgid "" "``'b'``." msgstr "" -#: ../Doc/library/socket.rst:1062 +#: ../Doc/library/socket.rst:1066 msgid "" "The socket must be in blocking mode; it can have a timeout, but the file " "object's internal buffer may end up in an inconsistent state if a timeout " "occurs." msgstr "" -#: ../Doc/library/socket.rst:1066 +#: ../Doc/library/socket.rst:1070 msgid "" "Closing the file object returned by :meth:`makefile` won't close the " "original socket unless all other file objects have been closed and :meth:" "`socket.close` has been called on the socket object." msgstr "" -#: ../Doc/library/socket.rst:1072 +#: ../Doc/library/socket.rst:1076 msgid "" "On Windows, the file-like object created by :meth:`makefile` cannot be used " "where a file object with a file descriptor is expected, such as the stream " "arguments of :meth:`subprocess.Popen`." msgstr "" -#: ../Doc/library/socket.rst:1079 +#: ../Doc/library/socket.rst:1083 msgid "" "Receive data from the socket. The return value is a bytes object " "representing the data received. The maximum amount of data to be received " @@ -1213,13 +1219,13 @@ msgid "" "zero." msgstr "" -#: ../Doc/library/socket.rst:1086 +#: ../Doc/library/socket.rst:1090 msgid "" "For best match with hardware and network realities, the value of *bufsize* " "should be a relatively small power of 2, for example, 4096." msgstr "" -#: ../Doc/library/socket.rst:1097 +#: ../Doc/library/socket.rst:1101 msgid "" "Receive data from the socket. The return value is a pair ``(bytes, " "address)`` where *bytes* is a bytes object representing the data received " @@ -1229,7 +1235,7 @@ msgid "" "address family --- see above.)" msgstr "" -#: ../Doc/library/socket.rst:1111 +#: ../Doc/library/socket.rst:1115 msgid "" "Receive normal data (up to *bufsize* bytes) and ancillary data from the " "socket. The *ancbufsize* argument sets the size in bytes of the internal " @@ -1240,7 +1246,7 @@ msgid "" "*flags* argument defaults to 0 and has the same meaning as for :meth:`recv`." msgstr "" -#: ../Doc/library/socket.rst:1121 +#: ../Doc/library/socket.rst:1125 msgid "" "The return value is a 4-tuple: ``(data, ancdata, msg_flags, address)``. The " "*data* item is a :class:`bytes` object holding the non-ancillary data " @@ -1255,7 +1261,7 @@ msgid "" "socket, if available; otherwise, its value is unspecified." msgstr "" -#: ../Doc/library/socket.rst:1135 +#: ../Doc/library/socket.rst:1139 msgid "" "On some systems, :meth:`sendmsg` and :meth:`recvmsg` can be used to pass " "file descriptors between processes over an :const:`AF_UNIX` socket. When " @@ -1268,7 +1274,7 @@ msgid "" "descriptors received via this mechanism." msgstr "" -#: ../Doc/library/socket.rst:1146 +#: ../Doc/library/socket.rst:1150 msgid "" "Some systems do not indicate the truncated length of ancillary data items " "which have been only partially received. If an item appears to extend " @@ -1277,7 +1283,7 @@ msgid "" "provided it has not been truncated before the start of its associated data." msgstr "" -#: ../Doc/library/socket.rst:1153 +#: ../Doc/library/socket.rst:1157 msgid "" "On systems which support the :const:`SCM_RIGHTS` mechanism, the following " "function will receive up to *maxfds* file descriptors, returning the message " @@ -1286,7 +1292,7 @@ msgid "" "meth:`sendmsg`. ::" msgstr "" -#: ../Doc/library/socket.rst:1182 +#: ../Doc/library/socket.rst:1186 msgid "" "Receive normal data and ancillary data from the socket, behaving as :meth:" "`recvmsg` would, but scatter the non-ancillary data into a series of buffers " @@ -1299,7 +1305,7 @@ msgid "" "arguments have the same meaning as for :meth:`recvmsg`." msgstr "" -#: ../Doc/library/socket.rst:1193 +#: ../Doc/library/socket.rst:1197 msgid "" "The return value is a 4-tuple: ``(nbytes, ancdata, msg_flags, address)``, " "where *nbytes* is the total number of bytes of non-ancillary data written " @@ -1307,11 +1313,11 @@ msgid "" "for :meth:`recvmsg`." msgstr "" -#: ../Doc/library/socket.rst:1198 +#: ../Doc/library/socket.rst:1202 msgid "Example::" msgstr "Exemples ::" -#: ../Doc/library/socket.rst:1219 +#: ../Doc/library/socket.rst:1223 msgid "" "Receive data from the socket, writing it into *buffer* instead of creating a " "new bytestring. The return value is a pair ``(nbytes, address)`` where " @@ -1321,7 +1327,7 @@ msgid "" "format of *address* depends on the address family --- see above.)" msgstr "" -#: ../Doc/library/socket.rst:1229 +#: ../Doc/library/socket.rst:1233 msgid "" "Receive up to *nbytes* bytes from the socket, storing the data into a buffer " "rather than creating a new bytestring. If *nbytes* is not specified (or 0), " @@ -1330,7 +1336,7 @@ msgid "" "of the optional argument *flags*; it defaults to zero." msgstr "" -#: ../Doc/library/socket.rst:1238 +#: ../Doc/library/socket.rst:1242 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " @@ -1340,7 +1346,7 @@ msgid "" "data. For further information on this topic, consult the :ref:`socket-howto`." msgstr "" -#: ../Doc/library/socket.rst:1253 +#: ../Doc/library/socket.rst:1257 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " @@ -1350,13 +1356,13 @@ msgid "" "to determine how much data, if any, was successfully sent." msgstr "" -#: ../Doc/library/socket.rst:1260 +#: ../Doc/library/socket.rst:1264 msgid "" "The socket timeout is no more reset each time data is sent successfully. The " "socket timeout is now the maximum total duration to send all data." msgstr "" -#: ../Doc/library/socket.rst:1273 +#: ../Doc/library/socket.rst:1277 msgid "" "Send data to the socket. The socket should not be connected to a remote " "socket, since the destination socket is specified by *address*. The " @@ -1365,7 +1371,7 @@ msgid "" "address family --- see above.)" msgstr "" -#: ../Doc/library/socket.rst:1287 +#: ../Doc/library/socket.rst:1291 msgid "" "Send normal and ancillary data to the socket, gathering the non-ancillary " "data from a series of buffers and concatenating it into a single message. " @@ -1385,25 +1391,25 @@ msgid "" "bytes of non-ancillary data sent." msgstr "" -#: ../Doc/library/socket.rst:1307 +#: ../Doc/library/socket.rst:1311 msgid "" "The following function sends the list of file descriptors *fds* over an :" "const:`AF_UNIX` socket, on systems which support the :const:`SCM_RIGHTS` " "mechanism. See also :meth:`recvmsg`. ::" msgstr "" -#: ../Doc/library/socket.rst:1327 +#: ../Doc/library/socket.rst:1331 msgid "" "Specialized version of :meth:`~socket.sendmsg` for :const:`AF_ALG` socket. " "Set mode, IV, AEAD associated data length and flags for :const:`AF_ALG` " "socket." msgstr "" -#: ../Doc/library/socket.rst:1330 +#: ../Doc/library/socket.rst:1334 msgid "Availability: Linux >= 2.6.38" msgstr "" -#: ../Doc/library/socket.rst:1336 +#: ../Doc/library/socket.rst:1340 msgid "" "Send a file until EOF is reached by using high-performance :mod:`os." "sendfile` and return the total number of bytes which were sent. *file* must " @@ -1417,32 +1423,32 @@ msgid "" "be of :const:`SOCK_STREAM` type. Non-blocking sockets are not supported." msgstr "" -#: ../Doc/library/socket.rst:1352 +#: ../Doc/library/socket.rst:1356 msgid "" "Set the :ref:`inheritable flag ` of the socket's file " "descriptor or socket's handle." msgstr "" -#: ../Doc/library/socket.rst:1360 +#: ../Doc/library/socket.rst:1364 msgid "" "Set blocking or non-blocking mode of the socket: if *flag* is false, the " "socket is set to non-blocking, else to blocking mode." msgstr "" -#: ../Doc/library/socket.rst:1363 +#: ../Doc/library/socket.rst:1367 msgid "" "This method is a shorthand for certain :meth:`~socket.settimeout` calls:" msgstr "" -#: ../Doc/library/socket.rst:1365 +#: ../Doc/library/socket.rst:1369 msgid "``sock.setblocking(True)`` is equivalent to ``sock.settimeout(None)``" msgstr "" -#: ../Doc/library/socket.rst:1367 +#: ../Doc/library/socket.rst:1371 msgid "``sock.setblocking(False)`` is equivalent to ``sock.settimeout(0.0)``" msgstr "" -#: ../Doc/library/socket.rst:1372 +#: ../Doc/library/socket.rst:1376 msgid "" "Set a timeout on blocking socket operations. The *value* argument can be a " "nonnegative floating point number expressing seconds, or ``None``. If a non-" @@ -1452,13 +1458,13 @@ msgid "" "blocking mode. If ``None`` is given, the socket is put in blocking mode." msgstr "" -#: ../Doc/library/socket.rst:1379 +#: ../Doc/library/socket.rst:1383 msgid "" "For further information, please consult the :ref:`notes on socket timeouts " "`." msgstr "" -#: ../Doc/library/socket.rst:1388 +#: ../Doc/library/socket.rst:1392 msgid "" "Set the value of the given socket option (see the Unix manual page :manpage:" "`setsockopt(2)`). The needed symbolic constants are defined in the :mod:" @@ -1471,11 +1477,11 @@ msgid "" "optval=NULL and optlen=optlen." msgstr "" -#: ../Doc/library/socket.rst:1402 +#: ../Doc/library/socket.rst:1406 msgid "setsockopt(level, optname, None, optlen: int) form added." msgstr "" -#: ../Doc/library/socket.rst:1408 +#: ../Doc/library/socket.rst:1412 msgid "" "Shut down one or both halves of the connection. If *how* is :const:" "`SHUT_RD`, further receives are disallowed. If *how* is :const:`SHUT_WR`, " @@ -1483,7 +1489,7 @@ msgid "" "and receives are disallowed." msgstr "" -#: ../Doc/library/socket.rst:1416 +#: ../Doc/library/socket.rst:1420 msgid "" "Duplicate a socket and prepare it for sharing with a target process. The " "target process must be provided with *process_id*. The resulting bytes " @@ -1494,48 +1500,48 @@ msgid "" "process." msgstr "" -#: ../Doc/library/socket.rst:1428 +#: ../Doc/library/socket.rst:1432 msgid "" "Note that there are no methods :meth:`read` or :meth:`write`; use :meth:" "`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." msgstr "" -#: ../Doc/library/socket.rst:1431 +#: ../Doc/library/socket.rst:1435 msgid "" "Socket objects also have these (read-only) attributes that correspond to the " "values given to the :class:`~socket.socket` constructor." msgstr "" -#: ../Doc/library/socket.rst:1437 +#: ../Doc/library/socket.rst:1441 msgid "The socket family." msgstr "" -#: ../Doc/library/socket.rst:1442 +#: ../Doc/library/socket.rst:1446 msgid "The socket type." msgstr "" -#: ../Doc/library/socket.rst:1447 +#: ../Doc/library/socket.rst:1451 msgid "The socket protocol." msgstr "" -#: ../Doc/library/socket.rst:1454 +#: ../Doc/library/socket.rst:1458 msgid "Notes on socket timeouts" msgstr "" -#: ../Doc/library/socket.rst:1456 +#: ../Doc/library/socket.rst:1460 msgid "" "A socket object can be in one of three modes: blocking, non-blocking, or " "timeout. Sockets are by default always created in blocking mode, but this " "can be changed by calling :func:`setdefaulttimeout`." msgstr "" -#: ../Doc/library/socket.rst:1460 +#: ../Doc/library/socket.rst:1464 msgid "" "In *blocking mode*, operations block until complete or the system returns an " "error (such as connection timed out)." msgstr "" -#: ../Doc/library/socket.rst:1463 +#: ../Doc/library/socket.rst:1467 msgid "" "In *non-blocking mode*, operations fail (with an error that is unfortunately " "system-dependent) if they cannot be completed immediately: functions from " @@ -1543,14 +1549,14 @@ msgid "" "for reading or writing." msgstr "" -#: ../Doc/library/socket.rst:1468 +#: ../Doc/library/socket.rst:1472 msgid "" "In *timeout mode*, operations fail if they cannot be completed within the " "timeout specified for the socket (they raise a :exc:`timeout` exception) or " "if the system returns an error." msgstr "" -#: ../Doc/library/socket.rst:1473 +#: ../Doc/library/socket.rst:1477 msgid "" "At the operating system level, sockets in *timeout mode* are internally set " "in non-blocking mode. Also, the blocking and timeout modes are shared " @@ -1559,11 +1565,11 @@ msgid "" "you decide to use the :meth:`~socket.fileno()` of a socket." msgstr "" -#: ../Doc/library/socket.rst:1480 +#: ../Doc/library/socket.rst:1484 msgid "Timeouts and the ``connect`` method" msgstr "" -#: ../Doc/library/socket.rst:1482 +#: ../Doc/library/socket.rst:1486 msgid "" "The :meth:`~socket.connect` operation is also subject to the timeout " "setting, and in general it is recommended to call :meth:`~socket.settimeout` " @@ -1573,24 +1579,24 @@ msgid "" "setting." msgstr "" -#: ../Doc/library/socket.rst:1490 +#: ../Doc/library/socket.rst:1494 msgid "Timeouts and the ``accept`` method" msgstr "" -#: ../Doc/library/socket.rst:1492 +#: ../Doc/library/socket.rst:1496 msgid "" "If :func:`getdefaulttimeout` is not :const:`None`, sockets returned by the :" "meth:`~socket.accept` method inherit that timeout. Otherwise, the behaviour " "depends on settings of the listening socket:" msgstr "" -#: ../Doc/library/socket.rst:1496 +#: ../Doc/library/socket.rst:1500 msgid "" "if the listening socket is in *blocking mode* or in *timeout mode*, the " "socket returned by :meth:`~socket.accept` is in *blocking mode*;" msgstr "" -#: ../Doc/library/socket.rst:1499 +#: ../Doc/library/socket.rst:1503 msgid "" "if the listening socket is in *non-blocking mode*, whether the socket " "returned by :meth:`~socket.accept` is in blocking or non-blocking mode is " @@ -1598,11 +1604,11 @@ msgid "" "it is recommended you manually override this setting." msgstr "" -#: ../Doc/library/socket.rst:1508 +#: ../Doc/library/socket.rst:1512 msgid "Example" msgstr "Exemple" -#: ../Doc/library/socket.rst:1510 +#: ../Doc/library/socket.rst:1514 msgid "" "Here are four minimal example programs using the TCP/IP protocol: a server " "that echoes all data that it receives back (servicing only one client), and " @@ -1615,11 +1621,11 @@ msgid "" "new socket returned by :meth:`~socket.accept`." msgstr "" -#: ../Doc/library/socket.rst:1520 +#: ../Doc/library/socket.rst:1524 msgid "The first two examples support IPv4 only. ::" msgstr "" -#: ../Doc/library/socket.rst:1551 +#: ../Doc/library/socket.rst:1555 msgid "" "The next two examples are identical to the above two, but support both IPv4 " "and IPv6. The server side will listen to the first address family available " @@ -1629,73 +1635,73 @@ msgid "" "resolution, and sends traffic to the first one connected successfully. ::" msgstr "" -#: ../Doc/library/socket.rst:1624 +#: ../Doc/library/socket.rst:1628 msgid "" "The next example shows how to write a very simple network sniffer with raw " "sockets on Windows. The example requires administrator privileges to modify " "the interface::" msgstr "" -#: ../Doc/library/socket.rst:1649 +#: ../Doc/library/socket.rst:1653 msgid "" "The last example shows how to use the socket interface to communicate to a " "CAN network using the raw socket protocol. To use CAN with the broadcast " "manager protocol instead, open a socket with::" msgstr "" -#: ../Doc/library/socket.rst:1655 +#: ../Doc/library/socket.rst:1659 msgid "" "After binding (:const:`CAN_RAW`) or connecting (:const:`CAN_BCM`) the " "socket, you can use the :meth:`socket.send`, and the :meth:`socket.recv` " "operations (and their counterparts) on the socket object as usual." msgstr "" -#: ../Doc/library/socket.rst:1659 +#: ../Doc/library/socket.rst:1663 msgid "This example might require special privileges::" msgstr "" -#: ../Doc/library/socket.rst:1699 +#: ../Doc/library/socket.rst:1703 msgid "" "Running an example several times with too small delay between executions, " "could lead to this error::" msgstr "" -#: ../Doc/library/socket.rst:1704 +#: ../Doc/library/socket.rst:1708 msgid "" "This is because the previous execution has left the socket in a " "``TIME_WAIT`` state, and can't be immediately reused." msgstr "" -#: ../Doc/library/socket.rst:1707 +#: ../Doc/library/socket.rst:1711 msgid "" "There is a :mod:`socket` flag to set, in order to prevent this, :data:" "`socket.SO_REUSEADDR`::" msgstr "" -#: ../Doc/library/socket.rst:1714 +#: ../Doc/library/socket.rst:1718 msgid "" "the :data:`SO_REUSEADDR` flag tells the kernel to reuse a local socket in " "``TIME_WAIT`` state, without waiting for its natural timeout to expire." msgstr "" -#: ../Doc/library/socket.rst:1720 +#: ../Doc/library/socket.rst:1724 msgid "" "For an introduction to socket programming (in C), see the following papers:" msgstr "" -#: ../Doc/library/socket.rst:1722 +#: ../Doc/library/socket.rst:1726 msgid "" "*An Introductory 4.3BSD Interprocess Communication Tutorial*, by Stuart " "Sechrest" msgstr "" -#: ../Doc/library/socket.rst:1724 +#: ../Doc/library/socket.rst:1728 msgid "" "*An Advanced 4.3BSD Interprocess Communication Tutorial*, by Samuel J. " "Leffler et al," msgstr "" -#: ../Doc/library/socket.rst:1727 +#: ../Doc/library/socket.rst:1731 msgid "" "both in the UNIX Programmer's Manual, Supplementary Documents 1 (sections " "PS1:7 and PS1:8). The platform-specific reference material for the various " diff --git a/library/ssl.po b/library/ssl.po index 0d1b43e4..b82cc7b1 100644 --- a/library/ssl.po +++ b/library/ssl.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-01-04 15:51+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2017-09-12 13:41+0200\n" "Last-Translator: \n" "Language-Team: \n" @@ -1768,7 +1768,7 @@ msgstr "" #: ../Doc/library/ssl.rst:1542 msgid "" -"Load the key generation parameters for Diffie-Helman (DH) key exchange. " +"Load the key generation parameters for Diffie-Hellman (DH) key exchange. " "Using DH key exchange improves forward secrecy at the expense of " "computational resources (both on the server and on the client). The *dhfile* " "parameter should be the path to a file containing DH parameters in PEM " @@ -2589,101 +2589,126 @@ msgid "" msgstr "" #: ../Doc/library/ssl.rst:2326 +msgid "LibreSSL support" +msgstr "" + +#: ../Doc/library/ssl.rst:2328 +msgid "" +"LibreSSL is a fork of OpenSSL 1.0.1. The ssl module has limited support for " +"LibreSSL. Some features are not available when the ssl module is compiled " +"with LibreSSL." +msgstr "" + +#: ../Doc/library/ssl.rst:2332 +msgid "" +"LibreSSL >= 2.6.1 no longer supports NPN. The methods :meth:`SSLContext." +"set_npn_protocols` and :meth:`SSLSocket.selected_npn_protocol` are not " +"available." +msgstr "" + +#: ../Doc/library/ssl.rst:2335 +msgid "" +":meth:`SSLContext.set_default_verify_paths` ignores the env vars :envvar:" +"`SSL_CERT_FILE` and :envvar:`SSL_CERT_PATH` although :func:" +"`get_default_verify_paths` still reports them." +msgstr "" + +#: ../Doc/library/ssl.rst:2343 msgid "Class :class:`socket.socket`" msgstr "" -#: ../Doc/library/ssl.rst:2326 +#: ../Doc/library/ssl.rst:2343 msgid "Documentation of underlying :mod:`socket` class" msgstr "" -#: ../Doc/library/ssl.rst:2329 +#: ../Doc/library/ssl.rst:2346 msgid "" "`SSL/TLS Strong Encryption: An Introduction `_" msgstr "" -#: ../Doc/library/ssl.rst:2329 -msgid "Intro from the Apache webserver documentation" +#: ../Doc/library/ssl.rst:2346 +msgid "Intro from the Apache HTTP Server documentation" msgstr "" -#: ../Doc/library/ssl.rst:2332 +#: ../Doc/library/ssl.rst:2349 msgid "" "`RFC 1422: Privacy Enhancement for Internet Electronic Mail: Part II: " "Certificate-Based Key Management `_" msgstr "" -#: ../Doc/library/ssl.rst:2332 +#: ../Doc/library/ssl.rst:2349 msgid "Steve Kent" msgstr "" -#: ../Doc/library/ssl.rst:2335 +#: ../Doc/library/ssl.rst:2352 msgid "" "`RFC 4086: Randomness Requirements for Security `_" msgstr "" -#: ../Doc/library/ssl.rst:2335 +#: ../Doc/library/ssl.rst:2352 msgid "Donald E., Jeffrey I. Schiller" msgstr "" -#: ../Doc/library/ssl.rst:2338 +#: ../Doc/library/ssl.rst:2355 msgid "" "`RFC 5280: Internet X.509 Public Key Infrastructure Certificate and " "Certificate Revocation List (CRL) Profile `_" msgstr "" -#: ../Doc/library/ssl.rst:2338 +#: ../Doc/library/ssl.rst:2355 msgid "D. Cooper" msgstr "" -#: ../Doc/library/ssl.rst:2341 +#: ../Doc/library/ssl.rst:2358 msgid "" "`RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 `_" msgstr "" -#: ../Doc/library/ssl.rst:2341 +#: ../Doc/library/ssl.rst:2358 msgid "T. Dierks et. al." msgstr "" -#: ../Doc/library/ssl.rst:2344 +#: ../Doc/library/ssl.rst:2361 msgid "" "`RFC 6066: Transport Layer Security (TLS) Extensions `_" msgstr "" -#: ../Doc/library/ssl.rst:2344 +#: ../Doc/library/ssl.rst:2361 msgid "D. Eastlake" msgstr "" -#: ../Doc/library/ssl.rst:2347 +#: ../Doc/library/ssl.rst:2364 msgid "" "`IANA TLS: Transport Layer Security (TLS) Parameters `_" msgstr "" -#: ../Doc/library/ssl.rst:2347 +#: ../Doc/library/ssl.rst:2364 msgid "IANA" msgstr "" -#: ../Doc/library/ssl.rst:2350 +#: ../Doc/library/ssl.rst:2367 msgid "" "`RFC 7525: Recommendations for Secure Use of Transport Layer Security (TLS) " "and Datagram Transport Layer Security (DTLS) `_" msgstr "" -#: ../Doc/library/ssl.rst:2350 +#: ../Doc/library/ssl.rst:2367 msgid "IETF" msgstr "" -#: ../Doc/library/ssl.rst:2352 +#: ../Doc/library/ssl.rst:2369 msgid "" "`Mozilla's Server Side TLS recommendations `_" msgstr "" -#: ../Doc/library/ssl.rst:2353 +#: ../Doc/library/ssl.rst:2370 msgid "Mozilla" msgstr "" diff --git a/library/test.po b/library/test.po index 1cb4c780..fcb81b54 100644 --- a/library/test.po +++ b/library/test.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-08-10 00:49+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -724,3 +724,10 @@ msgid "" "Class used to record warnings for unit tests. See documentation of :func:" "`check_warnings` above for more details." msgstr "" + +#: ../Doc/library/test.rst:684 +msgid "" +"Simple :term:`path-like object`. It implements the :meth:`__fspath__` " +"method which just returns the *path* argument. If *path* is an exception, " +"it will be raised in :meth:`!__fspath__`." +msgstr "" diff --git a/library/tkinter.ttk.po b/library/tkinter.ttk.po index 9b67a785..02887800 100644 --- a/library/tkinter.ttk.po +++ b/library/tkinter.ttk.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-10-13 22:28+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -1685,13 +1685,6 @@ msgid "" "according to the following selection methods." msgstr "" -#: ../Doc/library/tkinter.ttk.rst:1104 -msgid "" -"Deprecated since version 3.6, will be removed in version 3.8: Using " -"selection() for changing the selection state is deprecated. Use the " -"following selection methods instead." -msgstr "" - #: ../Doc/library/tkinter.ttk.rst:1104 msgid "" "Using ``selection()`` for changing the selection state is deprecated. Use " diff --git a/library/unittest.po b/library/unittest.po index a2cf8b91..dfd74dab 100644 --- a/library/unittest.po +++ b/library/unittest.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-12-01 07:43+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2017-08-01 14:02+0200\n" "Last-Translator: \n" "Language-Team: \n" @@ -2793,5 +2793,5 @@ msgstr "" msgid "" "When called without arguments this function removes the control-c handler if " "it has been installed. This function can also be used as a test decorator to " -"temporarily remove the handler whilst the test is being executed::" +"temporarily remove the handler while the test is being executed::" msgstr "" diff --git a/library/venv.po b/library/venv.po index 94133b00..0eea2c24 100644 --- a/library/venv.po +++ b/library/venv.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-04-02 22:11+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -64,10 +64,11 @@ msgid "" "command was run. It also creates a ``bin`` (or ``Scripts`` on Windows) " "subdirectory containing a copy of the ``python`` binary (or binaries, in the " "case of Windows). It also creates an (initially empty) ``lib/pythonX.Y/site-" -"packages`` subdirectory (on Windows, this is ``Lib\\site-packages``)." +"packages`` subdirectory (on Windows, this is ``Lib\\site-packages``). If an " +"existing directory is specified, it will be re-used." msgstr "" -#: ../Doc/using/venv-create.inc:14 +#: ../Doc/using/venv-create.inc:15 msgid "" "``pyvenv`` was the recommended tool for creating virtual environments for " "Python 3.3 and 3.4, and is `deprecated in Python 3.6 `_." -#: ../Doc/using/venv-create.inc:19 +#: ../Doc/using/venv-create.inc:20 msgid "" "The use of ``venv`` is now recommended for creating virtual environments." msgstr "" "L'utilisation de ``venv`` est maintenant recommandée pour créer vos " "environnements virtuels." -#: ../Doc/using/venv-create.inc:24 +#: ../Doc/using/venv-create.inc:25 msgid "" "`Python Packaging User Guide: Creating and using virtual environments " "`__" @@ -93,122 +94,120 @@ msgstr "" "environnements virtuels `__" -#: ../Doc/using/venv-create.inc:29 +#: ../Doc/using/venv-create.inc:30 msgid "On Windows, invoke the ``venv`` command as follows::" msgstr "" -#: ../Doc/using/venv-create.inc:33 +#: ../Doc/using/venv-create.inc:34 msgid "" "Alternatively, if you configured the ``PATH`` and ``PATHEXT`` variables for " "your :ref:`Python installation `::" msgstr "" -#: ../Doc/using/venv-create.inc:38 +#: ../Doc/using/venv-create.inc:39 msgid "The command, if run with ``-h``, will show the available options::" msgstr "" -#: ../Doc/using/venv-create.inc:68 +#: ../Doc/using/venv-create.inc:69 msgid "" "Installs pip by default, added the ``--without-pip`` and ``--copies`` " "options" msgstr "" -#: ../Doc/using/venv-create.inc:72 +#: ../Doc/using/venv-create.inc:73 msgid "" "In earlier versions, if the target directory already existed, an error was " -"raised, unless the ``--clear`` or ``--upgrade`` option was provided. Now, if " -"an existing directory is specified, its contents are removed and the " -"directory is processed as if it had been newly created." +"raised, unless the ``--clear`` or ``--upgrade`` option was provided." msgstr "" -#: ../Doc/using/venv-create.inc:78 +#: ../Doc/using/venv-create.inc:77 msgid "" "The created ``pyvenv.cfg`` file also includes the ``include-system-site-" "packages`` key, set to ``true`` if ``venv`` is run with the ``--system-site-" "packages`` option, ``false`` otherwise." msgstr "" -#: ../Doc/using/venv-create.inc:82 +#: ../Doc/using/venv-create.inc:81 msgid "" "Unless the ``--without-pip`` option is given, :mod:`ensurepip` will be " "invoked to bootstrap ``pip`` into the virtual environment." msgstr "" -#: ../Doc/using/venv-create.inc:85 +#: ../Doc/using/venv-create.inc:84 msgid "" "Multiple paths can be given to ``venv``, in which case an identical virtual " "environment will be created, according to the given options, at each " "provided path." msgstr "" -#: ../Doc/using/venv-create.inc:89 +#: ../Doc/using/venv-create.inc:88 msgid "" "Once a virtual environment has been created, it can be \"activated\" using a " "script in the virtual environment's binary directory. The invocation of the " "script is platform-specific:" msgstr "" -#: ../Doc/using/venv-create.inc:94 +#: ../Doc/using/venv-create.inc:93 msgid "Platform" msgstr "Plateforme" -#: ../Doc/using/venv-create.inc:94 +#: ../Doc/using/venv-create.inc:93 msgid "Shell" msgstr "" -#: ../Doc/using/venv-create.inc:94 +#: ../Doc/using/venv-create.inc:93 msgid "Command to activate virtual environment" msgstr "Commande pour activer l'environnement virtuel" -#: ../Doc/using/venv-create.inc:96 +#: ../Doc/using/venv-create.inc:95 msgid "Posix" msgstr "Posix" -#: ../Doc/using/venv-create.inc:96 +#: ../Doc/using/venv-create.inc:95 msgid "bash/zsh" msgstr "bash/zsh" -#: ../Doc/using/venv-create.inc:96 +#: ../Doc/using/venv-create.inc:95 msgid "$ source /bin/activate" msgstr "$ source /bin/activate" -#: ../Doc/using/venv-create.inc:98 +#: ../Doc/using/venv-create.inc:97 msgid "fish" msgstr "fish" -#: ../Doc/using/venv-create.inc:98 +#: ../Doc/using/venv-create.inc:97 msgid "$ . /bin/activate.fish" msgstr "$ . /bin/activate.fish" -#: ../Doc/using/venv-create.inc:100 +#: ../Doc/using/venv-create.inc:99 msgid "csh/tcsh" msgstr "csh/tcsh" -#: ../Doc/using/venv-create.inc:100 +#: ../Doc/using/venv-create.inc:99 msgid "$ source /bin/activate.csh" msgstr "$ source /bin/activate.csh" -#: ../Doc/using/venv-create.inc:102 +#: ../Doc/using/venv-create.inc:101 msgid "Windows" msgstr "Windows" -#: ../Doc/using/venv-create.inc:102 +#: ../Doc/using/venv-create.inc:101 msgid "cmd.exe" msgstr "cmd.exe" -#: ../Doc/using/venv-create.inc:102 +#: ../Doc/using/venv-create.inc:101 msgid "C:\\\\> \\\\Scripts\\\\activate.bat" msgstr "" -#: ../Doc/using/venv-create.inc:104 +#: ../Doc/using/venv-create.inc:103 msgid "PowerShell" msgstr "PowerShell" -#: ../Doc/using/venv-create.inc:104 +#: ../Doc/using/venv-create.inc:103 msgid "PS C:\\\\> \\\\Scripts\\\\Activate.ps1" msgstr "" -#: ../Doc/using/venv-create.inc:107 +#: ../Doc/using/venv-create.inc:106 msgid "" "You don't specifically *need* to activate an environment; activation just " "prepends the virtual environment's binary directory to your path, so that " @@ -218,7 +217,7 @@ msgid "" "activating it, and run with the virtual environment's Python automatically." msgstr "" -#: ../Doc/using/venv-create.inc:114 +#: ../Doc/using/venv-create.inc:113 msgid "" "You can deactivate a virtual environment by typing \"deactivate\" in your " "shell. The exact mechanism is platform-specific: for example, the Bash " @@ -227,7 +226,7 @@ msgid "" "which are installed when the virtual environment is created." msgstr "" -#: ../Doc/using/venv-create.inc:120 +#: ../Doc/using/venv-create.inc:119 msgid "``fish`` and ``csh`` activation scripts." msgstr "" diff --git a/library/xml.etree.elementtree.po b/library/xml.etree.elementtree.po index 9c91b540..6a770b33 100644 --- a/library/xml.etree.elementtree.po +++ b/library/xml.etree.elementtree.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-04-02 22:11+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -241,8 +241,8 @@ msgid "" "XML_namespace>`__, tags and attributes with prefixes in the form ``prefix:" "sometag`` get expanded to ``{uri}sometag`` where the *prefix* is replaced by " "the full *URI*. Also, if there is a `default namespace `__, that full URI gets prepended " -"to all of the non-prefixed tags." +"TR/xml-names/#defaulting>`__, that full URI gets prepended to all of the non-" +"prefixed tags." msgstr "" #: ../Doc/library/xml.etree.elementtree.rst:303 diff --git a/library/zipapp.po b/library/zipapp.po index f0c800d4..76770a14 100644 --- a/library/zipapp.po +++ b/library/zipapp.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-04-02 22:11+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -249,7 +249,11 @@ msgid "" "archive fits in memory::" msgstr "" -#: ../Doc/library/zipapp.rst:210 +#: ../Doc/library/zipapp.rst:214 +msgid "Specifying the Interpreter" +msgstr "" + +#: ../Doc/library/zipapp.rst:216 msgid "" "Note that if you specify an interpreter and then distribute your application " "archive, you need to ensure that the interpreter used is portable. The " @@ -257,7 +261,7 @@ msgid "" "but there are other issues to consider:" msgstr "" -#: ../Doc/library/zipapp.rst:215 +#: ../Doc/library/zipapp.rst:221 msgid "" "If you use \"/usr/bin/env python\" (or other forms of the \"python\" " "command, such as \"/usr/bin/python\"), you need to consider that your users " @@ -265,25 +269,196 @@ msgid "" "to work under both versions." msgstr "" -#: ../Doc/library/zipapp.rst:219 +#: ../Doc/library/zipapp.rst:225 msgid "" "If you use an explicit version, for example \"/usr/bin/env python3\" your " "application will not work for users who do not have that version. (This may " "be what you want if you have not made your code Python 2 compatible)." msgstr "" -#: ../Doc/library/zipapp.rst:222 +#: ../Doc/library/zipapp.rst:228 msgid "" "There is no way to say \"python X.Y or later\", so be careful of using an " "exact version like \"/usr/bin/env python3.4\" as you will need to change " "your shebang line for users of Python 3.5, for example." msgstr "" -#: ../Doc/library/zipapp.rst:227 +#: ../Doc/library/zipapp.rst:232 +msgid "" +"Typically, you should use an \"/usr/bin/env python2\" or \"/usr/bin/env " +"python3\", depending on whether your code is written for Python 2 or 3." +msgstr "" + +#: ../Doc/library/zipapp.rst:237 +msgid "Creating Standalone Applications with zipapp" +msgstr "" + +#: ../Doc/library/zipapp.rst:239 +msgid "" +"Using the :mod:`zipapp` module, it is possible to create self-contained " +"Python programs, which can be distributed to end users who only need to have " +"a suitable version of Python installed on their system. The key to doing " +"this is to bundle all of the application's dependencies into the archive, " +"along with the application code." +msgstr "" + +#: ../Doc/library/zipapp.rst:245 +msgid "The steps to create a standalone archive are as follows:" +msgstr "" + +#: ../Doc/library/zipapp.rst:247 +msgid "" +"Create your application in a directory as normal, so you have a ``myapp`` " +"directory containing a ``__main__.py`` file, and any supporting application " +"code." +msgstr "" + +#: ../Doc/library/zipapp.rst:251 +msgid "" +"Install all of your application's dependencies into the ``myapp`` directory, " +"using pip:" +msgstr "" + +#: ../Doc/library/zipapp.rst:258 +msgid "" +"(this assumes you have your project requirements in a ``requirements.txt`` " +"file - if not, you can just list the dependencies manually on the pip " +"command line)." +msgstr "" + +#: ../Doc/library/zipapp.rst:262 +msgid "" +"Optionally, delete the ``.dist-info`` directories created by pip in the " +"``myapp`` directory. These hold metadata for pip to manage the packages, and " +"as you won't be making any further use of pip they aren't required - " +"although it won't do any harm if you leave them." +msgstr "" + +#: ../Doc/library/zipapp.rst:267 +msgid "Package the application using:" +msgstr "" + +#: ../Doc/library/zipapp.rst:273 +msgid "" +"This will produce a standalone executable, which can be run on any machine " +"with the appropriate interpreter available. See :ref:`zipapp-specifying-the-" +"interpreter` for details. It can be shipped to users as a single file." +msgstr "" + +#: ../Doc/library/zipapp.rst:277 +msgid "" +"On Unix, the ``myapp.pyz`` file is executable as it stands. You can rename " +"the file to remove the ``.pyz`` extension if you prefer a \"plain\" command " +"name. On Windows, the ``myapp.pyz[w]`` file is executable by virtue of the " +"fact that the Python interpreter registers the ``.pyz`` and ``.pyzw`` file " +"extensions when installed." +msgstr "" + +#: ../Doc/library/zipapp.rst:285 +msgid "Making a Windows executable" +msgstr "" + +#: ../Doc/library/zipapp.rst:287 +msgid "" +"On Windows, registration of the ``.pyz`` extension is optional, and " +"furthermore, there are certain places that don't recognise registered " +"extensions \"transparently\" (the simplest example is that ``subprocess." +"run(['myapp'])`` won't find your application - you need to explicitly " +"specify the extension)." +msgstr "" + +#: ../Doc/library/zipapp.rst:293 +msgid "" +"On Windows, therefore, it is often preferable to create an executable from " +"the zipapp. This is relatively easy, although it does require a C " +"compiler. The basic approach relies on the fact that zipfiles can have " +"arbitrary data prepended, and Windows exe files can have arbitrary data " +"appended. So by creating a suitable launcher and tacking the ``.pyz`` file " +"onto the end of it, you end up with a single-file executable that runs your " +"application." +msgstr "" + +#: ../Doc/library/zipapp.rst:300 +msgid "A suitable launcher can be as simple as the following::" +msgstr "" + +#: ../Doc/library/zipapp.rst:325 +msgid "" +"If you define the ``WINDOWS`` preprocessor symbol, this will generate a GUI " +"executable, and without it, a console executable." +msgstr "" + +#: ../Doc/library/zipapp.rst:328 +msgid "" +"To compile the executable, you can either just use the standard MSVC command " +"line tools, or you can take advantage of the fact that distutils knows how " +"to compile Python source::" +msgstr "" + +#: ../Doc/library/zipapp.rst:355 +msgid "" +"The resulting launcher uses the \"Limited ABI\", so it will run unchanged " +"with any version of Python 3.x. All it needs is for Python (``python3." +"dll``) to be on the user's ``PATH``." +msgstr "" + +#: ../Doc/library/zipapp.rst:359 +msgid "" +"For a fully standalone distribution, you can distribute the launcher with " +"your application appended, bundled with the Python \"embedded\" " +"distribution. This will run on any PC with the appropriate architecture (32 " +"bit or 64 bit)." +msgstr "" + +#: ../Doc/library/zipapp.rst:365 +msgid "Caveats" +msgstr "" + +#: ../Doc/library/zipapp.rst:367 +msgid "" +"There are some limitations to the process of bundling your application into " +"a single file. In most, if not all, cases they can be addressed without " +"needing major changes to your application." +msgstr "" + +#: ../Doc/library/zipapp.rst:371 +msgid "" +"If your application depends on a package that includes a C extension, that " +"package cannot be run from a zip file (this is an OS limitation, as " +"executable code must be present in the filesystem for the OS loader to load " +"it). In this case, you can exclude that dependency from the zipfile, and " +"either require your users to have it installed, or ship it alongside your " +"zipfile and add code to your ``__main__.py`` to include the directory " +"containing the unzipped module in ``sys.path``. In this case, you will need " +"to make sure to ship appropriate binaries for your target architecture(s) " +"(and potentially pick the correct version to add to ``sys.path`` at runtime, " +"based on the user's machine)." +msgstr "" + +#: ../Doc/library/zipapp.rst:381 +msgid "" +"If you are shipping a Windows executable as described above, you either need " +"to ensure that your users have ``python3.dll`` on their PATH (which is not " +"the default behaviour of the installer) or you should bundle your " +"application with the embedded distribution." +msgstr "" + +#: ../Doc/library/zipapp.rst:386 +msgid "" +"The suggested launcher above uses the Python embedding API. This means that " +"in your application, ``sys.executable`` will be your application, and *not* " +"a conventional Python interpreter. Your code and its dependencies need to " +"be prepared for this possibility. For example, if your application uses " +"the :mod:`multiprocessing` module, it will need to call :func:" +"`multiprocessing.set_executable` to let the module know where to find the " +"standard Python interpreter." +msgstr "" + +#: ../Doc/library/zipapp.rst:396 msgid "The Python Zip Application Archive Format" msgstr "" -#: ../Doc/library/zipapp.rst:229 +#: ../Doc/library/zipapp.rst:398 msgid "" "Python has been able to execute zip files which contain a ``__main__.py`` " "file since version 2.6. In order to be executed by Python, an application " @@ -294,18 +469,18 @@ msgid "" "the zip file." msgstr "" -#: ../Doc/library/zipapp.rst:236 +#: ../Doc/library/zipapp.rst:405 msgid "" "The zip file format allows arbitrary data to be prepended to a zip file. " "The zip application format uses this ability to prepend a standard POSIX " "\"shebang\" line to the file (``#!/path/to/interpreter``)." msgstr "" -#: ../Doc/library/zipapp.rst:240 +#: ../Doc/library/zipapp.rst:409 msgid "Formally, the Python zip application format is therefore:" msgstr "" -#: ../Doc/library/zipapp.rst:242 +#: ../Doc/library/zipapp.rst:411 msgid "" "An optional shebang line, containing the characters ``b'#!'`` followed by an " "interpreter name, and then a newline (``b'\\n'``) character. The " @@ -315,7 +490,7 @@ msgid "" "POSIX." msgstr "" -#: ../Doc/library/zipapp.rst:247 +#: ../Doc/library/zipapp.rst:416 msgid "" "Standard zipfile data, as generated by the :mod:`zipfile` module. The " "zipfile content *must* include a file called ``__main__.py`` (which must be " @@ -323,13 +498,13 @@ msgid "" "zipfile data can be compressed or uncompressed." msgstr "" -#: ../Doc/library/zipapp.rst:252 +#: ../Doc/library/zipapp.rst:421 msgid "" "If an application archive has a shebang line, it may have the executable bit " "set on POSIX systems, to allow it to be executed directly." msgstr "" -#: ../Doc/library/zipapp.rst:255 +#: ../Doc/library/zipapp.rst:424 msgid "" "There is no requirement that the tools in this module are used to create " "application archives - the module is a convenience, but archives in the " diff --git a/library/zlib.po b/library/zlib.po index 3d847def..76c4fa0b 100644 --- a/library/zlib.po +++ b/library/zlib.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-08-10 00:49+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -74,12 +74,12 @@ msgstr "" msgid "" "Compresses the bytes in *data*, returning a bytes object containing " "compressed data. *level* is an integer from ``0`` to ``9`` or ``-1`` " -"controlling the level of compression; ``1`` is fastest and produces the " -"least compression, ``9`` is slowest and produces the most. ``0`` is no " -"compression. The default value is ``-1`` (Z_DEFAULT_COMPRESSION). " -"Z_DEFAULT_COMPRESSION represents a default compromise between speed and " -"compression (currently equivalent to level 6). Raises the :exc:`error` " -"exception if any error occurs." +"controlling the level of compression; ``1`` (Z_BEST_SPEED) is fastest and " +"produces the least compression, ``9`` (Z_BEST_COMPRESSION) is slowest and " +"produces the most. ``0`` (Z_NO_COMPRESSION) is no compression. The default " +"value is ``-1`` (Z_DEFAULT_COMPRESSION). Z_DEFAULT_COMPRESSION represents a " +"default compromise between speed and compression (currently equivalent to " +"level 6). Raises the :exc:`error` exception if any error occurs." msgstr "" #: ../Doc/library/zlib.rst:60 @@ -95,27 +95,29 @@ msgstr "" #: ../Doc/library/zlib.rst:69 msgid "" "*level* is the compression level -- an integer from ``0`` to ``9`` or " -"``-1``. A value of ``1`` is fastest and produces the least compression, " -"while a value of ``9`` is slowest and produces the most. ``0`` is no " -"compression. The default value is ``-1`` (Z_DEFAULT_COMPRESSION). " -"Z_DEFAULT_COMPRESSION represents a default compromise between speed and " -"compression (currently equivalent to level 6)." +"``-1``. A value of ``1`` (Z_BEST_SPEED) is fastest and produces the least " +"compression, while a value of ``9`` (Z_BEST_COMPRESSION) is slowest and " +"produces the most. ``0`` (Z_NO_COMPRESSION) is no compression. The default " +"value is ``-1`` (Z_DEFAULT_COMPRESSION). Z_DEFAULT_COMPRESSION represents a " +"default compromise between speed and compression (currently equivalent to " +"level 6)." msgstr "" -#: ../Doc/library/zlib.rst:75 +#: ../Doc/library/zlib.rst:76 msgid "" "*method* is the compression algorithm. Currently, the only supported value " -"is ``DEFLATED``." +"is :const:`DEFLATED`." msgstr "" -#: ../Doc/library/zlib.rst:78 +#: ../Doc/library/zlib.rst:79 msgid "" "The *wbits* argument controls the size of the history buffer (or the " "\"window size\") used when compressing data, and whether a header and " -"trailer is included in the output. It can take several ranges of values:" +"trailer is included in the output. It can take several ranges of values, " +"defaulting to ``15`` (MAX_WBITS):" msgstr "" -#: ../Doc/library/zlib.rst:82 +#: ../Doc/library/zlib.rst:84 msgid "" "+9 to +15: The base-two logarithm of the window size, which therefore ranges " "between 512 and 32768. Larger values produce better compression at the " @@ -123,33 +125,34 @@ msgid "" "specific header and trailer." msgstr "" -#: ../Doc/library/zlib.rst:87 +#: ../Doc/library/zlib.rst:89 msgid "" "−9 to −15: Uses the absolute value of *wbits* as the window size logarithm, " "while producing a raw output stream with no header or trailing checksum." msgstr "" -#: ../Doc/library/zlib.rst:91 +#: ../Doc/library/zlib.rst:93 msgid "" "+25 to +31 = 16 + (9 to 15): Uses the low 4 bits of the value as the window " "size logarithm, while including a basic :program:`gzip` header and trailing " "checksum in the output." msgstr "" -#: ../Doc/library/zlib.rst:95 +#: ../Doc/library/zlib.rst:97 msgid "" "The *memLevel* argument controls the amount of memory used for the internal " "compression state. Valid values range from ``1`` to ``9``. Higher values use " "more memory, but are faster and produce smaller output." msgstr "" -#: ../Doc/library/zlib.rst:99 +#: ../Doc/library/zlib.rst:101 msgid "" -"*strategy* is used to tune the compression algorithm. Possible values are " -"``Z_DEFAULT_STRATEGY``, ``Z_FILTERED``, and ``Z_HUFFMAN_ONLY``." +"*strategy* is used to tune the compression algorithm. Possible values are :" +"const:`Z_DEFAULT_STRATEGY`, :const:`Z_FILTERED`, :const:`Z_HUFFMAN_ONLY`, :" +"const:`Z_RLE` (zlib 1.2.0.1) and :const:`Z_FIXED` (zlib 1.2.2.2)." msgstr "" -#: ../Doc/library/zlib.rst:102 +#: ../Doc/library/zlib.rst:105 msgid "" "*zdict* is a predefined compression dictionary. This is a sequence of bytes " "(such as a :class:`bytes` object) containing subsequences that are expected " @@ -157,11 +160,11 @@ msgid "" "that are expected to be most common should come at the end of the dictionary." msgstr "" -#: ../Doc/library/zlib.rst:107 +#: ../Doc/library/zlib.rst:110 msgid "Added the *zdict* parameter and keyword argument support." msgstr "" -#: ../Doc/library/zlib.rst:117 +#: ../Doc/library/zlib.rst:120 msgid "" "Computes a CRC (Cyclic Redundancy Check) checksum of *data*. The result is " "an unsigned 32-bit integer. If *value* is present, it is used as the " @@ -173,13 +176,13 @@ msgid "" "suitable for use as a general hash algorithm." msgstr "" -#: ../Doc/library/zlib.rst:126 +#: ../Doc/library/zlib.rst:129 msgid "" "Always returns an unsigned value. To generate the same numeric value across " "all Python versions and platforms, use ``crc32(data) & 0xffffffff``." msgstr "" -#: ../Doc/library/zlib.rst:134 +#: ../Doc/library/zlib.rst:137 msgid "" "Decompresses the bytes in *data*, returning a bytes object containing the " "uncompressed data. The *wbits* parameter depends on the format of *data*, " @@ -188,44 +191,44 @@ msgid "" "error occurs." msgstr "" -#: ../Doc/library/zlib.rst:142 +#: ../Doc/library/zlib.rst:145 msgid "" "The *wbits* parameter controls the size of the history buffer (or \"window " "size\"), and what header and trailer format is expected. It is similar to " "the parameter for :func:`compressobj`, but accepts more ranges of values:" msgstr "" -#: ../Doc/library/zlib.rst:147 +#: ../Doc/library/zlib.rst:150 msgid "" "+8 to +15: The base-two logarithm of the window size. The input must " "include a zlib header and trailer." msgstr "" -#: ../Doc/library/zlib.rst:150 +#: ../Doc/library/zlib.rst:153 msgid "" "0: Automatically determine the window size from the zlib header. Only " "supported since zlib 1.2.3.5." msgstr "" -#: ../Doc/library/zlib.rst:153 +#: ../Doc/library/zlib.rst:156 msgid "" "−8 to −15: Uses the absolute value of *wbits* as the window size logarithm. " "The input must be a raw stream with no header or trailer." msgstr "" -#: ../Doc/library/zlib.rst:156 +#: ../Doc/library/zlib.rst:159 msgid "" "+24 to +31 = 16 + (8 to 15): Uses the low 4 bits of the value as the window " "size logarithm. The input must include a gzip header and trailer." msgstr "" -#: ../Doc/library/zlib.rst:160 +#: ../Doc/library/zlib.rst:163 msgid "" "+40 to +47 = 32 + (8 to 15): Uses the low 4 bits of the value as the window " "size logarithm, and automatically accepts either the zlib or gzip format." msgstr "" -#: ../Doc/library/zlib.rst:164 +#: ../Doc/library/zlib.rst:167 msgid "" "When decompressing a stream, the window size must not be smaller than the " "size originally used to compress the stream; using a too-small value may " @@ -234,7 +237,7 @@ msgid "" "included." msgstr "" -#: ../Doc/library/zlib.rst:170 +#: ../Doc/library/zlib.rst:173 msgid "" "*bufsize* is the initial size of the buffer used to hold decompressed data. " "If more space is required, the buffer size will be increased as needed, so " @@ -242,46 +245,46 @@ msgid "" "few calls to :c:func:`malloc`." msgstr "" -#: ../Doc/library/zlib.rst:175 +#: ../Doc/library/zlib.rst:178 msgid "*wbits* and *bufsize* can be used as keyword arguments." msgstr "" -#: ../Doc/library/zlib.rst:180 +#: ../Doc/library/zlib.rst:183 msgid "" "Returns a decompression object, to be used for decompressing data streams " "that won't fit into memory at once." msgstr "" -#: ../Doc/library/zlib.rst:183 +#: ../Doc/library/zlib.rst:186 msgid "" "The *wbits* parameter controls the size of the history buffer (or the " "\"window size\"), and what header and trailer format is expected. It has " "the same meaning as `described for decompress() <#decompress-wbits>`__." msgstr "" -#: ../Doc/library/zlib.rst:187 +#: ../Doc/library/zlib.rst:190 msgid "" "The *zdict* parameter specifies a predefined compression dictionary. If " "provided, this must be the same dictionary as was used by the compressor " "that produced the data that is to be decompressed." msgstr "" -#: ../Doc/library/zlib.rst:193 +#: ../Doc/library/zlib.rst:196 msgid "" "If *zdict* is a mutable object (such as a :class:`bytearray`), you must not " "modify its contents between the call to :func:`decompressobj` and the first " "call to the decompressor's ``decompress()`` method." msgstr "" -#: ../Doc/library/zlib.rst:197 +#: ../Doc/library/zlib.rst:200 msgid "Added the *zdict* parameter." msgstr "" -#: ../Doc/library/zlib.rst:201 +#: ../Doc/library/zlib.rst:204 msgid "Compression objects support the following methods:" msgstr "" -#: ../Doc/library/zlib.rst:206 +#: ../Doc/library/zlib.rst:209 msgid "" "Compress *data*, returning a bytes object containing compressed data for at " "least part of the data in *data*. This data should be concatenated to the " @@ -289,30 +292,31 @@ msgid "" "input may be kept in internal buffers for later processing." msgstr "" -#: ../Doc/library/zlib.rst:214 +#: ../Doc/library/zlib.rst:217 msgid "" "All pending input is processed, and a bytes object containing the remaining " "compressed output is returned. *mode* can be selected from the constants :" -"const:`Z_SYNC_FLUSH`, :const:`Z_FULL_FLUSH`, or :const:`Z_FINISH`, " -"defaulting to :const:`Z_FINISH`. :const:`Z_SYNC_FLUSH` and :const:" -"`Z_FULL_FLUSH` allow compressing further bytestrings of data, while :const:" -"`Z_FINISH` finishes the compressed stream and prevents compressing any more " -"data. After calling :meth:`flush` with *mode* set to :const:`Z_FINISH`, " -"the :meth:`compress` method cannot be called again; the only realistic " -"action is to delete the object." +"const:`Z_NO_FLUSH`, :const:`Z_PARTIAL_FLUSH`, :const:`Z_SYNC_FLUSH`, :const:" +"`Z_FULL_FLUSH`, :const:`Z_BLOCK` (zlib 1.2.3.4), or :const:`Z_FINISH`, " +"defaulting to :const:`Z_FINISH`. Except :const:`Z_FINISH`, all constants " +"allow compressing further bytestrings of data, while :const:`Z_FINISH` " +"finishes the compressed stream and prevents compressing any more data. " +"After calling :meth:`flush` with *mode* set to :const:`Z_FINISH`, the :meth:" +"`compress` method cannot be called again; the only realistic action is to " +"delete the object." msgstr "" -#: ../Doc/library/zlib.rst:227 +#: ../Doc/library/zlib.rst:230 msgid "" "Returns a copy of the compression object. This can be used to efficiently " "compress a set of data that share a common initial prefix." msgstr "" -#: ../Doc/library/zlib.rst:231 +#: ../Doc/library/zlib.rst:234 msgid "Decompression objects support the following methods and attributes:" msgstr "" -#: ../Doc/library/zlib.rst:236 +#: ../Doc/library/zlib.rst:239 msgid "" "A bytes object which contains any bytes past the end of the compressed data. " "That is, this remains ``b\"\"`` until the last byte that contains " @@ -320,7 +324,7 @@ msgid "" "contain compressed data, this is ``b\"\"``, an empty bytes object." msgstr "" -#: ../Doc/library/zlib.rst:244 +#: ../Doc/library/zlib.rst:247 msgid "" "A bytes object that contains any data that was not consumed by the last :" "meth:`decompress` call because it exceeded the limit for the uncompressed " @@ -329,19 +333,19 @@ msgid "" "subsequent :meth:`decompress` method call in order to get correct output." msgstr "" -#: ../Doc/library/zlib.rst:253 +#: ../Doc/library/zlib.rst:256 msgid "" "A boolean indicating whether the end of the compressed data stream has been " "reached." msgstr "" -#: ../Doc/library/zlib.rst:256 +#: ../Doc/library/zlib.rst:259 msgid "" "This makes it possible to distinguish between a properly-formed compressed " "stream, and an incomplete or truncated one." msgstr "" -#: ../Doc/library/zlib.rst:264 +#: ../Doc/library/zlib.rst:267 msgid "" "Decompress *data*, returning a bytes object containing the uncompressed data " "corresponding to at least part of the data in *string*. This data should be " @@ -350,7 +354,7 @@ msgid "" "buffers for later processing." msgstr "" -#: ../Doc/library/zlib.rst:270 +#: ../Doc/library/zlib.rst:273 msgid "" "If the optional parameter *max_length* is non-zero then the return value " "will be no longer than *max_length*. This may mean that not all of the " @@ -361,11 +365,11 @@ msgid "" "`unconsumed_tail` is empty." msgstr "" -#: ../Doc/library/zlib.rst:277 +#: ../Doc/library/zlib.rst:280 msgid "*max_length* can be used as a keyword argument." msgstr "" -#: ../Doc/library/zlib.rst:283 +#: ../Doc/library/zlib.rst:286 msgid "" "All pending input is processed, and a bytes object containing the remaining " "uncompressed output is returned. After calling :meth:`flush`, the :meth:" @@ -373,57 +377,57 @@ msgid "" "delete the object." msgstr "" -#: ../Doc/library/zlib.rst:288 +#: ../Doc/library/zlib.rst:291 msgid "" "The optional parameter *length* sets the initial size of the output buffer." msgstr "" -#: ../Doc/library/zlib.rst:293 +#: ../Doc/library/zlib.rst:296 msgid "" "Returns a copy of the decompression object. This can be used to save the " "state of the decompressor midway through the data stream in order to speed " "up random seeks into the stream at a future point." msgstr "" -#: ../Doc/library/zlib.rst:298 +#: ../Doc/library/zlib.rst:301 msgid "" "Information about the version of the zlib library in use is available " "through the following constants:" msgstr "" -#: ../Doc/library/zlib.rst:304 +#: ../Doc/library/zlib.rst:307 msgid "" "The version string of the zlib library that was used for building the " "module. This may be different from the zlib library actually used at " "runtime, which is available as :const:`ZLIB_RUNTIME_VERSION`." msgstr "" -#: ../Doc/library/zlib.rst:311 +#: ../Doc/library/zlib.rst:314 msgid "" "The version string of the zlib library actually loaded by the interpreter." msgstr "" -#: ../Doc/library/zlib.rst:319 +#: ../Doc/library/zlib.rst:322 msgid "Module :mod:`gzip`" msgstr "" -#: ../Doc/library/zlib.rst:319 +#: ../Doc/library/zlib.rst:322 msgid "Reading and writing :program:`gzip`\\ -format files." msgstr "" -#: ../Doc/library/zlib.rst:322 +#: ../Doc/library/zlib.rst:325 msgid "http://www.zlib.net" msgstr "" -#: ../Doc/library/zlib.rst:322 +#: ../Doc/library/zlib.rst:325 msgid "The zlib library home page." msgstr "" -#: ../Doc/library/zlib.rst:325 +#: ../Doc/library/zlib.rst:328 msgid "http://www.zlib.net/manual.html" msgstr "" -#: ../Doc/library/zlib.rst:325 +#: ../Doc/library/zlib.rst:328 msgid "" "The zlib manual explains the semantics and usage of the library's many " "functions." diff --git a/reference/datamodel.po b/reference/datamodel.po index 7c0aacf6..cbe6be7a 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-02-08 09:58+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2018-02-15 00:51+0100\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -1920,21 +1920,16 @@ msgstr "__slots__" #: ../Doc/reference/datamodel.rst:1656 msgid "" -"By default, instances of classes have a dictionary for attribute storage. " -"This wastes space for objects having very few instance variables. The space " -"consumption can become acute when creating large numbers of instances." +"*__slots__* allow us to explicitly declare data members (like properties) " +"and deny the creation of *__dict__* and *__weakref__* (unless explicitly " +"declared in *__slots__* or available in a parent.)" msgstr "" #: ../Doc/reference/datamodel.rst:1660 -msgid "" -"The default can be overridden by defining *__slots__* in a class definition. " -"The *__slots__* declaration takes a sequence of instance variables and " -"reserves just enough space in each instance to hold a value for each " -"variable. Space is saved because *__dict__* is not created for each " -"instance." +msgid "The space saved over using *__dict__* can be significant." msgstr "" -#: ../Doc/reference/datamodel.rst:1668 +#: ../Doc/reference/datamodel.rst:1664 msgid "" "This class variable can be assigned a string, iterable, or sequence of " "strings with variable names used by instances. *__slots__* reserves space " @@ -1942,18 +1937,17 @@ msgid "" "and *__weakref__* for each instance." msgstr "" -#: ../Doc/reference/datamodel.rst:1675 +#: ../Doc/reference/datamodel.rst:1671 msgid "Notes on using *__slots__*" msgstr "" -#: ../Doc/reference/datamodel.rst:1677 +#: ../Doc/reference/datamodel.rst:1673 msgid "" -"When inheriting from a class without *__slots__*, the *__dict__* attribute " -"of that class will always be accessible, so a *__slots__* definition in the " -"subclass is meaningless." +"When inheriting from a class without *__slots__*, the *__dict__* and " +"*__weakref__* attribute of the instances will always be accessible." msgstr "" -#: ../Doc/reference/datamodel.rst:1681 +#: ../Doc/reference/datamodel.rst:1676 msgid "" "Without a *__dict__* variable, instances cannot be assigned new variables " "not listed in the *__slots__* definition. Attempts to assign to an unlisted " @@ -1962,7 +1956,7 @@ msgid "" "the *__slots__* declaration." msgstr "" -#: ../Doc/reference/datamodel.rst:1687 +#: ../Doc/reference/datamodel.rst:1682 msgid "" "Without a *__weakref__* variable for each instance, classes defining " "*__slots__* do not support weak references to its instances. If weak " @@ -1970,7 +1964,7 @@ msgid "" "strings in the *__slots__* declaration." msgstr "" -#: ../Doc/reference/datamodel.rst:1692 +#: ../Doc/reference/datamodel.rst:1687 msgid "" "*__slots__* are implemented at the class level by creating descriptors (:ref:" "`descriptors`) for each variable name. As a result, class attributes cannot " @@ -1978,14 +1972,16 @@ msgid "" "otherwise, the class attribute would overwrite the descriptor assignment." msgstr "" -#: ../Doc/reference/datamodel.rst:1698 +#: ../Doc/reference/datamodel.rst:1693 msgid "" -"The action of a *__slots__* declaration is limited to the class where it is " -"defined. As a result, subclasses will have a *__dict__* unless they also " -"define *__slots__* (which must only contain names of any *additional* slots)." +"The action of a *__slots__* declaration is not limited to the class where it " +"is defined. *__slots__* declared in parents are available in child classes. " +"However, child subclasses will get a *__dict__* and *__weakref__* unless " +"they also define *__slots__* (which should only contain names of any " +"*additional* slots)." msgstr "" -#: ../Doc/reference/datamodel.rst:1702 +#: ../Doc/reference/datamodel.rst:1699 msgid "" "If a class defines a slot also defined in a base class, the instance " "variable defined by the base class slot is inaccessible (except by " @@ -1994,29 +1990,36 @@ msgid "" "prevent this." msgstr "" -#: ../Doc/reference/datamodel.rst:1707 +#: ../Doc/reference/datamodel.rst:1704 msgid "" "Nonempty *__slots__* does not work for classes derived from \"variable-length" "\" built-in types such as :class:`int`, :class:`bytes` and :class:`tuple`." msgstr "" -#: ../Doc/reference/datamodel.rst:1710 +#: ../Doc/reference/datamodel.rst:1707 msgid "" "Any non-string iterable may be assigned to *__slots__*. Mappings may also be " "used; however, in the future, special meaning may be assigned to the values " "corresponding to each key." msgstr "" -#: ../Doc/reference/datamodel.rst:1714 +#: ../Doc/reference/datamodel.rst:1711 msgid "" "*__class__* assignment works only if both classes have the same *__slots__*." msgstr "" -#: ../Doc/reference/datamodel.rst:1720 +#: ../Doc/reference/datamodel.rst:1713 +msgid "" +"Multiple inheritance with multiple slotted parent classes can be used, but " +"only one parent is allowed to have attributes created by slots (the other " +"bases must have empty slot layouts) - violations raise :exc:`TypeError`." +msgstr "" + +#: ../Doc/reference/datamodel.rst:1721 msgid "Customizing class creation" msgstr "" -#: ../Doc/reference/datamodel.rst:1722 +#: ../Doc/reference/datamodel.rst:1723 msgid "" "Whenever a class inherits from another class, *__init_subclass__* is called " "on that class. This way, it is possible to write classes which change the " @@ -2026,14 +2029,14 @@ msgid "" "defining the method." msgstr "" -#: ../Doc/reference/datamodel.rst:1731 +#: ../Doc/reference/datamodel.rst:1732 msgid "" "This method is called whenever the containing class is subclassed. *cls* is " "then the new subclass. If defined as a normal instance method, this method " "is implicitly converted to a class method." msgstr "" -#: ../Doc/reference/datamodel.rst:1735 +#: ../Doc/reference/datamodel.rst:1736 msgid "" "Keyword arguments which are given to a new class are passed to the parent's " "class ``__init_subclass__``. For compatibility with other classes using " @@ -2041,13 +2044,13 @@ msgid "" "pass the others over to the base class, as in::" msgstr "" -#: ../Doc/reference/datamodel.rst:1749 +#: ../Doc/reference/datamodel.rst:1750 msgid "" "The default implementation ``object.__init_subclass__`` does nothing, but " "raises an error if it is called with any arguments." msgstr "" -#: ../Doc/reference/datamodel.rst:1754 +#: ../Doc/reference/datamodel.rst:1755 msgid "" "The metaclass hint ``metaclass`` is consumed by the rest of the type " "machinery, and is never passed to ``__init_subclass__`` implementations. The " @@ -2055,18 +2058,18 @@ msgid "" "``type(cls)``." msgstr "" -#: ../Doc/reference/datamodel.rst:1765 +#: ../Doc/reference/datamodel.rst:1766 msgid "Metaclasses" msgstr "" -#: ../Doc/reference/datamodel.rst:1771 +#: ../Doc/reference/datamodel.rst:1772 msgid "" "By default, classes are constructed using :func:`type`. The class body is " "executed in a new namespace and the class name is bound locally to the " "result of ``type(name, bases, namespace)``." msgstr "" -#: ../Doc/reference/datamodel.rst:1775 +#: ../Doc/reference/datamodel.rst:1776 msgid "" "The class creation process can be customized by passing the ``metaclass`` " "keyword argument in the class definition line, or by inheriting from an " @@ -2074,59 +2077,59 @@ msgid "" "both ``MyClass`` and ``MySubclass`` are instances of ``Meta``::" msgstr "" -#: ../Doc/reference/datamodel.rst:1789 +#: ../Doc/reference/datamodel.rst:1790 msgid "" "Any other keyword arguments that are specified in the class definition are " "passed through to all metaclass operations described below." msgstr "" -#: ../Doc/reference/datamodel.rst:1792 +#: ../Doc/reference/datamodel.rst:1793 msgid "When a class definition is executed, the following steps occur:" msgstr "" -#: ../Doc/reference/datamodel.rst:1794 +#: ../Doc/reference/datamodel.rst:1795 msgid "the appropriate metaclass is determined" msgstr "" -#: ../Doc/reference/datamodel.rst:1795 +#: ../Doc/reference/datamodel.rst:1796 msgid "the class namespace is prepared" msgstr "" -#: ../Doc/reference/datamodel.rst:1796 +#: ../Doc/reference/datamodel.rst:1797 msgid "the class body is executed" msgstr "" -#: ../Doc/reference/datamodel.rst:1797 +#: ../Doc/reference/datamodel.rst:1798 msgid "the class object is created" msgstr "" -#: ../Doc/reference/datamodel.rst:1800 +#: ../Doc/reference/datamodel.rst:1801 msgid "Determining the appropriate metaclass" msgstr "" -#: ../Doc/reference/datamodel.rst:1804 +#: ../Doc/reference/datamodel.rst:1805 msgid "" "The appropriate metaclass for a class definition is determined as follows:" msgstr "" -#: ../Doc/reference/datamodel.rst:1806 +#: ../Doc/reference/datamodel.rst:1807 msgid "" "if no bases and no explicit metaclass are given, then :func:`type` is used" msgstr "" -#: ../Doc/reference/datamodel.rst:1807 +#: ../Doc/reference/datamodel.rst:1808 msgid "" "if an explicit metaclass is given and it is *not* an instance of :func:" "`type`, then it is used directly as the metaclass" msgstr "" -#: ../Doc/reference/datamodel.rst:1809 +#: ../Doc/reference/datamodel.rst:1810 msgid "" "if an instance of :func:`type` is given as the explicit metaclass, or bases " "are defined, then the most derived metaclass is used" msgstr "" -#: ../Doc/reference/datamodel.rst:1812 +#: ../Doc/reference/datamodel.rst:1813 msgid "" "The most derived metaclass is selected from the explicitly specified " "metaclass (if any) and the metaclasses (i.e. ``type(cls)``) of all specified " @@ -2135,11 +2138,11 @@ msgid "" "that criterion, then the class definition will fail with ``TypeError``." msgstr "" -#: ../Doc/reference/datamodel.rst:1822 +#: ../Doc/reference/datamodel.rst:1823 msgid "Preparing the class namespace" msgstr "" -#: ../Doc/reference/datamodel.rst:1827 +#: ../Doc/reference/datamodel.rst:1828 msgid "" "Once the appropriate metaclass has been identified, then the class namespace " "is prepared. If the metaclass has a ``__prepare__`` attribute, it is called " @@ -2147,25 +2150,25 @@ msgid "" "additional keyword arguments, if any, come from the class definition)." msgstr "" -#: ../Doc/reference/datamodel.rst:1832 +#: ../Doc/reference/datamodel.rst:1833 msgid "" "If the metaclass has no ``__prepare__`` attribute, then the class namespace " "is initialised as an empty ordered mapping." msgstr "" -#: ../Doc/reference/datamodel.rst:1837 +#: ../Doc/reference/datamodel.rst:1838 msgid ":pep:`3115` - Metaclasses in Python 3000" msgstr "" -#: ../Doc/reference/datamodel.rst:1838 +#: ../Doc/reference/datamodel.rst:1839 msgid "Introduced the ``__prepare__`` namespace hook" msgstr "" -#: ../Doc/reference/datamodel.rst:1842 +#: ../Doc/reference/datamodel.rst:1843 msgid "Executing the class body" msgstr "" -#: ../Doc/reference/datamodel.rst:1847 +#: ../Doc/reference/datamodel.rst:1848 msgid "" "The class body is executed (approximately) as ``exec(body, globals(), " "namespace)``. The key difference from a normal call to :func:`exec` is that " @@ -2174,7 +2177,7 @@ msgid "" "inside a function." msgstr "" -#: ../Doc/reference/datamodel.rst:1853 +#: ../Doc/reference/datamodel.rst:1854 msgid "" "However, even when the class definition occurs inside the function, methods " "defined inside the class still cannot see names defined at the class scope. " @@ -2183,11 +2186,11 @@ msgid "" "reference described in the next section." msgstr "" -#: ../Doc/reference/datamodel.rst:1862 +#: ../Doc/reference/datamodel.rst:1863 msgid "Creating the class object" msgstr "" -#: ../Doc/reference/datamodel.rst:1869 +#: ../Doc/reference/datamodel.rst:1870 msgid "" "Once the class namespace has been populated by executing the class body, the " "class object is created by calling ``metaclass(name, bases, namespace, " @@ -2195,7 +2198,7 @@ msgid "" "to ``__prepare__``)." msgstr "" -#: ../Doc/reference/datamodel.rst:1874 +#: ../Doc/reference/datamodel.rst:1875 msgid "" "This class object is the one that will be referenced by the zero-argument " "form of :func:`super`. ``__class__`` is an implicit closure reference " @@ -2206,7 +2209,7 @@ msgid "" "is identified based on the first argument passed to the method." msgstr "" -#: ../Doc/reference/datamodel.rst:1884 +#: ../Doc/reference/datamodel.rst:1885 msgid "" "In CPython 3.6 and later, the ``__class__`` cell is passed to the metaclass " "as a ``__classcell__`` entry in the class namespace. If present, this must " @@ -2216,39 +2219,39 @@ msgid "" "future." msgstr "" -#: ../Doc/reference/datamodel.rst:1891 +#: ../Doc/reference/datamodel.rst:1892 msgid "" "When using the default metaclass :class:`type`, or any metaclass that " "ultimately calls ``type.__new__``, the following additional customisation " "steps are invoked after creating the class object:" msgstr "" -#: ../Doc/reference/datamodel.rst:1895 +#: ../Doc/reference/datamodel.rst:1896 msgid "" "first, ``type.__new__`` collects all of the descriptors in the class " "namespace that define a :meth:`~object.__set_name__` method;" msgstr "" -#: ../Doc/reference/datamodel.rst:1897 +#: ../Doc/reference/datamodel.rst:1898 msgid "" "second, all of these ``__set_name__`` methods are called with the class " "being defined and the assigned name of that particular descriptor; and" msgstr "" -#: ../Doc/reference/datamodel.rst:1899 +#: ../Doc/reference/datamodel.rst:1900 msgid "" "finally, the :meth:`~object.__init_subclass__` hook is called on the " "immediate parent of the new class in its method resolution order." msgstr "" -#: ../Doc/reference/datamodel.rst:1902 +#: ../Doc/reference/datamodel.rst:1903 msgid "" "After the class object is created, it is passed to the class decorators " "included in the class definition (if any) and the resulting object is bound " "in the local namespace as the defined class." msgstr "" -#: ../Doc/reference/datamodel.rst:1906 +#: ../Doc/reference/datamodel.rst:1907 msgid "" "When a new class is created by ``type.__new__``, the object provided as the " "namespace parameter is copied to a new ordered mapping and the original " @@ -2256,19 +2259,19 @@ msgid "" "becomes the :attr:`~object.__dict__` attribute of the class object." msgstr "" -#: ../Doc/reference/datamodel.rst:1913 +#: ../Doc/reference/datamodel.rst:1914 msgid ":pep:`3135` - New super" msgstr "" -#: ../Doc/reference/datamodel.rst:1914 +#: ../Doc/reference/datamodel.rst:1915 msgid "Describes the implicit ``__class__`` closure reference" msgstr "" -#: ../Doc/reference/datamodel.rst:1918 +#: ../Doc/reference/datamodel.rst:1919 msgid "Metaclass example" msgstr "" -#: ../Doc/reference/datamodel.rst:1920 +#: ../Doc/reference/datamodel.rst:1921 msgid "" "The potential uses for metaclasses are boundless. Some ideas that have been " "explored include enum, logging, interface checking, automatic delegation, " @@ -2276,13 +2279,13 @@ msgid "" "locking/synchronization." msgstr "" -#: ../Doc/reference/datamodel.rst:1925 +#: ../Doc/reference/datamodel.rst:1926 msgid "" "Here is an example of a metaclass that uses an :class:`collections." "OrderedDict` to remember the order that class variables are defined::" msgstr "" -#: ../Doc/reference/datamodel.rst:1948 +#: ../Doc/reference/datamodel.rst:1949 msgid "" "When the class definition for *A* gets executed, the process begins with " "calling the metaclass's :meth:`__prepare__` method which returns an empty :" @@ -2294,17 +2297,17 @@ msgid "" "an attribute called ``members``." msgstr "" -#: ../Doc/reference/datamodel.rst:1959 +#: ../Doc/reference/datamodel.rst:1960 msgid "Customizing instance and subclass checks" msgstr "" -#: ../Doc/reference/datamodel.rst:1961 +#: ../Doc/reference/datamodel.rst:1962 msgid "" "The following methods are used to override the default behavior of the :func:" "`isinstance` and :func:`issubclass` built-in functions." msgstr "" -#: ../Doc/reference/datamodel.rst:1964 +#: ../Doc/reference/datamodel.rst:1965 msgid "" "In particular, the metaclass :class:`abc.ABCMeta` implements these methods " "in order to allow the addition of Abstract Base Classes (ABCs) as \"virtual " @@ -2312,21 +2315,21 @@ msgid "" "other ABCs." msgstr "" -#: ../Doc/reference/datamodel.rst:1971 +#: ../Doc/reference/datamodel.rst:1972 msgid "" "Return true if *instance* should be considered a (direct or indirect) " "instance of *class*. If defined, called to implement ``isinstance(instance, " "class)``." msgstr "" -#: ../Doc/reference/datamodel.rst:1978 +#: ../Doc/reference/datamodel.rst:1979 msgid "" "Return true if *subclass* should be considered a (direct or indirect) " "subclass of *class*. If defined, called to implement ``issubclass(subclass, " "class)``." msgstr "" -#: ../Doc/reference/datamodel.rst:1983 +#: ../Doc/reference/datamodel.rst:1984 msgid "" "Note that these methods are looked up on the type (metaclass) of a class. " "They cannot be defined as class methods in the actual class. This is " @@ -2334,11 +2337,11 @@ msgid "" "only in this case the instance is itself a class." msgstr "" -#: ../Doc/reference/datamodel.rst:1994 +#: ../Doc/reference/datamodel.rst:1995 msgid ":pep:`3119` - Introducing Abstract Base Classes" msgstr "" -#: ../Doc/reference/datamodel.rst:1991 +#: ../Doc/reference/datamodel.rst:1992 msgid "" "Includes the specification for customizing :func:`isinstance` and :func:" "`issubclass` behavior through :meth:`~class.__instancecheck__` and :meth:" @@ -2347,22 +2350,22 @@ msgid "" "language." msgstr "" -#: ../Doc/reference/datamodel.rst:2001 +#: ../Doc/reference/datamodel.rst:2002 msgid "Emulating callable objects" msgstr "" -#: ../Doc/reference/datamodel.rst:2008 +#: ../Doc/reference/datamodel.rst:2009 msgid "" "Called when the instance is \"called\" as a function; if this method is " "defined, ``x(arg1, arg2, ...)`` is a shorthand for ``x.__call__(arg1, " "arg2, ...)``." msgstr "" -#: ../Doc/reference/datamodel.rst:2015 +#: ../Doc/reference/datamodel.rst:2016 msgid "Emulating container types" msgstr "" -#: ../Doc/reference/datamodel.rst:2017 +#: ../Doc/reference/datamodel.rst:2018 msgid "" "The following methods can be defined to implement container objects. " "Containers usually are sequences (such as lists or tuples) or mappings (like " @@ -2395,7 +2398,7 @@ msgid "" "iterate through the values." msgstr "" -#: ../Doc/reference/datamodel.rst:2052 +#: ../Doc/reference/datamodel.rst:2053 msgid "" "Called to implement the built-in function :func:`len`. Should return the " "length of the object, an integer ``>=`` 0. Also, an object that doesn't " @@ -2403,7 +2406,7 @@ msgid "" "zero is considered to be false in a Boolean context." msgstr "" -#: ../Doc/reference/datamodel.rst:2059 +#: ../Doc/reference/datamodel.rst:2060 msgid "" "In CPython, the length is required to be at most :attr:`sys.maxsize`. If the " "length is larger than :attr:`!sys.maxsize` some features (such as :func:" @@ -2412,7 +2415,7 @@ msgid "" "`__bool__` method." msgstr "" -#: ../Doc/reference/datamodel.rst:2068 +#: ../Doc/reference/datamodel.rst:2069 msgid "" "Called to implement :func:`operator.length_hint`. Should return an estimated " "length for the object (which may be greater or less than the actual length). " @@ -2420,20 +2423,20 @@ msgid "" "optimization and is never required for correctness." msgstr "" -#: ../Doc/reference/datamodel.rst:2078 +#: ../Doc/reference/datamodel.rst:2079 msgid "" "Slicing is done exclusively with the following three methods. A call like ::" msgstr "" -#: ../Doc/reference/datamodel.rst:2082 +#: ../Doc/reference/datamodel.rst:2083 msgid "is translated to ::" msgstr "" -#: ../Doc/reference/datamodel.rst:2086 +#: ../Doc/reference/datamodel.rst:2087 msgid "and so forth. Missing slice items are always filled in with ``None``." msgstr "" -#: ../Doc/reference/datamodel.rst:2093 +#: ../Doc/reference/datamodel.rst:2094 msgid "" "Called to implement evaluation of ``self[key]``. For sequence types, the " "accepted keys should be integers and slice objects. Note that the special " @@ -2445,19 +2448,19 @@ msgid "" "*key* is missing (not in the container), :exc:`KeyError` should be raised." msgstr "" -#: ../Doc/reference/datamodel.rst:2104 +#: ../Doc/reference/datamodel.rst:2105 msgid "" ":keyword:`for` loops expect that an :exc:`IndexError` will be raised for " "illegal indexes to allow proper detection of the end of the sequence." msgstr "" -#: ../Doc/reference/datamodel.rst:2110 +#: ../Doc/reference/datamodel.rst:2111 msgid "" "Called by :class:`dict`\\ .\\ :meth:`__getitem__` to implement ``self[key]`` " "for dict subclasses when key is not in the dictionary." msgstr "" -#: ../Doc/reference/datamodel.rst:2116 +#: ../Doc/reference/datamodel.rst:2117 msgid "" "Called to implement assignment to ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -2466,7 +2469,7 @@ msgid "" "for improper *key* values as for the :meth:`__getitem__` method." msgstr "" -#: ../Doc/reference/datamodel.rst:2125 +#: ../Doc/reference/datamodel.rst:2126 msgid "" "Called to implement deletion of ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -2475,7 +2478,7 @@ msgid "" "values as for the :meth:`__getitem__` method." msgstr "" -#: ../Doc/reference/datamodel.rst:2134 +#: ../Doc/reference/datamodel.rst:2135 msgid "" "This method is called when an iterator is required for a container. This " "method should return a new iterator object that can iterate over all the " @@ -2483,21 +2486,21 @@ msgid "" "the container." msgstr "" -#: ../Doc/reference/datamodel.rst:2138 +#: ../Doc/reference/datamodel.rst:2139 msgid "" "Iterator objects also need to implement this method; they are required to " "return themselves. For more information on iterator objects, see :ref:" "`typeiter`." msgstr "" -#: ../Doc/reference/datamodel.rst:2144 +#: ../Doc/reference/datamodel.rst:2145 msgid "" "Called (if present) by the :func:`reversed` built-in to implement reverse " "iteration. It should return a new iterator object that iterates over all " "the objects in the container in reverse order." msgstr "" -#: ../Doc/reference/datamodel.rst:2148 +#: ../Doc/reference/datamodel.rst:2149 msgid "" "If the :meth:`__reversed__` method is not provided, the :func:`reversed` " "built-in will fall back to using the sequence protocol (:meth:`__len__` and :" @@ -2506,7 +2509,7 @@ msgid "" "more efficient than the one provided by :func:`reversed`." msgstr "" -#: ../Doc/reference/datamodel.rst:2155 +#: ../Doc/reference/datamodel.rst:2156 msgid "" "The membership test operators (:keyword:`in` and :keyword:`not in`) are " "normally implemented as an iteration through a sequence. However, container " @@ -2514,14 +2517,14 @@ msgid "" "implementation, which also does not require the object be a sequence." msgstr "" -#: ../Doc/reference/datamodel.rst:2162 +#: ../Doc/reference/datamodel.rst:2163 msgid "" "Called to implement membership test operators. Should return true if *item* " "is in *self*, false otherwise. For mapping objects, this should consider " "the keys of the mapping rather than the values or the key-item pairs." msgstr "" -#: ../Doc/reference/datamodel.rst:2166 +#: ../Doc/reference/datamodel.rst:2167 msgid "" "For objects that don't define :meth:`__contains__`, the membership test " "first tries iteration via :meth:`__iter__`, then the old sequence iteration " @@ -2529,11 +2532,11 @@ msgid "" "reference `." msgstr "" -#: ../Doc/reference/datamodel.rst:2175 +#: ../Doc/reference/datamodel.rst:2176 msgid "Emulating numeric types" msgstr "" -#: ../Doc/reference/datamodel.rst:2177 +#: ../Doc/reference/datamodel.rst:2178 msgid "" "The following methods can be defined to emulate numeric objects. Methods " "corresponding to operations that are not supported by the particular kind of " @@ -2541,7 +2544,7 @@ msgid "" "should be left undefined." msgstr "" -#: ../Doc/reference/datamodel.rst:2203 +#: ../Doc/reference/datamodel.rst:2204 msgid "" "These methods are called to implement the binary arithmetic operations (``" "+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:`pow`, " @@ -2554,13 +2557,13 @@ msgid "" "version of the built-in :func:`pow` function is to be supported." msgstr "" -#: ../Doc/reference/datamodel.rst:2214 +#: ../Doc/reference/datamodel.rst:2215 msgid "" "If one of those methods does not support the operation with the supplied " "arguments, it should return ``NotImplemented``." msgstr "" -#: ../Doc/reference/datamodel.rst:2237 +#: ../Doc/reference/datamodel.rst:2238 msgid "" "These methods are called to implement the binary arithmetic operations (``" "+``, ``-``, ``*``, ``@``, ``/``, ``//``, ``%``, :func:`divmod`, :func:`pow`, " @@ -2572,13 +2575,13 @@ msgid "" "__rsub__(x)`` is called if ``x.__sub__(y)`` returns *NotImplemented*." msgstr "" -#: ../Doc/reference/datamodel.rst:2248 +#: ../Doc/reference/datamodel.rst:2249 msgid "" "Note that ternary :func:`pow` will not try calling :meth:`__rpow__` (the " "coercion rules would become too complicated)." msgstr "" -#: ../Doc/reference/datamodel.rst:2253 +#: ../Doc/reference/datamodel.rst:2254 msgid "" "If the right operand's type is a subclass of the left operand's type and " "that subclass provides the reflected method for the operation, this method " @@ -2586,7 +2589,7 @@ msgid "" "behavior allows subclasses to override their ancestors' operations." msgstr "" -#: ../Doc/reference/datamodel.rst:2273 +#: ../Doc/reference/datamodel.rst:2274 msgid "" "These methods are called to implement the augmented arithmetic assignments " "(``+=``, ``-=``, ``*=``, ``@=``, ``/=``, ``//=``, ``%=``, ``**=``, ``<<=``, " @@ -2602,20 +2605,19 @@ msgid "" "fact part of the data model." msgstr "" -#: ../Doc/reference/datamodel.rst:2294 +#: ../Doc/reference/datamodel.rst:2295 msgid "" "Called to implement the unary arithmetic operations (``-``, ``+``, :func:" "`abs` and ``~``)." msgstr "" -#: ../Doc/reference/datamodel.rst:2309 +#: ../Doc/reference/datamodel.rst:2308 msgid "" -"Called to implement the built-in functions :func:`complex`, :func:`int`, :" -"func:`float` and :func:`round`. Should return a value of the appropriate " -"type." +"Called to implement the built-in functions :func:`complex`, :func:`int` and :" +"func:`float`. Should return a value of the appropriate type." msgstr "" -#: ../Doc/reference/datamodel.rst:2316 +#: ../Doc/reference/datamodel.rst:2315 msgid "" "Called to implement :func:`operator.index`, and whenever Python needs to " "losslessly convert the numeric object to an integer object (such as in " @@ -2624,18 +2626,33 @@ msgid "" "integer type. Must return an integer." msgstr "" -#: ../Doc/reference/datamodel.rst:2324 +#: ../Doc/reference/datamodel.rst:2323 msgid "" "In order to have a coherent integer type class, when :meth:`__index__` is " "defined :meth:`__int__` should also be defined, and both should return the " "same value." msgstr "" -#: ../Doc/reference/datamodel.rst:2332 +#: ../Doc/reference/datamodel.rst:2335 +msgid "" +"Called to implement the built-in function :func:`round` and :mod:`math` " +"functions :func:`~math.trunc`, :func:`~math.floor` and :func:`~math.ceil`. " +"Unless *ndigits* is passed to :meth:`!__round__` all these methods should " +"return the value of the object truncated to an :class:`~numbers.Integral` " +"(typically an :class:`int`)." +msgstr "" + +#: ../Doc/reference/datamodel.rst:2341 +msgid "" +"If :meth:`__int__` is not defined then the built-in function :func:`int` " +"falls back to :meth:`__trunc__`." +msgstr "" + +#: ../Doc/reference/datamodel.rst:2348 msgid "With Statement Context Managers" msgstr "" -#: ../Doc/reference/datamodel.rst:2334 +#: ../Doc/reference/datamodel.rst:2350 msgid "" "A :dfn:`context manager` is an object that defines the runtime context to be " "established when executing a :keyword:`with` statement. The context manager " @@ -2645,32 +2662,32 @@ msgid "" "can also be used by directly invoking their methods." msgstr "" -#: ../Doc/reference/datamodel.rst:2345 +#: ../Doc/reference/datamodel.rst:2361 msgid "" "Typical uses of context managers include saving and restoring various kinds " "of global state, locking and unlocking resources, closing opened files, etc." msgstr "" -#: ../Doc/reference/datamodel.rst:2348 +#: ../Doc/reference/datamodel.rst:2364 msgid "" "For more information on context managers, see :ref:`typecontextmanager`." msgstr "" -#: ../Doc/reference/datamodel.rst:2353 +#: ../Doc/reference/datamodel.rst:2369 msgid "" "Enter the runtime context related to this object. The :keyword:`with` " "statement will bind this method's return value to the target(s) specified in " "the :keyword:`as` clause of the statement, if any." msgstr "" -#: ../Doc/reference/datamodel.rst:2360 +#: ../Doc/reference/datamodel.rst:2376 msgid "" "Exit the runtime context related to this object. The parameters describe the " "exception that caused the context to be exited. If the context was exited " "without an exception, all three arguments will be :const:`None`." msgstr "" -#: ../Doc/reference/datamodel.rst:2364 +#: ../Doc/reference/datamodel.rst:2380 msgid "" "If an exception is supplied, and the method wishes to suppress the exception " "(i.e., prevent it from being propagated), it should return a true value. " @@ -2678,27 +2695,27 @@ msgid "" "method." msgstr "" -#: ../Doc/reference/datamodel.rst:2368 +#: ../Doc/reference/datamodel.rst:2384 msgid "" "Note that :meth:`__exit__` methods should not reraise the passed-in " "exception; this is the caller's responsibility." msgstr "" -#: ../Doc/reference/datamodel.rst:2375 +#: ../Doc/reference/datamodel.rst:2391 msgid ":pep:`343` - The \"with\" statement" msgstr ":pep:`343` - The \"with\" statement" -#: ../Doc/reference/datamodel.rst:2375 +#: ../Doc/reference/datamodel.rst:2391 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: ../Doc/reference/datamodel.rst:2382 +#: ../Doc/reference/datamodel.rst:2398 msgid "Special method lookup" msgstr "" -#: ../Doc/reference/datamodel.rst:2384 +#: ../Doc/reference/datamodel.rst:2400 msgid "" "For custom classes, implicit invocations of special methods are only " "guaranteed to work correctly if defined on an object's type, not in the " @@ -2706,7 +2723,7 @@ msgid "" "following code raises an exception::" msgstr "" -#: ../Doc/reference/datamodel.rst:2399 +#: ../Doc/reference/datamodel.rst:2415 msgid "" "The rationale behind this behaviour lies with a number of special methods " "such as :meth:`__hash__` and :meth:`__repr__` that are implemented by all " @@ -2715,21 +2732,21 @@ msgid "" "type object itself::" msgstr "" -#: ../Doc/reference/datamodel.rst:2412 +#: ../Doc/reference/datamodel.rst:2428 msgid "" "Incorrectly attempting to invoke an unbound method of a class in this way is " "sometimes referred to as 'metaclass confusion', and is avoided by bypassing " "the instance when looking up special methods::" msgstr "" -#: ../Doc/reference/datamodel.rst:2421 +#: ../Doc/reference/datamodel.rst:2437 msgid "" "In addition to bypassing any instance attributes in the interest of " "correctness, implicit special method lookup generally also bypasses the :" "meth:`__getattribute__` method even of the object's metaclass::" msgstr "" -#: ../Doc/reference/datamodel.rst:2447 +#: ../Doc/reference/datamodel.rst:2463 msgid "" "Bypassing the :meth:`__getattribute__` machinery in this fashion provides " "significant scope for speed optimisations within the interpreter, at the " @@ -2738,44 +2755,44 @@ msgid "" "invoked by the interpreter)." msgstr "" -#: ../Doc/reference/datamodel.rst:2458 +#: ../Doc/reference/datamodel.rst:2474 msgid "Coroutines" msgstr "Coroutines" -#: ../Doc/reference/datamodel.rst:2462 +#: ../Doc/reference/datamodel.rst:2478 msgid "Awaitable Objects" msgstr "" -#: ../Doc/reference/datamodel.rst:2464 +#: ../Doc/reference/datamodel.rst:2480 msgid "" "An :term:`awaitable` object generally implements an :meth:`__await__` " "method. :term:`Coroutine` objects returned from :keyword:`async def` " "functions are awaitable." msgstr "" -#: ../Doc/reference/datamodel.rst:2470 +#: ../Doc/reference/datamodel.rst:2486 msgid "" "The :term:`generator iterator` objects returned from generators decorated " "with :func:`types.coroutine` or :func:`asyncio.coroutine` are also " "awaitable, but they do not implement :meth:`__await__`." msgstr "" -#: ../Doc/reference/datamodel.rst:2476 +#: ../Doc/reference/datamodel.rst:2492 msgid "" "Must return an :term:`iterator`. Should be used to implement :term:" "`awaitable` objects. For instance, :class:`asyncio.Future` implements this " "method to be compatible with the :keyword:`await` expression." msgstr "" -#: ../Doc/reference/datamodel.rst:2482 +#: ../Doc/reference/datamodel.rst:2498 msgid ":pep:`492` for additional information about awaitable objects." msgstr "" -#: ../Doc/reference/datamodel.rst:2488 +#: ../Doc/reference/datamodel.rst:2504 msgid "Coroutine Objects" msgstr "Objets coroutines" -#: ../Doc/reference/datamodel.rst:2490 +#: ../Doc/reference/datamodel.rst:2506 msgid "" ":term:`Coroutine` objects are :term:`awaitable` objects. A coroutine's " "execution can be controlled by calling :meth:`__await__` and iterating over " @@ -2786,18 +2803,18 @@ msgid "" "not directly raise unhandled :exc:`StopIteration` exceptions." msgstr "" -#: ../Doc/reference/datamodel.rst:2498 +#: ../Doc/reference/datamodel.rst:2514 msgid "" "Coroutines also have the methods listed below, which are analogous to those " "of generators (see :ref:`generator-methods`). However, unlike generators, " "coroutines do not directly support iteration." msgstr "" -#: ../Doc/reference/datamodel.rst:2502 +#: ../Doc/reference/datamodel.rst:2518 msgid "It is a :exc:`RuntimeError` to await on a coroutine more than once." msgstr "" -#: ../Doc/reference/datamodel.rst:2508 +#: ../Doc/reference/datamodel.rst:2524 msgid "" "Starts or resumes execution of the coroutine. If *value* is ``None``, this " "is equivalent to advancing the iterator returned by :meth:`__await__`. If " @@ -2807,7 +2824,7 @@ msgid "" "as when iterating over the :meth:`__await__` return value, described above." msgstr "" -#: ../Doc/reference/datamodel.rst:2518 +#: ../Doc/reference/datamodel.rst:2534 msgid "" "Raises the specified exception in the coroutine. This method delegates to " "the :meth:`~generator.throw` method of the iterator that caused the " @@ -2818,7 +2835,7 @@ msgid "" "caught in the coroutine, it propagates back to the caller." msgstr "" -#: ../Doc/reference/datamodel.rst:2529 +#: ../Doc/reference/datamodel.rst:2545 msgid "" "Causes the coroutine to clean itself up and exit. If the coroutine is " "suspended, this method first delegates to the :meth:`~generator.close` " @@ -2828,50 +2845,50 @@ msgid "" "is marked as having finished executing, even if it was never started." msgstr "" -#: ../Doc/reference/datamodel.rst:2537 +#: ../Doc/reference/datamodel.rst:2553 msgid "" "Coroutine objects are automatically closed using the above process when they " "are about to be destroyed." msgstr "" -#: ../Doc/reference/datamodel.rst:2543 +#: ../Doc/reference/datamodel.rst:2559 msgid "Asynchronous Iterators" msgstr "" -#: ../Doc/reference/datamodel.rst:2545 +#: ../Doc/reference/datamodel.rst:2561 msgid "" "An *asynchronous iterable* is able to call asynchronous code in its " "``__aiter__`` implementation, and an *asynchronous iterator* can call " "asynchronous code in its ``__anext__`` method." msgstr "" -#: ../Doc/reference/datamodel.rst:2549 +#: ../Doc/reference/datamodel.rst:2565 msgid "" "Asynchronous iterators can be used in an :keyword:`async for` statement." msgstr "" -#: ../Doc/reference/datamodel.rst:2553 +#: ../Doc/reference/datamodel.rst:2569 msgid "Must return an *asynchronous iterator* object." msgstr "" -#: ../Doc/reference/datamodel.rst:2557 +#: ../Doc/reference/datamodel.rst:2573 msgid "" "Must return an *awaitable* resulting in a next value of the iterator. " "Should raise a :exc:`StopAsyncIteration` error when the iteration is over." msgstr "" -#: ../Doc/reference/datamodel.rst:2560 +#: ../Doc/reference/datamodel.rst:2576 msgid "An example of an asynchronous iterable object::" msgstr "" -#: ../Doc/reference/datamodel.rst:2579 +#: ../Doc/reference/datamodel.rst:2595 msgid "" "Starting with CPython 3.5.2, ``__aiter__`` can directly return :term:" "`asynchronous iterators `. Returning an :term:" "`awaitable` object will result in a :exc:`PendingDeprecationWarning`." msgstr "" -#: ../Doc/reference/datamodel.rst:2585 +#: ../Doc/reference/datamodel.rst:2601 msgid "" "The recommended way of writing backwards compatible code in CPython 3.5.x is " "to continue returning awaitables from ``__aiter__``. If you want to avoid " @@ -2879,61 +2896,61 @@ msgid "" "following decorator can be used::" msgstr "" -#: ../Doc/reference/datamodel.rst:2604 +#: ../Doc/reference/datamodel.rst:2620 msgid "Example::" msgstr "Exemples ::" -#: ../Doc/reference/datamodel.rst:2615 +#: ../Doc/reference/datamodel.rst:2631 msgid "" "Starting with CPython 3.6, the :exc:`PendingDeprecationWarning` will be " "replaced with the :exc:`DeprecationWarning`. In CPython 3.7, returning an " "awaitable from ``__aiter__`` will result in a :exc:`RuntimeError`." msgstr "" -#: ../Doc/reference/datamodel.rst:2622 +#: ../Doc/reference/datamodel.rst:2638 msgid "Asynchronous Context Managers" msgstr "" -#: ../Doc/reference/datamodel.rst:2624 +#: ../Doc/reference/datamodel.rst:2640 msgid "" "An *asynchronous context manager* is a *context manager* that is able to " "suspend execution in its ``__aenter__`` and ``__aexit__`` methods." msgstr "" -#: ../Doc/reference/datamodel.rst:2627 +#: ../Doc/reference/datamodel.rst:2643 msgid "" "Asynchronous context managers can be used in an :keyword:`async with` " "statement." msgstr "" -#: ../Doc/reference/datamodel.rst:2631 +#: ../Doc/reference/datamodel.rst:2647 msgid "" "This method is semantically similar to the :meth:`__enter__`, with only " "difference that it must return an *awaitable*." msgstr "" -#: ../Doc/reference/datamodel.rst:2636 +#: ../Doc/reference/datamodel.rst:2652 msgid "" "This method is semantically similar to the :meth:`__exit__`, with only " "difference that it must return an *awaitable*." msgstr "" -#: ../Doc/reference/datamodel.rst:2639 +#: ../Doc/reference/datamodel.rst:2655 msgid "An example of an asynchronous context manager class::" msgstr "" -#: ../Doc/reference/datamodel.rst:2652 +#: ../Doc/reference/datamodel.rst:2668 msgid "Footnotes" msgstr "Notes" -#: ../Doc/reference/datamodel.rst:2653 +#: ../Doc/reference/datamodel.rst:2669 msgid "" "It *is* possible in some cases to change an object's type, under certain " "controlled conditions. It generally isn't a good idea though, since it can " "lead to some very strange behaviour if it is handled incorrectly." msgstr "" -#: ../Doc/reference/datamodel.rst:2657 +#: ../Doc/reference/datamodel.rst:2673 msgid "" "The :meth:`__hash__`, :meth:`__iter__`, :meth:`__reversed__`, and :meth:" "`__contains__` methods have special handling for this; others will still " @@ -2941,7 +2958,7 @@ msgid "" "``None`` is not callable." msgstr "" -#: ../Doc/reference/datamodel.rst:2662 +#: ../Doc/reference/datamodel.rst:2678 msgid "" "\"Does not support\" here means that the class has no such method, or the " "method returns ``NotImplemented``. Do not set the method to ``None`` if you " @@ -2949,7 +2966,7 @@ msgid "" "instead have the opposite effect of explicitly *blocking* such fallback." msgstr "" -#: ../Doc/reference/datamodel.rst:2668 +#: ../Doc/reference/datamodel.rst:2684 msgid "" "For operands of the same type, it is assumed that if the non-reflected " "method (such as :meth:`__add__`) fails the operation is not supported, which " diff --git a/sphinx.po b/sphinx.po index f24fbb4b..a06a843d 100644 --- a/sphinx.po +++ b/sphinx.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-02-08 09:58+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2018-02-15 00:58+0100\n" "Last-Translator: \n" "Language-Team: \n" @@ -17,50 +17,6 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" "X-Generator: Poedit 1.8.11\n" -#: ../Doc/tools/templates/layout.html:10 -msgid "Documentation " -msgstr "Documentation" - -#: ../Doc/tools/templates/layout.html:21 -msgid "Quick search" -msgstr "Recherche rapide" - -#: ../Doc/tools/templates/layout.html:22 -msgid "Go" -msgstr "Go" - -#: ../Doc/tools/templates/layout.html:108 -#: ../Doc/tools/templates/indexcontent.html:63 -msgid "Copyright" -msgstr "Copyright" - -#: ../Doc/tools/templates/layout.html:110 -msgid "The Python Software Foundation is a non-profit corporation." -msgstr "La Python Software Foundation est une organisation à but non lucratif." - -#: ../Doc/tools/templates/layout.html:111 -msgid "Please donate." -msgstr "Les dons sont bienvenus." - -#: ../Doc/tools/templates/layout.html:113 -msgid "Last updated on %(last_updated)s." -msgstr "Dernière mise-à-jour le %(last_updated)s." - -#: ../Doc/tools/templates/layout.html:114 -msgid "Found a bug?" -msgstr "Vous avez trouvé un bug ?" - -#: ../Doc/tools/templates/layout.html:116 -msgid "" -"Created using Sphinx " -"%(sphinx_version)s." -msgstr "" -"Créé via Sphinx %(sphinx_version)s." - -#: ../Doc/tools/templates/dummy.html:6 -msgid "CPython implementation detail:" -msgstr "Particularité de l'implémentation CPython :" - #: ../Doc/tools/templates/indexsidebar.html:1 msgid "Download" msgstr "Téléchargement" @@ -115,18 +71,6 @@ msgstr "Liste de livres" msgid "Audio/Visual Talks" msgstr "Documents multimédia" -#: ../Doc/tools/templates/customsourcelink.html:3 -msgid "This Page" -msgstr "Cette page" - -#: ../Doc/tools/templates/customsourcelink.html:5 -msgid "Report a Bug" -msgstr "Signalement de bug" - -#: ../Doc/tools/templates/customsourcelink.html:8 -msgid "Show Source" -msgstr "Voir la source" - #: ../Doc/tools/templates/indexcontent.html:8 msgid "Welcome! This is the documentation for Python %(release)s." msgstr "Bienvenue sur la documentation de Python %(release)s." @@ -284,3 +228,64 @@ msgstr "À propos de la documentation" #: ../Doc/tools/templates/indexcontent.html:62 msgid "History and License of Python" msgstr "Histoire et licence de Python" + +#: ../Doc/tools/templates/indexcontent.html:63 +#: ../Doc/tools/templates/layout.html:108 +msgid "Copyright" +msgstr "Copyright" + +#: ../Doc/tools/templates/customsourcelink.html:3 +msgid "This Page" +msgstr "Cette page" + +#: ../Doc/tools/templates/customsourcelink.html:5 +msgid "Report a Bug" +msgstr "Signalement de bug" + +#: ../Doc/tools/templates/customsourcelink.html:8 +msgid "Show Source" +msgstr "Voir la source" + +#: ../Doc/tools/templates/layout.html:10 +msgid "Documentation " +msgstr "Documentation" + +#: ../Doc/tools/templates/layout.html:21 +msgid "Quick search" +msgstr "Recherche rapide" + +#: ../Doc/tools/templates/layout.html:22 +msgid "Go" +msgstr "Go" + +#: ../Doc/tools/templates/layout.html:110 +msgid "The Python Software Foundation is a non-profit corporation." +msgstr "La Python Software Foundation est une organisation à but non lucratif." + +#: ../Doc/tools/templates/layout.html:111 +msgid "Please donate." +msgstr "Les dons sont bienvenus." + +#: ../Doc/tools/templates/layout.html:113 +msgid "Last updated on %(last_updated)s." +msgstr "Dernière mise-à-jour le %(last_updated)s." + +#: ../Doc/tools/templates/layout.html:114 +msgid "Found a bug?" +msgstr "Vous avez trouvé un bug ?" + +#: ../Doc/tools/templates/layout.html:116 +msgid "" +"Created using Sphinx " +"%(sphinx_version)s." +msgstr "" +"Créé via Sphinx %(sphinx_version)s." + +#: ../Doc/tools/templates/dummy.html:6 +msgid "CPython implementation detail:" +msgstr "Particularité de l'implémentation CPython :" + +#: ../Doc/tools/templates/dummy.html:7 +msgid "" +"Deprecated since version {deprecated}, will be removed in version {removed}" +msgstr "" diff --git a/tutorial/inputoutput.po b/tutorial/inputoutput.po index d5aa8bae..36e8606c 100644 --- a/tutorial/inputoutput.po +++ b/tutorial/inputoutput.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-08-10 00:20+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2018-02-09 23:13+0100\n" "Last-Translator: \n" "Language-Team: \n" @@ -119,9 +119,11 @@ msgid "Here are two ways to write a table of squares and cubes::" msgstr "Voici deux façons d'écrire une table de carrés et de cubes : ::" #: ../Doc/tutorial/inputoutput.rst:102 +#, fuzzy msgid "" "(Note that in the first example, one space between each column was added by " -"the way :func:`print` works: it always adds spaces between its arguments.)" +"the way :func:`print` works: by default it adds spaces between its " +"arguments.)" msgstr "" "Notez que dans ce premier exemple, une espace a été ajoutée entre chaque " "colonne . C'est le comportement de :func:`print`, elle ajoute toujours des " diff --git a/tutorial/modules.po b/tutorial/modules.po index 28426594..91577b8c 100644 --- a/tutorial/modules.po +++ b/tutorial/modules.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-05-27 19:40+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2018-02-07 13:42+0100\n" "Last-Translator: Julien Palard \n" "Language-Team: \n" @@ -188,7 +188,24 @@ msgstr "" "déconseillé. Souvent, le code devient difficilement lisible. Son utilisation " "en mode interactif est acceptée pour gagner quelques secondes." -#: ../Doc/tutorial/modules.rst:117 +#: ../Doc/tutorial/modules.rst:115 +msgid "" +"If the module name is followed by :keyword:`as`, then the name following :" +"keyword:`as` is bound directly to the imported module." +msgstr "" + +#: ../Doc/tutorial/modules.rst:124 +msgid "" +"This is effectively importing the module in the same way that ``import " +"fibo`` will do, with the only difference of it being available as ``fib``." +msgstr "" + +#: ../Doc/tutorial/modules.rst:127 +msgid "" +"It can also be used when utilising :keyword:`from` with similar effects::" +msgstr "" + +#: ../Doc/tutorial/modules.rst:136 msgid "" "For efficiency reasons, each module is only imported once per interpreter " "session. Therefore, if you change your modules, you must restart the " @@ -203,15 +220,15 @@ msgstr "" "importer explicitement en utilisant :func:`importlib.reload`, par exemple : " "``import importlib; importlib.reload(nommodule)``." -#: ../Doc/tutorial/modules.rst:127 +#: ../Doc/tutorial/modules.rst:146 msgid "Executing modules as scripts" msgstr "Exécuter des modules comme des scripts" -#: ../Doc/tutorial/modules.rst:129 +#: ../Doc/tutorial/modules.rst:148 msgid "When you run a Python module with ::" msgstr "Lorsque vous exécutez un module Python avec : ::" -#: ../Doc/tutorial/modules.rst:133 +#: ../Doc/tutorial/modules.rst:152 msgid "" "the code in the module will be executed, just as if you imported it, but " "with the ``__name__`` set to ``\"__main__\"``. That means that by adding " @@ -221,7 +238,7 @@ msgstr "" "``__name__`` vaut ``\"__main__\"``. Donc, en ajoutant ces lignes à la fin du " "module : ::" -#: ../Doc/tutorial/modules.rst:141 +#: ../Doc/tutorial/modules.rst:160 msgid "" "you can make the file usable as a script as well as an importable module, " "because the code that parses the command line only runs if the module is " @@ -231,11 +248,11 @@ msgstr "" "module importable, car le code qui analyse la ligne de commande n'est lancé " "que si le module est exécuté comme fichier « main » :" -#: ../Doc/tutorial/modules.rst:150 +#: ../Doc/tutorial/modules.rst:169 msgid "If the module is imported, the code is not run::" msgstr "Si le fichier est importé, le code n'est pas exécuté : ::" -#: ../Doc/tutorial/modules.rst:155 +#: ../Doc/tutorial/modules.rst:174 msgid "" "This is often used either to provide a convenient user interface to a " "module, or for testing purposes (running the module as a script executes a " @@ -245,11 +262,11 @@ msgstr "" "un module, soit pour lancer les tests sur le module (exécuter le module en " "tant que script lance les tests)." -#: ../Doc/tutorial/modules.rst:162 +#: ../Doc/tutorial/modules.rst:181 msgid "The Module Search Path" msgstr "Les dossiers de recherche de modules" -#: ../Doc/tutorial/modules.rst:166 +#: ../Doc/tutorial/modules.rst:185 msgid "" "When a module named :mod:`spam` is imported, the interpreter first searches " "for a built-in module with that name. If not found, it then searches for a " @@ -262,7 +279,7 @@ msgstr "" "dossiers donnée par la variable :data:`sys.path`. Par défaut, :data:`sys." "path` est initialisée à : ::" -#: ../Doc/tutorial/modules.rst:171 +#: ../Doc/tutorial/modules.rst:190 msgid "" "The directory containing the input script (or the current directory when no " "file is specified)." @@ -270,7 +287,7 @@ msgstr "" "le dossier contenant le script courant (ou le dossier courant si aucun " "script n'est donné) ;" -#: ../Doc/tutorial/modules.rst:173 +#: ../Doc/tutorial/modules.rst:192 msgid "" ":envvar:`PYTHONPATH` (a list of directory names, with the same syntax as the " "shell variable :envvar:`PATH`)." @@ -278,11 +295,11 @@ msgstr "" ":envvar:`PYTHONPATH` (une liste de dossiers, utilisant la même syntaxe que " "la variable shell :envvar:`PATH`) ;" -#: ../Doc/tutorial/modules.rst:175 +#: ../Doc/tutorial/modules.rst:194 msgid "The installation-dependent default." msgstr "la valeur par défaut, dépendante de l'installation." -#: ../Doc/tutorial/modules.rst:178 +#: ../Doc/tutorial/modules.rst:197 msgid "" "On file systems which support symlinks, the directory containing the input " "script is calculated after the symlink is followed. In other words the " @@ -293,7 +310,7 @@ msgstr "" "Autrement dit, le dossier contenant le lien symbolique n'est **pas** ajouté " "aux dossiers de recherche de modules." -#: ../Doc/tutorial/modules.rst:182 +#: ../Doc/tutorial/modules.rst:201 msgid "" "After initialization, Python programs can modify :data:`sys.path`. The " "directory containing the script being run is placed at the beginning of the " @@ -309,11 +326,11 @@ msgstr "" "chargé à sa place. C'est une erreur typique, à moins que ce ne soit voulu. " "Voir :ref:`tut-standardmodules` pour plus d'informations." -#: ../Doc/tutorial/modules.rst:193 +#: ../Doc/tutorial/modules.rst:212 msgid "\"Compiled\" Python files" msgstr "Fichiers Python \"compilés\"" -#: ../Doc/tutorial/modules.rst:195 +#: ../Doc/tutorial/modules.rst:214 msgid "" "To speed up loading modules, Python caches the compiled version of each " "module in the ``__pycache__`` directory under the name :file:`module." @@ -331,7 +348,7 @@ msgstr "" "Cette règle de nommage permet à des versions compilées par des versions " "différentes de Python de coexister." -#: ../Doc/tutorial/modules.rst:203 +#: ../Doc/tutorial/modules.rst:222 msgid "" "Python checks the modification date of the source against the compiled " "version to see if it's out of date and needs to be recompiled. This is a " @@ -345,7 +362,7 @@ msgstr "" "indépendantes de la plateforme et peuvent donc être partagées entre des " "systèmes d'architectures différentes." -#: ../Doc/tutorial/modules.rst:208 +#: ../Doc/tutorial/modules.rst:227 msgid "" "Python does not check the cache in two circumstances. First, it always " "recompiles and does not store the result for the module that's loaded " @@ -361,11 +378,11 @@ msgstr "" "source (où seule la version compilée est fournie), le module compilé doit se " "trouver dans le dossier source et sa source ne doit pas être présente." -#: ../Doc/tutorial/modules.rst:215 +#: ../Doc/tutorial/modules.rst:234 msgid "Some tips for experts:" msgstr "Astuces pour les experts :" -#: ../Doc/tutorial/modules.rst:217 +#: ../Doc/tutorial/modules.rst:236 msgid "" "You can use the :option:`-O` or :option:`-OO` switches on the Python command " "to reduce the size of a compiled module. The ``-O`` switch removes assert " @@ -384,7 +401,7 @@ msgstr "" "`` et sont généralement plus petits. Les versions futures de Python " "pourraient changer les effets de l'optimisation ;" -#: ../Doc/tutorial/modules.rst:225 +#: ../Doc/tutorial/modules.rst:244 msgid "" "A program doesn't run any faster when it is read from a ``.pyc`` file than " "when it is read from a ``.py`` file; the only thing that's faster about ``." @@ -393,7 +410,7 @@ msgstr "" "un programme ne s'exécute pas plus vite lorsqu'il est lu depuis un ``.pyc``, " "il est juste chargé plus vite ;" -#: ../Doc/tutorial/modules.rst:229 +#: ../Doc/tutorial/modules.rst:248 msgid "" "The module :mod:`compileall` can create .pyc files for all modules in a " "directory." @@ -401,7 +418,7 @@ msgstr "" "le module :mod:`compileall` peut créer des fichiers ``.pyc`` pour tous les " "modules d'un dossier ;" -#: ../Doc/tutorial/modules.rst:232 +#: ../Doc/tutorial/modules.rst:251 msgid "" "There is more detail on this process, including a flow chart of the " "decisions, in PEP 3147." @@ -409,11 +426,11 @@ msgstr "" "vous trouvez plus de détails sur ce processus, ainsi qu'un organigramme des " "décisions, dans la PEP 3147." -#: ../Doc/tutorial/modules.rst:239 +#: ../Doc/tutorial/modules.rst:258 msgid "Standard Modules" msgstr "Modules standards" -#: ../Doc/tutorial/modules.rst:243 +#: ../Doc/tutorial/modules.rst:262 msgid "" "Python comes with a library of standard modules, described in a separate " "document, the Python Library Reference (\"Library Reference\" hereafter). " @@ -439,7 +456,7 @@ msgstr "" "les interpréteurs Python. Les variables ``sys.ps1`` et ``sys.ps2`` " "définissent les chaînes d'invites principales et secondaires : ::" -#: ../Doc/tutorial/modules.rst:266 +#: ../Doc/tutorial/modules.rst:285 msgid "" "These two variables are only defined if the interpreter is in interactive " "mode." @@ -447,7 +464,7 @@ msgstr "" "Ces deux variables ne sont définies que si l'interpréteur est en mode " "interactif." -#: ../Doc/tutorial/modules.rst:268 +#: ../Doc/tutorial/modules.rst:287 msgid "" "The variable ``sys.path`` is a list of strings that determines the " "interpreter's search path for modules. It is initialized to a default path " @@ -462,11 +479,11 @@ msgstr "" "définie. ``sys.path`` est modifiable en utilisant les opérations habituelles " "des listes : ::" -#: ../Doc/tutorial/modules.rst:281 +#: ../Doc/tutorial/modules.rst:300 msgid "The :func:`dir` Function" msgstr "La fonction :func:`dir`" -#: ../Doc/tutorial/modules.rst:283 +#: ../Doc/tutorial/modules.rst:302 msgid "" "The built-in function :func:`dir` is used to find out which names a module " "defines. It returns a sorted list of strings::" @@ -475,19 +492,19 @@ msgstr "" "définis par un module. Elle donne une liste de chaînes classées par ordre " "lexicographique : ::" -#: ../Doc/tutorial/modules.rst:308 +#: ../Doc/tutorial/modules.rst:327 msgid "" "Without arguments, :func:`dir` lists the names you have defined currently::" msgstr "Sans paramètre, :func:`dir` liste les noms actuellement définis : ::" -#: ../Doc/tutorial/modules.rst:316 +#: ../Doc/tutorial/modules.rst:335 msgid "" "Note that it lists all types of names: variables, modules, functions, etc." msgstr "" "Notez qu'elle liste tous les types de noms : les variables, fonctions, " "modules, etc." -#: ../Doc/tutorial/modules.rst:320 +#: ../Doc/tutorial/modules.rst:339 msgid "" ":func:`dir` does not list the names of built-in functions and variables. If " "you want a list of those, they are defined in the standard module :mod:" @@ -497,11 +514,11 @@ msgstr "" "Si vous voulez les lister, elles sont définies dans le module :mod:" "`builtins` : ::" -#: ../Doc/tutorial/modules.rst:359 +#: ../Doc/tutorial/modules.rst:378 msgid "Packages" msgstr "Les paquets" -#: ../Doc/tutorial/modules.rst:361 +#: ../Doc/tutorial/modules.rst:380 msgid "" "Packages are a way of structuring Python's module namespace by using " "\"dotted module names\". For example, the module name :mod:`A.B` designates " @@ -520,7 +537,7 @@ msgstr "" "paquets contenant plusieurs modules tel que NumPy ou \"Python Image Library" "\" d'avoir à se soucier des noms des modules des autres." -#: ../Doc/tutorial/modules.rst:369 +#: ../Doc/tutorial/modules.rst:388 msgid "" "Suppose you want to design a collection of modules (a \"package\") for the " "uniform handling of sound files and sound data. There are many different " @@ -547,7 +564,7 @@ msgstr "" "structure possible pour votre paquet (exprimée sous la forme d'une " "arborescence de fichiers :" -#: ../Doc/tutorial/modules.rst:406 +#: ../Doc/tutorial/modules.rst:425 msgid "" "When importing the package, Python searches through the directories on ``sys." "path`` looking for the package subdirectory." @@ -555,7 +572,7 @@ msgstr "" "Lorsqu'il importe des paquets, Python cherche dans chaque dossier de ``sys." "path`` un sous-dossier du nom du paquet." -#: ../Doc/tutorial/modules.rst:409 +#: ../Doc/tutorial/modules.rst:428 msgid "" "The :file:`__init__.py` files are required to make Python treat the " "directories as containing packages; this is done to prevent directories with " @@ -573,7 +590,7 @@ msgstr "" "d'initialisation pour son paquet ou configurer la variable ``__all__`` " "(documentée plus loin)." -#: ../Doc/tutorial/modules.rst:416 +#: ../Doc/tutorial/modules.rst:435 msgid "" "Users of the package can import individual modules from the package, for " "example::" @@ -581,7 +598,7 @@ msgstr "" "Les utilisateurs d'un module peuvent importer ses modules individuellement, " "par exemple : ::" -#: ../Doc/tutorial/modules.rst:421 +#: ../Doc/tutorial/modules.rst:440 msgid "" "This loads the submodule :mod:`sound.effects.echo`. It must be referenced " "with its full name. ::" @@ -589,11 +606,11 @@ msgstr "" "charge le sous-module :mod:`sound.effects.echo`. Il doit alors être " "référencé par son nom complet. ::" -#: ../Doc/tutorial/modules.rst:426 +#: ../Doc/tutorial/modules.rst:445 msgid "An alternative way of importing the submodule is::" msgstr "Une autre manière d'importer des sous-modules est : ::" -#: ../Doc/tutorial/modules.rst:430 +#: ../Doc/tutorial/modules.rst:449 msgid "" "This also loads the submodule :mod:`echo`, and makes it available without " "its package prefix, so it can be used as follows::" @@ -601,7 +618,7 @@ msgstr "" "charge aussi le sous-module :mod:`echo` et le rend disponible sans avoir à " "indiquer le préfixe du paquet. Il peut donc être utilisé comme ceci : ::" -#: ../Doc/tutorial/modules.rst:435 +#: ../Doc/tutorial/modules.rst:454 msgid "" "Yet another variation is to import the desired function or variable " "directly::" @@ -609,7 +626,7 @@ msgstr "" "Une autre méthode consiste à importer la fonction ou la variable désirée " "directement : ::" -#: ../Doc/tutorial/modules.rst:439 +#: ../Doc/tutorial/modules.rst:458 msgid "" "Again, this loads the submodule :mod:`echo`, but this makes its function :" "func:`echofilter` directly available::" @@ -617,7 +634,7 @@ msgstr "" "Le sous-module :mod:`echo` est toujours chargé mais ici la fonction :func:" "`echofilter` est disponible directement : ::" -#: ../Doc/tutorial/modules.rst:444 +#: ../Doc/tutorial/modules.rst:463 msgid "" "Note that when using ``from package import item``, the item can be either a " "submodule (or subpackage) of the package, or some other name defined in the " @@ -633,7 +650,7 @@ msgstr "" "le paquet ; s'il ne l'est pas, elle cherche à charger un module et, si elle " "n'en trouve pas, une exception :exc:`ImportError` est levée." -#: ../Doc/tutorial/modules.rst:451 +#: ../Doc/tutorial/modules.rst:470 msgid "" "Contrarily, when using syntax like ``import item.subitem.subsubitem``, each " "item except for the last must be a package; the last item can be a module or " @@ -646,11 +663,11 @@ msgstr "" "ni une fonction, ni une classe, ni une variable définie dans l'élément " "précédent." -#: ../Doc/tutorial/modules.rst:460 +#: ../Doc/tutorial/modules.rst:479 msgid "Importing \\* From a Package" msgstr "Importer \\* depuis un paquet" -#: ../Doc/tutorial/modules.rst:464 +#: ../Doc/tutorial/modules.rst:483 msgid "" "Now what happens when the user writes ``from sound.effects import *``? " "Ideally, one would hope that this somehow goes out to the filesystem, finds " @@ -665,7 +682,7 @@ msgstr "" "avoir des effets secondaires indésirables ou, du moins, désirés seulement " "lorsque le sous-module est importé explicitement." -#: ../Doc/tutorial/modules.rst:470 +#: ../Doc/tutorial/modules.rst:489 msgid "" "The only solution is for the package author to provide an explicit index of " "the package. The :keyword:`import` statement uses the following convention: " @@ -688,7 +705,7 @@ msgstr "" "pour son paquet. Par exemple, le fichier :file:`sound/effects/__init__.py` " "peut contenir le code suivant : ::" -#: ../Doc/tutorial/modules.rst:482 +#: ../Doc/tutorial/modules.rst:501 msgid "" "This would mean that ``from sound.effects import *`` would import the three " "named submodules of the :mod:`sound` package." @@ -696,7 +713,7 @@ msgstr "" "Cela signifie que ``from sound.effects import *`` importe les trois sous-" "modules explicitement désignés du paquet :mod:`sound`." -#: ../Doc/tutorial/modules.rst:485 +#: ../Doc/tutorial/modules.rst:504 msgid "" "If ``__all__`` is not defined, the statement ``from sound.effects import *`` " "does *not* import all submodules from the package :mod:`sound.effects` into " @@ -718,7 +735,7 @@ msgstr "" "modules du paquet ayant été chargés explicitement par une instruction :" "keyword:`import`. Typiquement : ::" -#: ../Doc/tutorial/modules.rst:498 +#: ../Doc/tutorial/modules.rst:517 msgid "" "In this example, the :mod:`echo` and :mod:`surround` modules are imported in " "the current namespace because they are defined in the :mod:`sound.effects` " @@ -730,7 +747,7 @@ msgstr "" "qu'ils sont définis dans le paquet :mod:`sound.effects` (cela fonctionne " "aussi lorsque ``__all__`` est définie)." -#: ../Doc/tutorial/modules.rst:503 +#: ../Doc/tutorial/modules.rst:522 msgid "" "Although certain modules are designed to export only names that follow " "certain patterns when you use ``import *``, it is still considered bad " @@ -741,7 +758,7 @@ msgstr "" "*`` reste considéré comme une mauvaise pratique dans du code à destination " "d'un environnement de production." -#: ../Doc/tutorial/modules.rst:507 +#: ../Doc/tutorial/modules.rst:526 msgid "" "Remember, there is nothing wrong with using ``from Package import " "specific_submodule``! In fact, this is the recommended notation unless the " @@ -753,11 +770,11 @@ msgstr "" "que le module qui fait les imports ait besoin de sous-modules ayant le même " "nom mais provenant de paquets différents." -#: ../Doc/tutorial/modules.rst:514 +#: ../Doc/tutorial/modules.rst:533 msgid "Intra-package References" msgstr "Références internes dans un paquet" -#: ../Doc/tutorial/modules.rst:516 +#: ../Doc/tutorial/modules.rst:535 msgid "" "When packages are structured into subpackages (as with the :mod:`sound` " "package in the example), you can use absolute imports to refer to submodules " @@ -771,7 +788,7 @@ msgstr "" "a besoin du module :mod:`echo` du paquet :mod:`sound.effects`, il peut " "utiliser ``from sound.effects import echo``." -#: ../Doc/tutorial/modules.rst:522 +#: ../Doc/tutorial/modules.rst:541 msgid "" "You can also write relative imports, with the ``from module import name`` " "form of import statement. These imports use leading dots to indicate the " @@ -783,7 +800,7 @@ msgstr "" "indiquer leur origine (paquet courant ou parent). Depuis le module :mod:" "`surround`, par exemple vous pouvez écrire : ::" -#: ../Doc/tutorial/modules.rst:531 +#: ../Doc/tutorial/modules.rst:550 msgid "" "Note that relative imports are based on the name of the current module. " "Since the name of the main module is always ``\"__main__\"``, modules " @@ -795,11 +812,11 @@ msgstr "" "par le module principal d'une application ne peuvent être importés que par " "des imports absolus." -#: ../Doc/tutorial/modules.rst:537 +#: ../Doc/tutorial/modules.rst:556 msgid "Packages in Multiple Directories" msgstr "Paquets dans plusieurs dossiers" -#: ../Doc/tutorial/modules.rst:539 +#: ../Doc/tutorial/modules.rst:558 msgid "" "Packages support one more special attribute, :attr:`__path__`. This is " "initialized to be a list containing the name of the directory holding the " @@ -813,7 +830,7 @@ msgstr "" "peut être modifiée, altérant ainsi les futures recherches de modules et sous-" "paquets contenus dans le paquet." -#: ../Doc/tutorial/modules.rst:545 +#: ../Doc/tutorial/modules.rst:564 msgid "" "While this feature is not often needed, it can be used to extend the set of " "modules found in a package." @@ -821,11 +838,11 @@ msgstr "" "Bien que cette fonctionnalité ne soit que rarement utile, elle peut servir à " "élargir la liste des modules trouvés dans un paquet." -#: ../Doc/tutorial/modules.rst:550 +#: ../Doc/tutorial/modules.rst:569 msgid "Footnotes" msgstr "Notes" -#: ../Doc/tutorial/modules.rst:551 +#: ../Doc/tutorial/modules.rst:570 msgid "" "In fact function definitions are also 'statements' that are 'executed'; the " "execution of a module-level function definition enters the function name in " diff --git a/tutorial/venv.po b/tutorial/venv.po index 1e64e4eb..3370efb3 100644 --- a/tutorial/venv.po +++ b/tutorial/venv.po @@ -7,10 +7,11 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2016-10-30 10:40+0100\n" +"POT-Creation-Date: 2018-02-08 09:58+0100\n" "PO-Revision-Date: 2018-02-17 14:54+0100\n" "Last-Translator: \n" "Language-Team: \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" diff --git a/using/cmdline.po b/using/cmdline.po index 0c0e42b2..ae9227f8 100644 --- a/using/cmdline.po +++ b/using/cmdline.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-12-01 07:43+0100\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: 2018-03-16 21:46+0100\n" "Last-Translator: Julien Palard \n" "Language-Team: \n" @@ -433,21 +433,30 @@ msgstr "" "imposées pour éviter que l'utilisateur n'injecte du code malicieux." #: ../Doc/using/cmdline.rst:249 -msgid "Turn on basic optimizations. See also :envvar:`PYTHONOPTIMIZE`." +msgid "" +"Remove assert statements and any code conditional on the value of :const:" +"`__debug__`. Augment the filename for compiled (:term:`bytecode`) files by " +"adding ``.opt-1`` before the ``.pyc`` extension (see :pep:`488`). See also :" +"envvar:`PYTHONOPTIMIZE`." msgstr "" -"Active les optimisations basiques. Voir aussi :envvar:`PYTHONOPTIMIZE`." -#: ../Doc/using/cmdline.rst:254 -msgid "Discard docstrings in addition to the :option:`-O` optimizations." +#: ../Doc/using/cmdline.rst:254 ../Doc/using/cmdline.rst:264 +msgid "Modify ``.pyc`` filenames according to :pep:`488`." msgstr "" -"Supprime les docstrings en plus des optimisations réalisées par :option:`-O`." -#: ../Doc/using/cmdline.rst:259 +#: ../Doc/using/cmdline.rst:260 +msgid "" +"Do :option:`-O` and also discard docstrings. Augment the filename for " +"compiled (:term:`bytecode`) files by adding ``.opt-2`` before the ``.pyc`` " +"extension (see :pep:`488`)." +msgstr "" + +#: ../Doc/using/cmdline.rst:270 msgid "" "Don't display the copyright and version messages even in interactive mode." msgstr "N'affiche pas le copyright et la version, même en mode interactif." -#: ../Doc/using/cmdline.rst:266 +#: ../Doc/using/cmdline.rst:277 msgid "" "Kept for compatibility. On Python 3.3 and greater, hash randomization is " "turned on by default." @@ -455,7 +464,7 @@ msgstr "" "Conservé pour compatibilité ascendante. Sur Python 3.3 ou supérieur, la " "randomisation des empreintes (*hash* en anglais) est activée par défaut." -#: ../Doc/using/cmdline.rst:269 +#: ../Doc/using/cmdline.rst:280 msgid "" "On previous versions of Python, this option turns on hash randomization, so " "that the :meth:`__hash__` values of str, bytes and datetime are \"salted\" " @@ -470,7 +479,7 @@ msgstr "" "processus Python, il n'est pas prévisible pour des invocations répétées de " "code Python." -#: ../Doc/using/cmdline.rst:275 +#: ../Doc/using/cmdline.rst:286 msgid "" "Hash randomization is intended to provide protection against a denial-of-" "service caused by carefully-chosen inputs that exploit the worst case " @@ -483,7 +492,7 @@ msgstr "" "c'est-à-dire avec une complexité en O(n^2). Voir http://www.ocert.org/" "advisories/ocert-2011-003.html pour obtenir les détails." -#: ../Doc/using/cmdline.rst:280 +#: ../Doc/using/cmdline.rst:291 msgid "" ":envvar:`PYTHONHASHSEED` allows you to set a fixed value for the hash seed " "secret." @@ -491,7 +500,7 @@ msgstr "" ":envvar:`PYTHONHASHSEED` vous permet de définir vous-même la valeur du sel " "pour l'algorithme de calcul des empreintes." -#: ../Doc/using/cmdline.rst:288 +#: ../Doc/using/cmdline.rst:299 msgid "" "Don't add the :data:`user site-packages directory ` to :data:" "`sys.path`." @@ -499,12 +508,12 @@ msgstr "" "N'ajoute pas le répertoire utilisateur :data:`site-packages ` à :data:`sys.path`." -#: ../Doc/using/cmdline.rst:293 ../Doc/using/cmdline.rst:582 -#: ../Doc/using/cmdline.rst:594 +#: ../Doc/using/cmdline.rst:304 ../Doc/using/cmdline.rst:593 +#: ../Doc/using/cmdline.rst:605 msgid ":pep:`370` -- Per user site-packages directory" msgstr ":pep:`370` -- Répertoire site-packages propre à l'utilisateur." -#: ../Doc/using/cmdline.rst:298 +#: ../Doc/using/cmdline.rst:309 msgid "" "Disable the import of the module :mod:`site` and the site-dependent " "manipulations of :data:`sys.path` that it entails. Also disable these " @@ -516,7 +525,7 @@ msgstr "" "mod:`site` est importé explicitement plus tard (appelez :func:`site.main` si " "vous voulez les déclencher)." -#: ../Doc/using/cmdline.rst:306 +#: ../Doc/using/cmdline.rst:317 msgid "" "Force the binary layer of the stdout and stderr streams (which is available " "as their ``buffer`` attribute) to be unbuffered. The text I/O layer will " @@ -529,11 +538,11 @@ msgstr "" "mise en tampon ligne par ligne lors de l'écriture sur la console, ou par " "blocs si elle est redirigée sur un fichier non-interactif." -#: ../Doc/using/cmdline.rst:311 +#: ../Doc/using/cmdline.rst:322 msgid "See also :envvar:`PYTHONUNBUFFERED`." msgstr "Voir aussi :envvar:`PYTHONUNBUFFERED`." -#: ../Doc/using/cmdline.rst:316 +#: ../Doc/using/cmdline.rst:327 msgid "" "Print a message each time a module is initialized, showing the place " "(filename or built-in module) from which it is loaded. When given twice (:" @@ -548,7 +557,7 @@ msgstr "" "des informations sur le nettoyage du module à la fin. Voir aussi :envvar:" "`PYTHONVERBOSE`." -#: ../Doc/using/cmdline.rst:326 +#: ../Doc/using/cmdline.rst:337 msgid "" "Warning control. Python's warning machinery by default prints warning " "messages to :data:`sys.stderr`. A typical warning message has the following " @@ -558,7 +567,7 @@ msgstr "" "défaut, affiche les messages d'avertissement sur :data:`sys.stderr`. Un " "message d'avertissement type est de la forme suivante : ::" -#: ../Doc/using/cmdline.rst:332 +#: ../Doc/using/cmdline.rst:343 msgid "" "By default, each warning is printed once for each source line where it " "occurs. This option controls how often warnings are printed." @@ -567,7 +576,7 @@ msgstr "" "ligne de source où il se trouve. Cette option définit à quelle fréquence " "afficher ces avertissements." -#: ../Doc/using/cmdline.rst:335 +#: ../Doc/using/cmdline.rst:346 msgid "" "Multiple :option:`-W` options may be given; when a warning matches more than " "one option, the action for the last matching option is performed. Invalid :" @@ -580,7 +589,7 @@ msgstr "" "message d'avertissement est affiché sur les options invalides au moment où " "le premier avertissement est généré)." -#: ../Doc/using/cmdline.rst:340 +#: ../Doc/using/cmdline.rst:351 msgid "" "Warnings can also be controlled from within a Python program using the :mod:" "`warnings` module." @@ -588,7 +597,7 @@ msgstr "" "Les avertissements peuvent aussi être contrôlés dans le programme Python en " "utilisant le module :mod:`warnings`." -#: ../Doc/using/cmdline.rst:343 +#: ../Doc/using/cmdline.rst:354 msgid "" "The simplest form of argument is one of the following action strings (or a " "unique abbreviation):" @@ -596,19 +605,19 @@ msgstr "" "La forme la plus simple de l'argument est l'une des chaînes d'actions " "suivantes (ou une abréviation unique) :" -#: ../Doc/using/cmdline.rst:346 +#: ../Doc/using/cmdline.rst:357 msgid "``ignore``" msgstr "" -#: ../Doc/using/cmdline.rst:347 +#: ../Doc/using/cmdline.rst:358 msgid "Ignore all warnings." msgstr "Ignore tous les avertissements." -#: ../Doc/using/cmdline.rst:349 +#: ../Doc/using/cmdline.rst:360 msgid "``default``" msgstr "" -#: ../Doc/using/cmdline.rst:349 +#: ../Doc/using/cmdline.rst:360 msgid "" "Explicitly request the default behavior (printing each warning once per " "source line)." @@ -616,11 +625,11 @@ msgstr "" "Demande explicitement le comportement par défaut (affiche chaque " "avertissement une fois par ligne de code source)." -#: ../Doc/using/cmdline.rst:353 +#: ../Doc/using/cmdline.rst:364 msgid "``all``" msgstr "``all``" -#: ../Doc/using/cmdline.rst:352 +#: ../Doc/using/cmdline.rst:363 msgid "" "Print a warning each time it occurs (this may generate many messages if a " "warning is triggered repeatedly for the same source line, such as inside a " @@ -630,39 +639,39 @@ msgstr "" "beaucoup de messages si l'avertissement est déclenché à plusieurs reprises, " "comme à l'intérieur d'une boucle)." -#: ../Doc/using/cmdline.rst:355 +#: ../Doc/using/cmdline.rst:366 msgid "``module``" msgstr "``module``" -#: ../Doc/using/cmdline.rst:356 +#: ../Doc/using/cmdline.rst:367 msgid "Print each warning only the first time it occurs in each module." msgstr "" "Affiche chaque avertissement uniquement la première fois qu'il apparaît dans " "chaque module." -#: ../Doc/using/cmdline.rst:357 +#: ../Doc/using/cmdline.rst:368 msgid "``once``" msgstr "" -#: ../Doc/using/cmdline.rst:358 +#: ../Doc/using/cmdline.rst:369 msgid "Print each warning only the first time it occurs in the program." msgstr "" "Affiche chaque avertissement uniquement la première fois qu'il apparaît dans " "le programme." -#: ../Doc/using/cmdline.rst:360 +#: ../Doc/using/cmdline.rst:371 msgid "``error``" msgstr "" -#: ../Doc/using/cmdline.rst:360 +#: ../Doc/using/cmdline.rst:371 msgid "Raise an exception instead of printing a warning message." msgstr "Déclenche une exception au lieu d'afficher un message d'avertissement." -#: ../Doc/using/cmdline.rst:362 +#: ../Doc/using/cmdline.rst:373 msgid "The full form of argument is::" msgstr "La forme complète de l'argument est : ::" -#: ../Doc/using/cmdline.rst:366 +#: ../Doc/using/cmdline.rst:377 msgid "" "Here, *action* is as explained above but only applies to messages that match " "the remaining fields. Empty fields match all values; trailing empty fields " @@ -688,19 +697,19 @@ msgstr "" "correspond au numéro de ligne, où zéro correspond à n'importe quel numéro de " "ligne et correspond donc à l'option par défaut." -#: ../Doc/using/cmdline.rst:378 +#: ../Doc/using/cmdline.rst:389 msgid ":mod:`warnings` -- the warnings module" msgstr ":mod:`warnings` -- le module qui gère les avertissements." -#: ../Doc/using/cmdline.rst:380 +#: ../Doc/using/cmdline.rst:391 msgid ":pep:`230` -- Warning framework" msgstr ":pep:`230` -- Gestion des alertes" -#: ../Doc/using/cmdline.rst:382 +#: ../Doc/using/cmdline.rst:393 msgid ":envvar:`PYTHONWARNINGS`" msgstr "" -#: ../Doc/using/cmdline.rst:387 +#: ../Doc/using/cmdline.rst:398 msgid "" "Skip the first line of the source, allowing use of non-Unix forms of ``#!" "cmd``. This is intended for a DOS specific hack only." @@ -709,7 +718,7 @@ msgstr "" "type ``#!cmd`` non conformes au standard Unix. L'objectif est de proposer " "une astuce spécifique pour le DOS." -#: ../Doc/using/cmdline.rst:393 +#: ../Doc/using/cmdline.rst:404 msgid "" "Reserved for various implementation-specific options. CPython currently " "defines the following possible values:" @@ -717,11 +726,11 @@ msgstr "" "Réservée pour les options spécifiques aux différentes implémentations. " "CPython reconnaît actuellement les valeurs suivantes :" -#: ../Doc/using/cmdline.rst:396 +#: ../Doc/using/cmdline.rst:407 msgid "``-X faulthandler`` to enable :mod:`faulthandler`;" msgstr "``-X faulthandler`` pour activer :mod:`faulthandler` ;" -#: ../Doc/using/cmdline.rst:397 +#: ../Doc/using/cmdline.rst:408 msgid "" "``-X showrefcount`` to output the total reference count and number of used " "memory blocks when the program finishes or after each statement in the " @@ -732,7 +741,7 @@ msgstr "" "entrée de l'interpréteur interactif. Ceci ne fonctionne que sur les versions " "compilées en mode débogage." -#: ../Doc/using/cmdline.rst:400 +#: ../Doc/using/cmdline.rst:411 msgid "" "``-X tracemalloc`` to start tracing Python memory allocations using the :mod:" "`tracemalloc` module. By default, only the most recent frame is stored in a " @@ -747,7 +756,7 @@ msgstr "" "limite des traces à *NFRAME* appels. Voir :func:`tracemalloc.start` pour " "plus d'informations." -#: ../Doc/using/cmdline.rst:405 +#: ../Doc/using/cmdline.rst:416 msgid "" "``-X showalloccount`` to output the total count of allocated objects for " "each type when the program finishes. This only works when Python was built " @@ -757,7 +766,7 @@ msgstr "" "total des objets alloués pour chaque type. Ceci ne fonctionne que si Python " "a été compilé avec l'option ``COUNT_ALLOCS``." -#: ../Doc/using/cmdline.rst:409 +#: ../Doc/using/cmdline.rst:420 msgid "" "It also allows passing arbitrary values and retrieving them through the :" "data:`sys._xoptions` dictionary." @@ -765,35 +774,35 @@ msgstr "" "Il est aussi possible de passer des valeurs arbitraires et de les récupérer " "par le dictionnaire :data:`sys._xoptions`." -#: ../Doc/using/cmdline.rst:412 +#: ../Doc/using/cmdline.rst:423 msgid "The :option:`-X` option was added." msgstr "L'option :option:`-X` a été ajoutée." -#: ../Doc/using/cmdline.rst:415 +#: ../Doc/using/cmdline.rst:426 msgid "The ``-X faulthandler`` option." msgstr "option ``-X faulthandler``." -#: ../Doc/using/cmdline.rst:418 +#: ../Doc/using/cmdline.rst:429 msgid "The ``-X showrefcount`` and ``-X tracemalloc`` options." msgstr "options ``-X showrefcount`` et ``-X tracemalloc`` ." -#: ../Doc/using/cmdline.rst:421 +#: ../Doc/using/cmdline.rst:432 msgid "The ``-X showalloccount`` option." msgstr "option ``-X showalloccount``." -#: ../Doc/using/cmdline.rst:426 +#: ../Doc/using/cmdline.rst:437 msgid "Options you shouldn't use" msgstr "Options à ne pas utiliser" -#: ../Doc/using/cmdline.rst:430 +#: ../Doc/using/cmdline.rst:441 msgid "Reserved for use by Jython_." msgstr "Utilisation réservée à Jython_." -#: ../Doc/using/cmdline.rst:438 +#: ../Doc/using/cmdline.rst:449 msgid "Environment variables" msgstr "Variables d'environnement" -#: ../Doc/using/cmdline.rst:440 +#: ../Doc/using/cmdline.rst:451 msgid "" "These environment variables influence Python's behavior, they are processed " "before the command-line switches other than -E or -I. It is customary that " @@ -805,7 +814,7 @@ msgstr "" "I. Il est d'usage que les options de la ligne de commande prennent le pas " "sur les variables d'environnement en cas de conflit." -#: ../Doc/using/cmdline.rst:447 +#: ../Doc/using/cmdline.rst:458 msgid "" "Change the location of the standard Python libraries. By default, the " "libraries are searched in :file:`{prefix}/lib/python{version}` and :file:" @@ -819,7 +828,7 @@ msgstr "" "`{préfixe_exec}` sont des répertoires qui dépendent de l'installation (leur " "valeur par défaut étant :file:`/usr/local`)." -#: ../Doc/using/cmdline.rst:453 +#: ../Doc/using/cmdline.rst:464 msgid "" "When :envvar:`PYTHONHOME` is set to a single directory, its value replaces " "both :file:`{prefix}` and :file:`{exec_prefix}`. To specify different " @@ -830,7 +839,7 @@ msgstr "" "spécifier des valeurs différentes à ces variables, définissez :envvar:" "`PYTHONHOME` à :file:`{prefix}:{exec_prefix}`." -#: ../Doc/using/cmdline.rst:460 +#: ../Doc/using/cmdline.rst:471 msgid "" "Augment the default search path for module files. The format is the same as " "the shell's :envvar:`PATH`: one or more directory pathnames separated by :" @@ -843,7 +852,7 @@ msgstr "" "points sous Unix et point-virgule sous Windows). Les répertoires qui " "n'existent pas sont ignorés silencieusement." -#: ../Doc/using/cmdline.rst:465 +#: ../Doc/using/cmdline.rst:476 msgid "" "In addition to normal directories, individual :envvar:`PYTHONPATH` entries " "may refer to zipfiles containing pure Python modules (in either source or " @@ -855,7 +864,7 @@ msgstr "" "compilée). Les modules d'extensions ne peuvent pas être importés à partir de " "fichiers zip." -#: ../Doc/using/cmdline.rst:469 +#: ../Doc/using/cmdline.rst:480 msgid "" "The default search path is installation dependent, but generally begins " "with :file:`{prefix}/lib/python{version}` (see :envvar:`PYTHONHOME` above). " @@ -865,7 +874,7 @@ msgstr "" "généralement par :file:`{préfixe}/lib/python{version}` (voir :envvar:" "`PYTHONHOME` ci-dessus). Il est *toujours* ajouté à :envvar:`PYTHONPATH`." -#: ../Doc/using/cmdline.rst:473 +#: ../Doc/using/cmdline.rst:484 msgid "" "An additional directory will be inserted in the search path in front of :" "envvar:`PYTHONPATH` as described above under :ref:`using-on-interface-" @@ -877,7 +886,7 @@ msgstr "" "envvar:`PYTHONPATH`. Le chemin de recherche peut être manipulé depuis un " "programme Python avec la variable :data:`sys.path`." -#: ../Doc/using/cmdline.rst:481 +#: ../Doc/using/cmdline.rst:492 msgid "" "If this is the name of a readable file, the Python commands in that file are " "executed before the first prompt is displayed in interactive mode. The file " @@ -896,7 +905,7 @@ msgstr "" "`sys.ps2` ainsi que la fonction automatique (*hook* en anglais) :data:`sys." "__interactivehook__` dans ce fichier." -#: ../Doc/using/cmdline.rst:491 +#: ../Doc/using/cmdline.rst:502 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-O` option. If set to an integer, it is equivalent to specifying :" @@ -906,7 +915,7 @@ msgstr "" "l'option :option:`-O`. Si elle est définie à un entier, c'est équivalent à " "spécifier l'option :option:`-O` plusieurs fois." -#: ../Doc/using/cmdline.rst:498 +#: ../Doc/using/cmdline.rst:509 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-d` option. If set to an integer, it is equivalent to specifying :" @@ -916,7 +925,7 @@ msgstr "" "l'option :option:`-d`. Si elle est définie à un entier, c'est équivalent à " "spécifier l'option :option:`-d` plusieurs fois." -#: ../Doc/using/cmdline.rst:505 +#: ../Doc/using/cmdline.rst:516 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-i` option." @@ -924,7 +933,7 @@ msgstr "" "Si elle est définie à une chaîne non vide, C'est équivalent à spécifier " "l'option :option:`-i`." -#: ../Doc/using/cmdline.rst:508 +#: ../Doc/using/cmdline.rst:519 msgid "" "This variable can also be modified by Python code using :data:`os.environ` " "to force inspect mode on program termination." @@ -932,7 +941,7 @@ msgstr "" "Cette variable peut aussi être modifiée par du code Python en utilisant :" "data:`os.environ` pour forcer le mode introspectif à la fin du programme." -#: ../Doc/using/cmdline.rst:514 +#: ../Doc/using/cmdline.rst:525 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-u` option." @@ -940,7 +949,7 @@ msgstr "" "Si elle est définie à une chaîne non vide, c'est équivalent à spécifier " "l'option :option:`-u`." -#: ../Doc/using/cmdline.rst:520 +#: ../Doc/using/cmdline.rst:531 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-v` option. If set to an integer, it is equivalent to specifying :" @@ -950,7 +959,7 @@ msgstr "" "l'option :option:`-v`. Si elle est définie à un entier, c'est équivalent à " "spécifier l'option :option:`-v` plusieurs fois." -#: ../Doc/using/cmdline.rst:527 +#: ../Doc/using/cmdline.rst:538 msgid "" "If this is set, Python ignores case in :keyword:`import` statements. This " "only works on Windows and OS X." @@ -958,7 +967,7 @@ msgstr "" "Si elle est définie, Python ignore la casse dans les instructions :keyword:" "`import`. Ceci ne fonctionne que sous Windows et OS X." -#: ../Doc/using/cmdline.rst:533 +#: ../Doc/using/cmdline.rst:544 msgid "" "If this is set to a non-empty string, Python won't try to write ``.pyc`` " "files on the import of source modules. This is equivalent to specifying " @@ -968,7 +977,7 @@ msgstr "" "fichier ``.pyc`` à l'importation des modules sources. C'est équivalent à " "spécifier l'option :option:`-B`." -#: ../Doc/using/cmdline.rst:540 +#: ../Doc/using/cmdline.rst:551 msgid "" "If this variable is not set or set to ``random``, a random value is used to " "seed the hashes of str, bytes and datetime objects." @@ -977,7 +986,7 @@ msgstr "" "aléatoire est utilisée pour saler les empreintes des objets chaines, bytes " "et datetime." -#: ../Doc/using/cmdline.rst:543 +#: ../Doc/using/cmdline.rst:554 msgid "" "If :envvar:`PYTHONHASHSEED` is set to an integer value, it is used as a " "fixed seed for generating the hash() of the types covered by the hash " @@ -987,7 +996,7 @@ msgstr "" "utilisée comme valeur de salage pour générer les empreintes des types " "utilisant la randomisation du hachage." -#: ../Doc/using/cmdline.rst:547 +#: ../Doc/using/cmdline.rst:558 msgid "" "Its purpose is to allow repeatable hashing, such as for selftests for the " "interpreter itself, or to allow a cluster of python processes to share hash " @@ -997,7 +1006,7 @@ msgstr "" "l'interpréteur lui-même ou pour qu'un groupe de processus Python puisse " "partager des empreintes." -#: ../Doc/using/cmdline.rst:551 +#: ../Doc/using/cmdline.rst:562 msgid "" "The integer must be a decimal number in the range [0,4294967295]. " "Specifying the value 0 will disable hash randomization." @@ -1006,7 +1015,7 @@ msgstr "" "4 294 967 295. Spécifier la valeur 0 désactive la randomisation des " "empreintes." -#: ../Doc/using/cmdline.rst:559 +#: ../Doc/using/cmdline.rst:570 msgid "" "If this is set before running the interpreter, it overrides the encoding " "used for stdin/stdout/stderr, in the syntax ``encodingname:errorhandler``. " @@ -1020,7 +1029,7 @@ msgstr "" "facultatifs tous les deux et possèdent la même signification que dans :func:" "`str.encode`." -#: ../Doc/using/cmdline.rst:564 +#: ../Doc/using/cmdline.rst:575 msgid "" "For stderr, the ``:errorhandler`` part is ignored; the handler will always " "be ``'backslashreplace'``." @@ -1028,11 +1037,11 @@ msgstr "" "Pour la sortie d'erreur, la partie ``:gestionnaire_erreur`` est ignorée : le " "gestionnaire est toujours ``'backslashreplace'``." -#: ../Doc/using/cmdline.rst:567 +#: ../Doc/using/cmdline.rst:578 msgid "The ``encodingname`` part is now optional." msgstr "la partie ``nom_encodage`` est maintenant optionnelle." -#: ../Doc/using/cmdline.rst:570 +#: ../Doc/using/cmdline.rst:581 msgid "" "On Windows, the encoding specified by this variable is ignored for " "interactive console buffers unless :envvar:`PYTHONLEGACYWINDOWSSTDIO` is " @@ -1044,7 +1053,7 @@ msgstr "" "`PYTHONLEGACYWINDOWSSTDIO` ne soit aussi spécifié. Les fichiers et tubes " "(*pipes* en anglais) redirigés vers les flux standards ne sont pas concernés." -#: ../Doc/using/cmdline.rst:577 +#: ../Doc/using/cmdline.rst:588 msgid "" "If this is set, Python won't add the :data:`user site-packages directory " "` to :data:`sys.path`." @@ -1052,7 +1061,7 @@ msgstr "" "Si elle est définie, Python n'ajoute pas le répertoire :data:`site-packages " "utilisateur ` à :data:`sys.path`." -#: ../Doc/using/cmdline.rst:587 +#: ../Doc/using/cmdline.rst:598 msgid "" "Defines the :data:`user base directory `, which is used to " "compute the path of the :data:`user site-packages directory ` et :ref:`Installation alternative : le schéma " "user ` pour ``python setup.py install --user``." -#: ../Doc/using/cmdline.rst:599 +#: ../Doc/using/cmdline.rst:610 msgid "" "If this environment variable is set, ``sys.argv[0]`` will be set to its " "value instead of the value got through the C runtime. Only works on Mac OS " @@ -1074,7 +1083,7 @@ msgstr "" "la même valeur au lieu de la valeur fournie par l'exécutable. Ne fonctionne " "que sur Mac OS X." -#: ../Doc/using/cmdline.rst:605 +#: ../Doc/using/cmdline.rst:616 msgid "" "This is equivalent to the :option:`-W` option. If set to a comma separated " "string, it is equivalent to specifying :option:`-W` multiple times." @@ -1083,7 +1092,7 @@ msgstr "" "chaîne séparée par des virgules, c'est équivalent à spécifier l'option :" "option:`-W` plusieurs fois." -#: ../Doc/using/cmdline.rst:611 +#: ../Doc/using/cmdline.rst:622 msgid "" "If this environment variable is set to a non-empty string, :func:" "`faulthandler.enable` is called at startup: install a handler for :const:" @@ -1097,7 +1106,7 @@ msgstr "" "`SIGILL` afin de générer une trace de la pile d'appels. C'est équivalent à " "spécifier l'option :option:`-X` ``faulthandler``." -#: ../Doc/using/cmdline.rst:622 +#: ../Doc/using/cmdline.rst:633 msgid "" "If this environment variable is set to a non-empty string, start tracing " "Python memory allocations using the :mod:`tracemalloc` module. The value of " @@ -1112,7 +1121,7 @@ msgstr "" "ne stocke que l'appel le plus récent. Voir :func:`tracemalloc.start` pour " "davantage d'informations." -#: ../Doc/using/cmdline.rst:633 +#: ../Doc/using/cmdline.rst:644 msgid "" "If this environment variable is set to a non-empty string, enable the :ref:" "`debug mode ` of the :mod:`asyncio` module." @@ -1120,17 +1129,17 @@ msgstr "" "Si elle est définie à une chaîne non vide, active le :ref:`mode debogage " "` du module :mod:`asyncio`." -#: ../Doc/using/cmdline.rst:641 +#: ../Doc/using/cmdline.rst:652 msgid "Set the Python memory allocators and/or install debug hooks." msgstr "" "Définit l'allocateur mémoire de Python ou installe des fonctions " "automatiques de débogage." -#: ../Doc/using/cmdline.rst:643 +#: ../Doc/using/cmdline.rst:654 msgid "Set the family of memory allocators used by Python:" msgstr "Définit la famille d'allocateurs mémoire utilisés par Python :" -#: ../Doc/using/cmdline.rst:645 +#: ../Doc/using/cmdline.rst:656 msgid "" "``malloc``: use the :c:func:`malloc` function of the C library for all " "domains (:c:data:`PYMEM_DOMAIN_RAW`, :c:data:`PYMEM_DOMAIN_MEM`, :c:data:" @@ -1140,7 +1149,7 @@ msgstr "" "standard pour tous les domaines (:c:data:`PYMEM_DOMAIN_RAW`, :c:data:" "`PYMEM_DOMAIN_MEM`, :c:data:`PYMEM_DOMAIN_OBJ`)." -#: ../Doc/using/cmdline.rst:648 +#: ../Doc/using/cmdline.rst:659 msgid "" "``pymalloc``: use the :ref:`pymalloc allocator ` for :c:data:" "`PYMEM_DOMAIN_MEM` and :c:data:`PYMEM_DOMAIN_OBJ` domains and use the :c:" @@ -1151,29 +1160,29 @@ msgstr "" "utilise la fonction :c:func:`malloc` pour le domaine :c:data:" "`PYMEM_DOMAIN_RAW`." -#: ../Doc/using/cmdline.rst:652 +#: ../Doc/using/cmdline.rst:663 msgid "Install debug hooks:" msgstr "Installe des fonctions automatiques de débogage :" -#: ../Doc/using/cmdline.rst:654 +#: ../Doc/using/cmdline.rst:665 msgid "``debug``: install debug hooks on top of the default memory allocator" msgstr "" "``debug`` : installe des fonctions automatiques de débogage au-dessus de " "l'allocateur mémoire par défaut." -#: ../Doc/using/cmdline.rst:655 +#: ../Doc/using/cmdline.rst:666 msgid "``malloc_debug``: same as ``malloc`` but also install debug hooks" msgstr "" "``malloc_debug``: identique à ``malloc`` mais installe aussi des fonctions " "automatiques de débogage." -#: ../Doc/using/cmdline.rst:656 +#: ../Doc/using/cmdline.rst:667 msgid "``pymalloc_debug``: same as ``pymalloc`` but also install debug hooks" msgstr "" "``pymalloc_debug``: identique à ``pymalloc`` mais installe aussi des " "fonctions automatiques de débogage." -#: ../Doc/using/cmdline.rst:658 +#: ../Doc/using/cmdline.rst:669 msgid "" "When Python is compiled in release mode, the default is ``pymalloc``. When " "compiled in debug mode, the default is ``pymalloc_debug`` and the debug " @@ -1184,7 +1193,7 @@ msgstr "" "est ``pymalloc_debug`` et les fonctions automatiques de débogage sont " "utilisées automatiquement." -#: ../Doc/using/cmdline.rst:662 +#: ../Doc/using/cmdline.rst:673 msgid "" "If Python is configured without ``pymalloc`` support, ``pymalloc`` and " "``pymalloc_debug`` are not available, the default is ``malloc`` in release " @@ -1194,7 +1203,7 @@ msgstr "" "``pymalloc_debug`` ne sont pas disponibles. Les valeurs par défaut sont " "``malloc`` en mode \"release\" et ``malloc_debug`` en mode débogage." -#: ../Doc/using/cmdline.rst:666 +#: ../Doc/using/cmdline.rst:677 msgid "" "See the :c:func:`PyMem_SetupDebugHooks` function for debug hooks on Python " "memory allocators." @@ -1203,7 +1212,7 @@ msgstr "" "concerne les fonctions automatiques de débogage de l'allocateur mémoire de " "Python." -#: ../Doc/using/cmdline.rst:674 +#: ../Doc/using/cmdline.rst:685 msgid "" "If set to a non-empty string, Python will print statistics of the :ref:" "`pymalloc memory allocator ` every time a new pymalloc object " @@ -1214,7 +1223,7 @@ msgstr "" "qu'un objet est créé par ce gestionnaire, ainsi qu'à la fin de l'exécution " "du programme." -#: ../Doc/using/cmdline.rst:678 +#: ../Doc/using/cmdline.rst:689 msgid "" "This variable is ignored if the :envvar:`PYTHONMALLOC` environment variable " "is used to force the :c:func:`malloc` allocator of the C library, or if " @@ -1225,7 +1234,7 @@ msgstr "" "bibliothèque C standard ou si Python est configuré sans le support de " "``pymalloc``." -#: ../Doc/using/cmdline.rst:682 +#: ../Doc/using/cmdline.rst:693 msgid "" "This variable can now also be used on Python compiled in release mode. It " "now has no effect if set to an empty string." @@ -1233,7 +1242,7 @@ msgstr "" "Cette variable peut maintenant être utilisée avec Python compilé en mode " "\"release\". Elle n'a pas d'effet si elle est définie à une chaine vide." -#: ../Doc/using/cmdline.rst:689 +#: ../Doc/using/cmdline.rst:700 msgid "" "If set to a non-empty string, the default filesystem encoding and errors " "mode will revert to their pre-3.6 values of 'mbcs' and 'replace', " @@ -1245,7 +1254,7 @@ msgstr "" "valeur pré-3.6, respectivement 'mbcs' et 'replace'. Sinon, les nouvelles " "valeurs par défaut 'utf-8' et 'surrogatepass' sont utilisées." -#: ../Doc/using/cmdline.rst:693 +#: ../Doc/using/cmdline.rst:704 msgid "" "This may also be enabled at runtime with :func:`sys." "_enablelegacywindowsfsencoding()`." @@ -1253,15 +1262,15 @@ msgstr "" "Vous pouvez aussi activer ceci à l'exécution avec :func:`sys." "_enablelegacywindowsfsencoding()`." -#: ../Doc/using/cmdline.rst:696 ../Doc/using/cmdline.rst:710 +#: ../Doc/using/cmdline.rst:707 ../Doc/using/cmdline.rst:721 msgid "Availability: Windows" msgstr "Disponibilité : Windows" -#: ../Doc/using/cmdline.rst:698 +#: ../Doc/using/cmdline.rst:709 msgid "See :pep:`529` for more details." msgstr "Voir la :pep:`529` pour plus d'informations." -#: ../Doc/using/cmdline.rst:703 +#: ../Doc/using/cmdline.rst:714 msgid "" "If set to a non-empty string, does not use the new console reader and " "writer. This means that Unicode characters will be encoded according to the " @@ -1271,7 +1280,7 @@ msgstr "" "et écrivain de la nouvelle console. Cela signifie que les caractères Unicode " "sont encodés avec l'encodage de la console active plutôt qu'en utf-8." -#: ../Doc/using/cmdline.rst:707 +#: ../Doc/using/cmdline.rst:718 msgid "" "This variable is ignored if the standard streams are redirected (to files or " "pipes) rather than referring to console buffers." @@ -1280,11 +1289,11 @@ msgstr "" "fichiers ou des tubes) plutôt que pointant vers des mémoires tampons de " "console." -#: ../Doc/using/cmdline.rst:715 +#: ../Doc/using/cmdline.rst:726 msgid "Debug-mode variables" msgstr "Variables en mode débogage" -#: ../Doc/using/cmdline.rst:717 +#: ../Doc/using/cmdline.rst:728 msgid "" "Setting these variables only has an effect in a debug build of Python, that " "is, if Python was configured with the ``--with-pydebug`` build option." @@ -1293,13 +1302,13 @@ msgstr "" "débogage, c'est-à-dire que l'option de compilation ``--with-pydebug`` a été " "spécifiée." -#: ../Doc/using/cmdline.rst:722 +#: ../Doc/using/cmdline.rst:733 msgid "If set, Python will print threading debug info." msgstr "" "Si elle est définie, Python affiche des informations de débogage relatives " "aux différents fils d'exécution." -#: ../Doc/using/cmdline.rst:727 +#: ../Doc/using/cmdline.rst:738 msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter." @@ -1308,6 +1317,15 @@ msgstr "" "compteurs de références toujours existant après la fermeture de " "l'interpréteur." +#~ msgid "Turn on basic optimizations. See also :envvar:`PYTHONOPTIMIZE`." +#~ msgstr "" +#~ "Active les optimisations basiques. Voir aussi :envvar:`PYTHONOPTIMIZE`." + +#~ msgid "Discard docstrings in addition to the :option:`-O` optimizations." +#~ msgstr "" +#~ "Supprime les docstrings en plus des optimisations réalisées par :option:`-" +#~ "O`." + #~ msgid "The line numbers in error messages will be off by one." #~ msgstr "" #~ "Les numéros de ligne dans les messages d'erreur seront décalés de un." diff --git a/using/unix.po b/using/unix.po index 7c35d7b5..a17d3094 100644 --- a/using/unix.po +++ b/using/unix.po @@ -8,7 +8,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2017-09-12 13:37+0200\n" +"POT-Creation-Date: 2018-03-23 09:03+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" @@ -87,29 +87,29 @@ msgid "FreeBSD users, to add the package use::" msgstr "" #: ../Doc/using/unix.rst:46 -msgid "OpenBSD users use::" +msgid "OpenBSD users, to add the package use::" msgstr "" -#: ../Doc/using/unix.rst:50 +#: ../Doc/using/unix.rst:52 msgid "For example i386 users get the 2.5.1 version of Python using::" msgstr "" -#: ../Doc/using/unix.rst:56 +#: ../Doc/using/unix.rst:58 msgid "On OpenSolaris" msgstr "" -#: ../Doc/using/unix.rst:58 +#: ../Doc/using/unix.rst:60 msgid "" "You can get Python from `OpenCSW `_. Various " "versions of Python are available and can be installed with e.g. ``pkgutil -i " "python27``." msgstr "" -#: ../Doc/using/unix.rst:65 +#: ../Doc/using/unix.rst:67 msgid "Building Python" msgstr "" -#: ../Doc/using/unix.rst:67 +#: ../Doc/using/unix.rst:69 msgid "" "If you want to compile CPython yourself, first thing you should do is get " "the `source `_. You can download " @@ -118,29 +118,29 @@ msgid "" "contribute patches, you will need a clone.)" msgstr "" -#: ../Doc/using/unix.rst:73 +#: ../Doc/using/unix.rst:75 msgid "The build process consists in the usual ::" msgstr "" -#: ../Doc/using/unix.rst:79 +#: ../Doc/using/unix.rst:81 msgid "" "invocations. Configuration options and caveats for specific Unix platforms " "are extensively documented in the :source:`README.rst` file in the root of " "the Python source tree." msgstr "" -#: ../Doc/using/unix.rst:85 +#: ../Doc/using/unix.rst:87 msgid "" "``make install`` can overwrite or masquerade the :file:`python3` binary. " "``make altinstall`` is therefore recommended instead of ``make install`` " "since it only installs :file:`{exec_prefix}/bin/python{version}`." msgstr "" -#: ../Doc/using/unix.rst:91 +#: ../Doc/using/unix.rst:93 msgid "Python-related paths and files" msgstr "" -#: ../Doc/using/unix.rst:93 +#: ../Doc/using/unix.rst:95 msgid "" "These are subject to difference depending on local installation " "conventions; :envvar:`prefix` (``${prefix}``) and :envvar:`exec_prefix` (``" @@ -148,91 +148,91 @@ msgid "" "for GNU software; they may be the same." msgstr "" -#: ../Doc/using/unix.rst:98 +#: ../Doc/using/unix.rst:100 msgid "" "For example, on most Linux systems, the default for both is :file:`/usr`." msgstr "" -#: ../Doc/using/unix.rst:101 +#: ../Doc/using/unix.rst:103 msgid "File/directory" msgstr "" -#: ../Doc/using/unix.rst:101 +#: ../Doc/using/unix.rst:103 msgid "Meaning" msgstr "Signification" -#: ../Doc/using/unix.rst:103 +#: ../Doc/using/unix.rst:105 msgid ":file:`{exec_prefix}/bin/python3`" msgstr "" -#: ../Doc/using/unix.rst:103 +#: ../Doc/using/unix.rst:105 msgid "Recommended location of the interpreter." msgstr "" -#: ../Doc/using/unix.rst:105 +#: ../Doc/using/unix.rst:107 msgid "" ":file:`{prefix}/lib/python{version}`, :file:`{exec_prefix}/lib/" "python{version}`" msgstr "" -#: ../Doc/using/unix.rst:105 +#: ../Doc/using/unix.rst:107 msgid "" "Recommended locations of the directories containing the standard modules." msgstr "" -#: ../Doc/using/unix.rst:108 +#: ../Doc/using/unix.rst:110 msgid "" ":file:`{prefix}/include/python{version}`, :file:`{exec_prefix}/include/" "python{version}`" msgstr "" -#: ../Doc/using/unix.rst:108 +#: ../Doc/using/unix.rst:110 msgid "" "Recommended locations of the directories containing the include files needed " "for developing Python extensions and embedding the interpreter." msgstr "" -#: ../Doc/using/unix.rst:116 +#: ../Doc/using/unix.rst:118 msgid "Miscellaneous" msgstr "" -#: ../Doc/using/unix.rst:118 +#: ../Doc/using/unix.rst:120 msgid "" "To easily use Python scripts on Unix, you need to make them executable, e.g. " "with ::" msgstr "" -#: ../Doc/using/unix.rst:123 +#: ../Doc/using/unix.rst:125 msgid "" "and put an appropriate Shebang line at the top of the script. A good choice " "is usually ::" msgstr "" -#: ../Doc/using/unix.rst:128 +#: ../Doc/using/unix.rst:130 msgid "" "which searches for the Python interpreter in the whole :envvar:`PATH`. " "However, some Unices may not have the :program:`env` command, so you may " "need to hardcode ``/usr/bin/python3`` as the interpreter path." msgstr "" -#: ../Doc/using/unix.rst:132 +#: ../Doc/using/unix.rst:134 msgid "" "To use shell commands in your Python scripts, look at the :mod:`subprocess` " "module." msgstr "" -#: ../Doc/using/unix.rst:136 +#: ../Doc/using/unix.rst:138 msgid "Editors and IDEs" msgstr "" -#: ../Doc/using/unix.rst:138 +#: ../Doc/using/unix.rst:140 msgid "" "There are a number of IDEs that support Python programming language. Many " "editors and IDEs provide syntax highlighting, debugging tools, and PEP-8 " "checks." msgstr "" -#: ../Doc/using/unix.rst:141 +#: ../Doc/using/unix.rst:143 msgid "" "Please go to `Python Editors `_ " "and `Integrated Development Environments