1
0
Fork 0
python-docs-fr/library/inspect.po

1725 lines
52 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-02-04 10:00+0100\n"
"PO-Revision-Date: 2019-09-06 13:49+0200\n"
"Last-Translator: Julien Palard <julien@palard.fr>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Poedit 1.8.11\n"
#: ../Doc/library/inspect.rst:2
msgid ":mod:`inspect` --- Inspect live objects"
msgstr ""
#: ../Doc/library/inspect.rst:10
msgid "**Source code:** :source:`Lib/inspect.py`"
msgstr "**Code source :** :source:`Lib/inspect.py`"
#: ../Doc/library/inspect.rst:14
msgid ""
"The :mod:`inspect` module provides several useful functions to help get "
"information about live objects such as modules, classes, methods, functions, "
"tracebacks, frame objects, and code objects. For example, it can help you "
"examine the contents of a class, retrieve the source code of a method, "
"extract and format the argument list for a function, or get all the "
"information you need to display a detailed traceback."
msgstr ""
#: ../Doc/library/inspect.rst:21
msgid ""
"There are four main kinds of services provided by this module: type "
"checking, getting source code, inspecting classes and functions, and "
"examining the interpreter stack."
msgstr ""
#: ../Doc/library/inspect.rst:29
msgid "Types and members"
msgstr ""
#: ../Doc/library/inspect.rst:31
msgid ""
"The :func:`getmembers` function retrieves the members of an object such as a "
"class or module. The functions whose names begin with \"is\" are mainly "
"provided as convenient choices for the second argument to :func:"
"`getmembers`. They also help you determine when you can expect to find the "
"following special attributes:"
msgstr ""
#: ../Doc/library/inspect.rst:41
msgid "Type"
msgstr "Type"
#: ../Doc/library/inspect.rst:41
msgid "Attribute"
msgstr "Attribut"
#: ../Doc/library/inspect.rst:41
msgid "Description"
msgstr "Description"
#: ../Doc/library/inspect.rst:43
msgid "module"
msgstr "module"
#: ../Doc/library/inspect.rst:43 ../Doc/library/inspect.rst:48
#: ../Doc/library/inspect.rst:58 ../Doc/library/inspect.rst:76
#: ../Doc/library/inspect.rst:231
msgid "__doc__"
msgstr "__doc__"
#: ../Doc/library/inspect.rst:43 ../Doc/library/inspect.rst:48
#: ../Doc/library/inspect.rst:58 ../Doc/library/inspect.rst:76
#: ../Doc/library/inspect.rst:231
msgid "documentation string"
msgstr ""
#: ../Doc/library/inspect.rst:45
msgid "__file__"
msgstr "__file__"
#: ../Doc/library/inspect.rst:45
msgid "filename (missing for built-in modules)"
msgstr ""
#: ../Doc/library/inspect.rst:48
msgid "class"
msgstr "classe"
#: ../Doc/library/inspect.rst:50 ../Doc/library/inspect.rst:60
#: ../Doc/library/inspect.rst:78 ../Doc/library/inspect.rst:200
#: ../Doc/library/inspect.rst:214 ../Doc/library/inspect.rst:233
msgid "__name__"
msgstr "__name__"
#: ../Doc/library/inspect.rst:50
msgid "name with which this class was defined"
msgstr ""
#: ../Doc/library/inspect.rst:53 ../Doc/library/inspect.rst:63
#: ../Doc/library/inspect.rst:81 ../Doc/library/inspect.rst:202
#: ../Doc/library/inspect.rst:216 ../Doc/library/inspect.rst:236
msgid "__qualname__"
msgstr "__qualname__"
#: ../Doc/library/inspect.rst:53 ../Doc/library/inspect.rst:63
#: ../Doc/library/inspect.rst:81 ../Doc/library/inspect.rst:202
#: ../Doc/library/inspect.rst:216 ../Doc/library/inspect.rst:236
msgid "qualified name"
msgstr "nom qualifié"
#: ../Doc/library/inspect.rst:55 ../Doc/library/inspect.rst:73
#: ../Doc/library/inspect.rst:104
msgid "__module__"
msgstr "__module__"
#: ../Doc/library/inspect.rst:55
msgid "name of module in which this class was defined"
msgstr ""
#: ../Doc/library/inspect.rst:58
msgid "method"
msgstr "méthode"
#: ../Doc/library/inspect.rst:60
msgid "name with which this method was defined"
msgstr ""
#: ../Doc/library/inspect.rst:65
msgid "__func__"
msgstr "__func__"
#: ../Doc/library/inspect.rst:65
msgid "function object containing implementation of method"
msgstr ""
#: ../Doc/library/inspect.rst:69 ../Doc/library/inspect.rst:238
msgid "__self__"
msgstr "__self__"
#: ../Doc/library/inspect.rst:69
msgid "instance to which this method is bound, or ``None``"
msgstr ""
#: ../Doc/library/inspect.rst:73
msgid "name of module in which this method was defined"
msgstr ""
#: ../Doc/library/inspect.rst:76
msgid "function"
msgstr "fonction"
#: ../Doc/library/inspect.rst:78
msgid "name with which this function was defined"
msgstr ""
#: ../Doc/library/inspect.rst:83
msgid "__code__"
msgstr "__code__"
#: ../Doc/library/inspect.rst:83
msgid "code object containing compiled function :term:`bytecode`"
msgstr ""
#: ../Doc/library/inspect.rst:87
msgid "__defaults__"
msgstr "__defaults__"
#: ../Doc/library/inspect.rst:87
msgid "tuple of any default values for positional or keyword parameters"
msgstr ""
#: ../Doc/library/inspect.rst:91
msgid "__kwdefaults__"
msgstr "__kwdefaults__"
#: ../Doc/library/inspect.rst:91
msgid "mapping of any default values for keyword-only parameters"
msgstr ""
#: ../Doc/library/inspect.rst:95
msgid "__globals__"
msgstr "__globals__"
#: ../Doc/library/inspect.rst:95
msgid "global namespace in which this function was defined"
msgstr ""
#: ../Doc/library/inspect.rst:98
msgid "__annotations__"
msgstr "__annotations__"
#: ../Doc/library/inspect.rst:98
msgid ""
"mapping of parameters names to annotations; ``\"return\"`` key is reserved "
"for return annotations."
msgstr ""
#: ../Doc/library/inspect.rst:104
msgid "name of module in which this function was defined"
msgstr ""
#: ../Doc/library/inspect.rst:107
msgid "traceback"
msgstr "traceback"
#: ../Doc/library/inspect.rst:107
msgid "tb_frame"
msgstr "tb_frame"
#: ../Doc/library/inspect.rst:107
msgid "frame object at this level"
msgstr ""
#: ../Doc/library/inspect.rst:110
msgid "tb_lasti"
msgstr "tb_lasti"
#: ../Doc/library/inspect.rst:110 ../Doc/library/inspect.rst:132
msgid "index of last attempted instruction in bytecode"
msgstr ""
#: ../Doc/library/inspect.rst:113
msgid "tb_lineno"
msgstr "tb_lineno"
#: ../Doc/library/inspect.rst:113 ../Doc/library/inspect.rst:135
msgid "current line number in Python source code"
msgstr ""
#: ../Doc/library/inspect.rst:116
msgid "tb_next"
msgstr "tb_next"
#: ../Doc/library/inspect.rst:116
msgid "next inner traceback object (called by this level)"
msgstr ""
#: ../Doc/library/inspect.rst:120 ../Doc/library/inspect.rst:204
#: ../Doc/library/inspect.rst:221
msgid "frame"
msgstr ""
#: ../Doc/library/inspect.rst:120
msgid "f_back"
msgstr "f_back"
#: ../Doc/library/inspect.rst:120
msgid "next outer frame object (this frame's caller)"
msgstr ""
#: ../Doc/library/inspect.rst:123
msgid "f_builtins"
msgstr "f_builtins"
#: ../Doc/library/inspect.rst:123
msgid "builtins namespace seen by this frame"
msgstr ""
#: ../Doc/library/inspect.rst:126
msgid "f_code"
msgstr "f_code"
#: ../Doc/library/inspect.rst:126
msgid "code object being executed in this frame"
msgstr ""
#: ../Doc/library/inspect.rst:129
msgid "f_globals"
msgstr "f_globals"
#: ../Doc/library/inspect.rst:129
msgid "global namespace seen by this frame"
msgstr ""
#: ../Doc/library/inspect.rst:132
msgid "f_lasti"
msgstr "f_lasti"
#: ../Doc/library/inspect.rst:135
msgid "f_lineno"
msgstr "f_lineno"
#: ../Doc/library/inspect.rst:138
msgid "f_locals"
msgstr "f_locals"
#: ../Doc/library/inspect.rst:138
msgid "local namespace seen by this frame"
msgstr ""
#: ../Doc/library/inspect.rst:141
msgid "f_trace"
msgstr "f_trace"
#: ../Doc/library/inspect.rst:141
msgid "tracing function for this frame, or ``None``"
msgstr ""
#: ../Doc/library/inspect.rst:144 ../Doc/library/inspect.rst:208
#: ../Doc/library/inspect.rst:225
msgid "code"
msgstr ""
#: ../Doc/library/inspect.rst:144
msgid "co_argcount"
msgstr "co_argcount"
#: ../Doc/library/inspect.rst:144
msgid ""
"number of arguments (not including keyword only arguments, \\* or \\*\\* "
"args)"
msgstr ""
#: ../Doc/library/inspect.rst:149
msgid "co_code"
msgstr "co_code"
#: ../Doc/library/inspect.rst:149
msgid "string of raw compiled bytecode"
msgstr ""
#: ../Doc/library/inspect.rst:152
msgid "co_cellvars"
msgstr ""
#: ../Doc/library/inspect.rst:152
msgid "tuple of names of cell variables (referenced by containing scopes)"
msgstr ""
#: ../Doc/library/inspect.rst:156
msgid "co_consts"
msgstr "co_consts"
#: ../Doc/library/inspect.rst:156
msgid "tuple of constants used in the bytecode"
msgstr ""
#: ../Doc/library/inspect.rst:159
msgid "co_filename"
msgstr "co_filename"
#: ../Doc/library/inspect.rst:159
msgid "name of file in which this code object was created"
msgstr ""
#: ../Doc/library/inspect.rst:163
msgid "co_firstlineno"
msgstr "co_firstlineno"
#: ../Doc/library/inspect.rst:163
msgid "number of first line in Python source code"
msgstr ""
#: ../Doc/library/inspect.rst:166
msgid "co_flags"
msgstr "co_flags"
#: ../Doc/library/inspect.rst:166
msgid ""
"bitmap of ``CO_*`` flags, read more :ref:`here <inspect-module-co-flags>`"
msgstr ""
#: ../Doc/library/inspect.rst:170
msgid "co_lnotab"
msgstr "co_lnotab"
#: ../Doc/library/inspect.rst:170
msgid "encoded mapping of line numbers to bytecode indices"
msgstr ""
#: ../Doc/library/inspect.rst:174
msgid "co_freevars"
msgstr "co_freevars"
#: ../Doc/library/inspect.rst:174
msgid "tuple of names of free variables (referenced via a function's closure)"
msgstr ""
#: ../Doc/library/inspect.rst:178
msgid "co_posonlyargcount"
msgstr "co_posonlyargcount"
#: ../Doc/library/inspect.rst:178
msgid "number of positional only arguments"
msgstr ""
#: ../Doc/library/inspect.rst:181
msgid "co_kwonlyargcount"
msgstr "co_kwonlyargcount"
#: ../Doc/library/inspect.rst:181
msgid "number of keyword only arguments (not including \\*\\* arg)"
msgstr ""
#: ../Doc/library/inspect.rst:185
msgid "co_name"
msgstr "co_name"
#: ../Doc/library/inspect.rst:185
msgid "name with which this code object was defined"
msgstr ""
#: ../Doc/library/inspect.rst:188
msgid "co_names"
msgstr "co_names"
#: ../Doc/library/inspect.rst:188
msgid "tuple of names of local variables"
msgstr ""
#: ../Doc/library/inspect.rst:191
msgid "co_nlocals"
msgstr "co_nlocals"
#: ../Doc/library/inspect.rst:191
msgid "number of local variables"
msgstr ""
#: ../Doc/library/inspect.rst:193
msgid "co_stacksize"
msgstr "co_stacksize"
#: ../Doc/library/inspect.rst:193
msgid "virtual machine stack space required"
msgstr ""
#: ../Doc/library/inspect.rst:196
msgid "co_varnames"
msgstr "co_varnames"
#: ../Doc/library/inspect.rst:196
msgid "tuple of names of arguments and local variables"
msgstr ""
#: ../Doc/library/inspect.rst:200
msgid "generator"
msgstr "générateur"
#: ../Doc/library/inspect.rst:200 ../Doc/library/inspect.rst:214
msgid "name"
msgstr ""
#: ../Doc/library/inspect.rst:204
msgid "gi_frame"
msgstr "gi_frame"
#: ../Doc/library/inspect.rst:206
msgid "gi_running"
msgstr "gi_running"
#: ../Doc/library/inspect.rst:206
msgid "is the generator running?"
msgstr ""
#: ../Doc/library/inspect.rst:208
msgid "gi_code"
msgstr "gi_code"
#: ../Doc/library/inspect.rst:210
msgid "gi_yieldfrom"
msgstr "gi_yieldfrom"
#: ../Doc/library/inspect.rst:210
msgid "object being iterated by ``yield from``, or ``None``"
msgstr ""
#: ../Doc/library/inspect.rst:214
msgid "coroutine"
msgstr "coroutine"
#: ../Doc/library/inspect.rst:218
msgid "cr_await"
msgstr "cr_await"
#: ../Doc/library/inspect.rst:218
msgid "object being awaited on, or ``None``"
msgstr ""
#: ../Doc/library/inspect.rst:221
msgid "cr_frame"
msgstr "cr_frame"
#: ../Doc/library/inspect.rst:223
msgid "cr_running"
msgstr "cr_running"
#: ../Doc/library/inspect.rst:223
msgid "is the coroutine running?"
msgstr ""
#: ../Doc/library/inspect.rst:225
msgid "cr_code"
msgstr "cr_code"
#: ../Doc/library/inspect.rst:227
msgid "cr_origin"
msgstr ""
#: ../Doc/library/inspect.rst:227
msgid "where coroutine was created, or ``None``. See |coroutine-origin-link|"
msgstr ""
#: ../Doc/library/inspect.rst:231
msgid "builtin"
msgstr ""
#: ../Doc/library/inspect.rst:233
msgid "original name of this function or method"
msgstr ""
#: ../Doc/library/inspect.rst:238
msgid "instance to which a method is bound, or ``None``"
msgstr ""
#: ../Doc/library/inspect.rst:245
msgid "Add ``__qualname__`` and ``gi_yieldfrom`` attributes to generators."
msgstr ""
#: ../Doc/library/inspect.rst:247
msgid ""
"The ``__name__`` attribute of generators is now set from the function name, "
"instead of the code name, and it can now be modified."
msgstr ""
#: ../Doc/library/inspect.rst:252
msgid "Add ``cr_origin`` attribute to coroutines."
msgstr ""
#: ../Doc/library/inspect.rst:256
msgid ""
"Return all the members of an object in a list of ``(name, value)`` pairs "
"sorted by name. If the optional *predicate* argument—which will be called "
"with the ``value`` object of each member—is supplied, only members for which "
"the predicate returns a true value are included."
msgstr ""
#: ../Doc/library/inspect.rst:263
msgid ""
":func:`getmembers` will only return class attributes defined in the "
"metaclass when the argument is a class and those attributes have been listed "
"in the metaclass' custom :meth:`__dir__`."
msgstr ""
#: ../Doc/library/inspect.rst:270
msgid ""
"Return the name of the module named by the file *path*, without including "
"the names of enclosing packages. The file extension is checked against all "
"of the entries in :func:`importlib.machinery.all_suffixes`. If it matches, "
"the final path component is returned with the extension removed. Otherwise, "
"``None`` is returned."
msgstr ""
#: ../Doc/library/inspect.rst:276
msgid ""
"Note that this function *only* returns a meaningful name for actual Python "
"modules - paths that potentially refer to Python packages will still return "
"``None``."
msgstr ""
#: ../Doc/library/inspect.rst:280
msgid "The function is based directly on :mod:`importlib`."
msgstr ""
#: ../Doc/library/inspect.rst:286
msgid "Return ``True`` if the object is a module."
msgstr ""
#: ../Doc/library/inspect.rst:291
msgid ""
"Return ``True`` if the object is a class, whether built-in or created in "
"Python code."
msgstr ""
#: ../Doc/library/inspect.rst:297
msgid "Return ``True`` if the object is a bound method written in Python."
msgstr ""
#: ../Doc/library/inspect.rst:302
msgid ""
"Return ``True`` if the object is a Python function, which includes functions "
"created by a :term:`lambda` expression."
msgstr ""
#: ../Doc/library/inspect.rst:308
msgid "Return ``True`` if the object is a Python generator function."
msgstr ""
#: ../Doc/library/inspect.rst:310
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
"wrapped function is a Python generator function."
msgstr ""
#: ../Doc/library/inspect.rst:317
msgid "Return ``True`` if the object is a generator."
msgstr ""
#: ../Doc/library/inspect.rst:322
msgid ""
"Return ``True`` if the object is a :term:`coroutine function` (a function "
"defined with an :keyword:`async def` syntax)."
msgstr ""
#: ../Doc/library/inspect.rst:327
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
"wrapped function is a :term:`coroutine function`."
msgstr ""
#: ../Doc/library/inspect.rst:334
msgid ""
"Return ``True`` if the object is a :term:`coroutine` created by an :keyword:"
"`async def` function."
msgstr ""
#: ../Doc/library/inspect.rst:342
msgid ""
"Return ``True`` if the object can be used in :keyword:`await` expression."
msgstr ""
#: ../Doc/library/inspect.rst:344
msgid ""
"Can also be used to distinguish generator-based coroutines from regular "
"generators::"
msgstr ""
#: ../Doc/library/inspect.rst:361
msgid ""
"Return ``True`` if the object is an :term:`asynchronous generator` function, "
"for example::"
msgstr ""
#: ../Doc/library/inspect.rst:372
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
"wrapped function is a :term:`asynchronous generator` function."
msgstr ""
#: ../Doc/library/inspect.rst:379
msgid ""
"Return ``True`` if the object is an :term:`asynchronous generator iterator` "
"created by an :term:`asynchronous generator` function."
msgstr ""
#: ../Doc/library/inspect.rst:386
msgid "Return ``True`` if the object is a traceback."
msgstr ""
#: ../Doc/library/inspect.rst:391
msgid "Return ``True`` if the object is a frame."
msgstr ""
#: ../Doc/library/inspect.rst:396
msgid "Return ``True`` if the object is a code."
msgstr ""
#: ../Doc/library/inspect.rst:401
msgid ""
"Return ``True`` if the object is a built-in function or a bound built-in "
"method."
msgstr ""
#: ../Doc/library/inspect.rst:406
msgid ""
"Return ``True`` if the object is a user-defined or built-in function or "
"method."
msgstr ""
#: ../Doc/library/inspect.rst:411
msgid "Return ``True`` if the object is an abstract base class."
msgstr ""
#: ../Doc/library/inspect.rst:416
msgid ""
"Return ``True`` if the object is a method descriptor, but not if :func:"
"`ismethod`, :func:`isclass`, :func:`isfunction` or :func:`isbuiltin` are "
"true."
msgstr ""
#: ../Doc/library/inspect.rst:420
msgid ""
"This, for example, is true of ``int.__add__``. An object passing this test "
"has a :meth:`~object.__get__` method but not a :meth:`~object.__set__` "
"method, but beyond that the set of attributes varies. A :attr:`~definition."
"__name__` attribute is usually sensible, and :attr:`__doc__` often is."
msgstr ""
#: ../Doc/library/inspect.rst:426
msgid ""
"Methods implemented via descriptors that also pass one of the other tests "
"return ``False`` from the :func:`ismethoddescriptor` test, simply because "
"the other tests promise more -- you can, e.g., count on having the :attr:"
"`__func__` attribute (etc) when an object passes :func:`ismethod`."
msgstr ""
#: ../Doc/library/inspect.rst:434
msgid "Return ``True`` if the object is a data descriptor."
msgstr ""
#: ../Doc/library/inspect.rst:436
msgid ""
"Data descriptors have a :attr:`~object.__set__` or a :attr:`~object."
"__delete__` method. Examples are properties (defined in Python), getsets, "
"and members. The latter two are defined in C and there are more specific "
"tests available for those types, which is robust across Python "
"implementations. Typically, data descriptors will also have :attr:"
"`~definition.__name__` and :attr:`__doc__` attributes (properties, getsets, "
"and members have both of these attributes), but this is not guaranteed."
msgstr ""
#: ../Doc/library/inspect.rst:447
msgid "Return ``True`` if the object is a getset descriptor."
msgstr ""
#: ../Doc/library/inspect.rst:451
msgid ""
"getsets are attributes defined in extension modules via :c:type:"
"`PyGetSetDef` structures. For Python implementations without such types, "
"this method will always return ``False``."
msgstr ""
#: ../Doc/library/inspect.rst:458
msgid "Return ``True`` if the object is a member descriptor."
msgstr ""
#: ../Doc/library/inspect.rst:462
msgid ""
"Member descriptors are attributes defined in extension modules via :c:type:"
"`PyMemberDef` structures. For Python implementations without such types, "
"this method will always return ``False``."
msgstr ""
#: ../Doc/library/inspect.rst:470
msgid "Retrieving source code"
msgstr ""
#: ../Doc/library/inspect.rst:474
msgid ""
"Get the documentation string for an object, cleaned up with :func:"
"`cleandoc`. If the documentation string for an object is not provided and "
"the object is a class, a method, a property or a descriptor, retrieve the "
"documentation string from the inheritance hierarchy."
msgstr ""
#: ../Doc/library/inspect.rst:479
msgid "Documentation strings are now inherited if not overridden."
msgstr ""
#: ../Doc/library/inspect.rst:485
msgid ""
"Return in a single string any lines of comments immediately preceding the "
"object's source code (for a class, function, or method), or at the top of "
"the Python source file (if the object is a module). If the object's source "
"code is unavailable, return ``None``. This could happen if the object has "
"been defined in C or the interactive shell."
msgstr ""
#: ../Doc/library/inspect.rst:494
msgid ""
"Return the name of the (text or binary) file in which an object was defined. "
"This will fail with a :exc:`TypeError` if the object is a built-in module, "
"class, or function."
msgstr ""
#: ../Doc/library/inspect.rst:501
msgid "Try to guess which module an object was defined in."
msgstr ""
#: ../Doc/library/inspect.rst:506
msgid ""
"Return the name of the Python source file in which an object was defined. "
"This will fail with a :exc:`TypeError` if the object is a built-in module, "
"class, or function."
msgstr ""
#: ../Doc/library/inspect.rst:513
msgid ""
"Return a list of source lines and starting line number for an object. The "
"argument may be a module, class, method, function, traceback, frame, or code "
"object. The source code is returned as a list of the lines corresponding to "
"the object and the line number indicates where in the original source file "
"the first line of code was found. An :exc:`OSError` is raised if the source "
"code cannot be retrieved."
msgstr ""
#: ../Doc/library/inspect.rst:520 ../Doc/library/inspect.rst:532
msgid ""
":exc:`OSError` is raised instead of :exc:`IOError`, now an alias of the "
"former."
msgstr ""
#: ../Doc/library/inspect.rst:527
msgid ""
"Return the text of the source code for an object. The argument may be a "
"module, class, method, function, traceback, frame, or code object. The "
"source code is returned as a single string. An :exc:`OSError` is raised if "
"the source code cannot be retrieved."
msgstr ""
#: ../Doc/library/inspect.rst:539
msgid ""
"Clean up indentation from docstrings that are indented to line up with "
"blocks of code."
msgstr ""
#: ../Doc/library/inspect.rst:542
msgid ""
"All leading whitespace is removed from the first line. Any leading "
"whitespace that can be uniformly removed from the second line onwards is "
"removed. Empty lines at the beginning and end are subsequently removed. "
"Also, all tabs are expanded to spaces."
msgstr ""
#: ../Doc/library/inspect.rst:551
msgid "Introspecting callables with the Signature object"
msgstr ""
#: ../Doc/library/inspect.rst:555
msgid ""
"The Signature object represents the call signature of a callable object and "
"its return annotation. To retrieve a Signature object, use the :func:"
"`signature` function."
msgstr ""
#: ../Doc/library/inspect.rst:561
msgid "Return a :class:`Signature` object for the given ``callable``::"
msgstr ""
#: ../Doc/library/inspect.rst:578
msgid ""
"Accepts a wide range of Python callables, from plain functions and classes "
"to :func:`functools.partial` objects."
msgstr ""
#: ../Doc/library/inspect.rst:581
msgid ""
"Raises :exc:`ValueError` if no signature can be provided, and :exc:"
"`TypeError` if that type of object is not supported."
msgstr ""
#: ../Doc/library/inspect.rst:584
msgid ""
"A slash(/) in the signature of a function denotes that the parameters prior "
"to it are positional-only. For more info, see :ref:`the FAQ entry on "
"positional-only parameters <faq-positional-only-arguments>`."
msgstr ""
#: ../Doc/library/inspect.rst:588
msgid ""
"``follow_wrapped`` parameter. Pass ``False`` to get a signature of "
"``callable`` specifically (``callable.__wrapped__`` will not be used to "
"unwrap decorated callables.)"
msgstr ""
#: ../Doc/library/inspect.rst:595
msgid ""
"Some callables may not be introspectable in certain implementations of "
"Python. For example, in CPython, some built-in functions defined in C "
"provide no metadata about their arguments."
msgstr ""
#: ../Doc/library/inspect.rst:602
msgid ""
"A Signature object represents the call signature of a function and its "
"return annotation. For each parameter accepted by the function it stores a :"
"class:`Parameter` object in its :attr:`parameters` collection."
msgstr ""
#: ../Doc/library/inspect.rst:606
msgid ""
"The optional *parameters* argument is a sequence of :class:`Parameter` "
"objects, which is validated to check that there are no parameters with "
"duplicate names, and that the parameters are in the right order, i.e. "
"positional-only first, then positional-or-keyword, and that parameters with "
"defaults follow parameters without defaults."
msgstr ""
#: ../Doc/library/inspect.rst:612
msgid ""
"The optional *return_annotation* argument, can be an arbitrary Python "
"object, is the \"return\" annotation of the callable."
msgstr ""
#: ../Doc/library/inspect.rst:615
msgid ""
"Signature objects are *immutable*. Use :meth:`Signature.replace` to make a "
"modified copy."
msgstr ""
#: ../Doc/library/inspect.rst:618
msgid "Signature objects are picklable and hashable."
msgstr ""
#: ../Doc/library/inspect.rst:623
msgid "A special class-level marker to specify absence of a return annotation."
msgstr ""
#: ../Doc/library/inspect.rst:627
msgid ""
"An ordered mapping of parameters' names to the corresponding :class:"
"`Parameter` objects. Parameters appear in strict definition order, "
"including keyword-only parameters."
msgstr ""
#: ../Doc/library/inspect.rst:631 ../Doc/library/inspect.rst:968
msgid ""
"Python only explicitly guaranteed that it preserved the declaration order of "
"keyword-only parameters as of version 3.7, although in practice this order "
"had always been preserved in Python 3."
msgstr ""
#: ../Doc/library/inspect.rst:638
msgid ""
"The \"return\" annotation for the callable. If the callable has no \"return"
"\" annotation, this attribute is set to :attr:`Signature.empty`."
msgstr ""
#: ../Doc/library/inspect.rst:643
msgid ""
"Create a mapping from positional and keyword arguments to parameters. "
"Returns :class:`BoundArguments` if ``*args`` and ``**kwargs`` match the "
"signature, or raises a :exc:`TypeError`."
msgstr ""
#: ../Doc/library/inspect.rst:649
msgid ""
"Works the same way as :meth:`Signature.bind`, but allows the omission of "
"some required arguments (mimics :func:`functools.partial` behavior.) "
"Returns :class:`BoundArguments`, or raises a :exc:`TypeError` if the passed "
"arguments do not match the signature."
msgstr ""
#: ../Doc/library/inspect.rst:656
msgid ""
"Create a new Signature instance based on the instance replace was invoked "
"on. It is possible to pass different ``parameters`` and/or "
"``return_annotation`` to override the corresponding properties of the base "
"signature. To remove return_annotation from the copied Signature, pass in :"
"attr:`Signature.empty`."
msgstr ""
#: ../Doc/library/inspect.rst:673
msgid ""
"Return a :class:`Signature` (or its subclass) object for a given callable "
"``obj``. Pass ``follow_wrapped=False`` to get a signature of ``obj`` "
"without unwrapping its ``__wrapped__`` chain."
msgstr ""
#: ../Doc/library/inspect.rst:677
msgid "This method simplifies subclassing of :class:`Signature`::"
msgstr ""
#: ../Doc/library/inspect.rst:689
msgid ""
"Parameter objects are *immutable*. Instead of modifying a Parameter object, "
"you can use :meth:`Parameter.replace` to create a modified copy."
msgstr ""
#: ../Doc/library/inspect.rst:692
msgid "Parameter objects are picklable and hashable."
msgstr ""
#: ../Doc/library/inspect.rst:697
msgid ""
"A special class-level marker to specify absence of default values and "
"annotations."
msgstr ""
#: ../Doc/library/inspect.rst:702
msgid ""
"The name of the parameter as a string. The name must be a valid Python "
"identifier."
msgstr ""
#: ../Doc/library/inspect.rst:707
msgid ""
"CPython generates implicit parameter names of the form ``.0`` on the code "
"objects used to implement comprehensions and generator expressions."
msgstr ""
#: ../Doc/library/inspect.rst:711
msgid ""
"These parameter names are exposed by this module as names like ``implicit0``."
msgstr ""
#: ../Doc/library/inspect.rst:717
msgid ""
"The default value for the parameter. If the parameter has no default value, "
"this attribute is set to :attr:`Parameter.empty`."
msgstr ""
#: ../Doc/library/inspect.rst:722
msgid ""
"The annotation for the parameter. If the parameter has no annotation, this "
"attribute is set to :attr:`Parameter.empty`."
msgstr ""
#: ../Doc/library/inspect.rst:727
msgid ""
"Describes how argument values are bound to the parameter. Possible values "
"(accessible via :class:`Parameter`, like ``Parameter.KEYWORD_ONLY``):"
msgstr ""
#: ../Doc/library/inspect.rst:733
msgid "Name"
msgstr "Nom"
#: ../Doc/library/inspect.rst:733
msgid "Meaning"
msgstr "Signification"
#: ../Doc/library/inspect.rst:735
msgid "*POSITIONAL_ONLY*"
msgstr ""
#: ../Doc/library/inspect.rst:735
msgid ""
"Value must be supplied as a positional argument. Positional only parameters "
"are those which appear before a ``/`` entry (if present) in a Python "
"function definition."
msgstr ""
#: ../Doc/library/inspect.rst:740
msgid "*POSITIONAL_OR_KEYWORD*"
msgstr ""
#: ../Doc/library/inspect.rst:740
msgid ""
"Value may be supplied as either a keyword or positional argument (this is "
"the standard binding behaviour for functions implemented in Python.)"
msgstr ""
#: ../Doc/library/inspect.rst:745
msgid "*VAR_POSITIONAL*"
msgstr ""
#: ../Doc/library/inspect.rst:745
msgid ""
"A tuple of positional arguments that aren't bound to any other parameter. "
"This corresponds to a ``*args`` parameter in a Python function definition."
msgstr ""
#: ../Doc/library/inspect.rst:750
msgid "*KEYWORD_ONLY*"
msgstr ""
#: ../Doc/library/inspect.rst:750
msgid ""
"Value must be supplied as a keyword argument. Keyword only parameters are "
"those which appear after a ``*`` or ``*args`` entry in a Python function "
"definition."
msgstr ""
#: ../Doc/library/inspect.rst:755
msgid "*VAR_KEYWORD*"
msgstr ""
#: ../Doc/library/inspect.rst:755
msgid ""
"A dict of keyword arguments that aren't bound to any other parameter. This "
"corresponds to a ``**kwargs`` parameter in a Python function definition."
msgstr ""
#: ../Doc/library/inspect.rst:761
msgid "Example: print all keyword-only arguments without default values::"
msgstr ""
#: ../Doc/library/inspect.rst:775
msgid "Describes a enum value of Parameter.kind."
msgstr ""
#: ../Doc/library/inspect.rst:779
msgid "Example: print all descriptions of arguments::"
msgstr ""
#: ../Doc/library/inspect.rst:794
msgid ""
"Create a new Parameter instance based on the instance replaced was invoked "
"on. To override a :class:`Parameter` attribute, pass the corresponding "
"argument. To remove a default value or/and an annotation from a Parameter, "
"pass :attr:`Parameter.empty`."
msgstr ""
#: ../Doc/library/inspect.rst:812
msgid ""
"In Python 3.3 Parameter objects were allowed to have ``name`` set to "
"``None`` if their ``kind`` was set to ``POSITIONAL_ONLY``. This is no longer "
"permitted."
msgstr ""
#: ../Doc/library/inspect.rst:819
msgid ""
"Result of a :meth:`Signature.bind` or :meth:`Signature.bind_partial` call. "
"Holds the mapping of arguments to the function's parameters."
msgstr ""
#: ../Doc/library/inspect.rst:824
msgid ""
"An ordered, mutable mapping (:class:`collections.OrderedDict`) of "
"parameters' names to arguments' values. Contains only explicitly bound "
"arguments. Changes in :attr:`arguments` will reflect in :attr:`args` and :"
"attr:`kwargs`."
msgstr ""
#: ../Doc/library/inspect.rst:829
msgid ""
"Should be used in conjunction with :attr:`Signature.parameters` for any "
"argument processing purposes."
msgstr ""
#: ../Doc/library/inspect.rst:834
msgid ""
"Arguments for which :meth:`Signature.bind` or :meth:`Signature.bind_partial` "
"relied on a default value are skipped. However, if needed, use :meth:"
"`BoundArguments.apply_defaults` to add them."
msgstr ""
#: ../Doc/library/inspect.rst:841
msgid ""
"A tuple of positional arguments values. Dynamically computed from the :attr:"
"`arguments` attribute."
msgstr ""
#: ../Doc/library/inspect.rst:846
msgid ""
"A dict of keyword arguments values. Dynamically computed from the :attr:"
"`arguments` attribute."
msgstr ""
#: ../Doc/library/inspect.rst:851
msgid "A reference to the parent :class:`Signature` object."
msgstr ""
#: ../Doc/library/inspect.rst:855
msgid "Set default values for missing arguments."
msgstr ""
#: ../Doc/library/inspect.rst:857
msgid ""
"For variable-positional arguments (``*args``) the default is an empty tuple."
msgstr ""
#: ../Doc/library/inspect.rst:860
msgid ""
"For variable-keyword arguments (``**kwargs``) the default is an empty dict."
msgstr ""
#: ../Doc/library/inspect.rst:873
msgid ""
"The :attr:`args` and :attr:`kwargs` properties can be used to invoke "
"functions::"
msgstr ""
#: ../Doc/library/inspect.rst:886
msgid ":pep:`362` - Function Signature Object."
msgstr ""
#: ../Doc/library/inspect.rst:887
msgid "The detailed specification, implementation details and examples."
msgstr ""
#: ../Doc/library/inspect.rst:893
msgid "Classes and functions"
msgstr "Classes et fonctions"
#: ../Doc/library/inspect.rst:897
msgid ""
"Arrange the given list of classes into a hierarchy of nested lists. Where a "
"nested list appears, it contains classes derived from the class whose entry "
"immediately precedes the list. Each entry is a 2-tuple containing a class "
"and a tuple of its base classes. If the *unique* argument is true, exactly "
"one entry appears in the returned structure for each class in the given "
"list. Otherwise, classes using multiple inheritance and their descendants "
"will appear multiple times."
msgstr ""
#: ../Doc/library/inspect.rst:908
msgid ""
"Get the names and default values of a Python function's parameters. A :term:"
"`named tuple` ``ArgSpec(args, varargs, keywords, defaults)`` is returned. "
"*args* is a list of the parameter names. *varargs* and *keywords* are the "
"names of the ``*`` and ``**`` parameters or ``None``. *defaults* is a tuple "
"of default argument values or ``None`` if there are no default arguments; if "
"this tuple has *n* elements, they correspond to the last *n* elements listed "
"in *args*."
msgstr ""
#: ../Doc/library/inspect.rst:916
msgid ""
"Use :func:`getfullargspec` for an updated API that is usually a drop-in "
"replacement, but also correctly handles function annotations and keyword-"
"only parameters."
msgstr ""
#: ../Doc/library/inspect.rst:921
msgid ""
"Alternatively, use :func:`signature` and :ref:`Signature Object <inspect-"
"signature-object>`, which provide a more structured introspection API for "
"callables."
msgstr ""
#: ../Doc/library/inspect.rst:928
msgid ""
"Get the names and default values of a Python function's parameters. A :term:"
"`named tuple` is returned:"
msgstr ""
#: ../Doc/library/inspect.rst:931
msgid ""
"``FullArgSpec(args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, "
"annotations)``"
msgstr ""
#: ../Doc/library/inspect.rst:934
msgid ""
"*args* is a list of the positional parameter names. *varargs* is the name of "
"the ``*`` parameter or ``None`` if arbitrary positional arguments are not "
"accepted. *varkw* is the name of the ``**`` parameter or ``None`` if "
"arbitrary keyword arguments are not accepted. *defaults* is an *n*-tuple of "
"default argument values corresponding to the last *n* positional parameters, "
"or ``None`` if there are no such defaults defined. *kwonlyargs* is a list of "
"keyword-only parameter names in declaration order. *kwonlydefaults* is a "
"dictionary mapping parameter names from *kwonlyargs* to the default values "
"used if no argument is supplied. *annotations* is a dictionary mapping "
"parameter names to annotations. The special key ``\"return\"`` is used to "
"report the function return value annotation (if any)."
msgstr ""
#: ../Doc/library/inspect.rst:949
msgid ""
"Note that :func:`signature` and :ref:`Signature Object <inspect-signature-"
"object>` provide the recommended API for callable introspection, and support "
"additional behaviours (like positional-only arguments) that are sometimes "
"encountered in extension module APIs. This function is retained primarily "
"for use in code that needs to maintain compatibility with the Python 2 "
"``inspect`` module API."
msgstr ""
#: ../Doc/library/inspect.rst:956
msgid ""
"This function is now based on :func:`signature`, but still ignores "
"``__wrapped__`` attributes and includes the already bound first parameter in "
"the signature output for bound methods."
msgstr ""
#: ../Doc/library/inspect.rst:961
msgid ""
"This method was previously documented as deprecated in favour of :func:"
"`signature` in Python 3.5, but that decision has been reversed in order to "
"restore a clearly supported standard interface for single-source Python 2/3 "
"code migrating away from the legacy :func:`getargspec` API."
msgstr ""
#: ../Doc/library/inspect.rst:976
msgid ""
"Get information about arguments passed into a particular frame. A :term:"
"`named tuple` ``ArgInfo(args, varargs, keywords, locals)`` is returned. "
"*args* is a list of the argument names. *varargs* and *keywords* are the "
"names of the ``*`` and ``**`` arguments or ``None``. *locals* is the locals "
"dictionary of the given frame."
msgstr ""
#: ../Doc/library/inspect.rst:983 ../Doc/library/inspect.rst:1020
msgid "This function was inadvertently marked as deprecated in Python 3.5."
msgstr ""
#: ../Doc/library/inspect.rst:988
msgid ""
"Format a pretty argument spec from the values returned by :func:"
"`getfullargspec`."
msgstr ""
#: ../Doc/library/inspect.rst:991
msgid ""
"The first seven arguments are (``args``, ``varargs``, ``varkw``, "
"``defaults``, ``kwonlyargs``, ``kwonlydefaults``, ``annotations``)."
msgstr ""
#: ../Doc/library/inspect.rst:994
msgid ""
"The other six arguments are functions that are called to turn argument "
"names, ``*`` argument name, ``**`` argument name, default values, return "
"annotation and individual annotations into strings, respectively."
msgstr ""
#: ../Doc/library/inspect.rst:998
msgid "For example:"
msgstr "Par exemple :"
#: ../Doc/library/inspect.rst:1007
msgid ""
"Use :func:`signature` and :ref:`Signature Object <inspect-signature-"
"object>`, which provide a better introspecting API for callables."
msgstr ""
#: ../Doc/library/inspect.rst:1015
msgid ""
"Format a pretty argument spec from the four values returned by :func:"
"`getargvalues`. The format\\* arguments are the corresponding optional "
"formatting functions that are called to turn names and values into strings."
msgstr ""
#: ../Doc/library/inspect.rst:1025
msgid ""
"Return a tuple of class cls's base classes, including cls, in method "
"resolution order. No class appears more than once in this tuple. Note that "
"the method resolution order depends on cls's type. Unless a very peculiar "
"user-defined metatype is in use, cls will be the first element of the tuple."
msgstr ""
#: ../Doc/library/inspect.rst:1033
msgid ""
"Bind the *args* and *kwds* to the argument names of the Python function or "
"method *func*, as if it was called with them. For bound methods, bind also "
"the first argument (typically named ``self``) to the associated instance. A "
"dict is returned, mapping the argument names (including the names of the "
"``*`` and ``**`` arguments, if any) to their values from *args* and *kwds*. "
"In case of invoking *func* incorrectly, i.e. whenever ``func(*args, "
"**kwds)`` would raise an exception because of incompatible signature, an "
"exception of the same type and the same or similar message is raised. For "
"example::"
msgstr ""
#: ../Doc/library/inspect.rst:1056
msgid "Use :meth:`Signature.bind` and :meth:`Signature.bind_partial` instead."
msgstr ""
#: ../Doc/library/inspect.rst:1062
msgid ""
"Get the mapping of external name references in a Python function or method "
"*func* to their current values. A :term:`named tuple` "
"``ClosureVars(nonlocals, globals, builtins, unbound)`` is returned. "
"*nonlocals* maps referenced names to lexical closure variables, *globals* to "
"the function's module globals and *builtins* to the builtins visible from "
"the function body. *unbound* is the set of names referenced in the function "
"that could not be resolved at all given the current module globals and "
"builtins."
msgstr ""
#: ../Doc/library/inspect.rst:1071
msgid ""
":exc:`TypeError` is raised if *func* is not a Python function or method."
msgstr ""
#: ../Doc/library/inspect.rst:1078
msgid ""
"Get the object wrapped by *func*. It follows the chain of :attr:"
"`__wrapped__` attributes returning the last object in the chain."
msgstr ""
#: ../Doc/library/inspect.rst:1081
msgid ""
"*stop* is an optional callback accepting an object in the wrapper chain as "
"its sole argument that allows the unwrapping to be terminated early if the "
"callback returns a true value. If the callback never returns a true value, "
"the last object in the chain is returned as usual. For example, :func:"
"`signature` uses this to stop unwrapping if any object in the chain has a "
"``__signature__`` attribute defined."
msgstr ""
#: ../Doc/library/inspect.rst:1088
msgid ":exc:`ValueError` is raised if a cycle is encountered."
msgstr ""
#: ../Doc/library/inspect.rst:1096
msgid "The interpreter stack"
msgstr ""
#: ../Doc/library/inspect.rst:1098
msgid ""
"When the following functions return \"frame records,\" each record is a :"
"term:`named tuple` ``FrameInfo(frame, filename, lineno, function, "
"code_context, index)``. The tuple contains the frame object, the filename, "
"the line number of the current line, the function name, a list of lines of "
"context from the source code, and the index of the current line within that "
"list."
msgstr ""
#: ../Doc/library/inspect.rst:1106
msgid "Return a named tuple instead of a tuple."
msgstr ""
#: ../Doc/library/inspect.rst:1111
msgid ""
"Keeping references to frame objects, as found in the first element of the "
"frame records these functions return, can cause your program to create "
"reference cycles. Once a reference cycle has been created, the lifespan of "
"all objects which can be accessed from the objects which form the cycle can "
"become much longer even if Python's optional cycle detector is enabled. If "
"such cycles must be created, it is important to ensure they are explicitly "
"broken to avoid the delayed destruction of objects and increased memory "
"consumption which occurs."
msgstr ""
#: ../Doc/library/inspect.rst:1119
msgid ""
"Though the cycle detector will catch these, destruction of the frames (and "
"local variables) can be made deterministic by removing the cycle in a :"
"keyword:`finally` clause. This is also important if the cycle detector was "
"disabled when Python was compiled or using :func:`gc.disable`. For example::"
msgstr ""
#: ../Doc/library/inspect.rst:1131
msgid ""
"If you want to keep the frame around (for example to print a traceback "
"later), you can also break reference cycles by using the :meth:`frame.clear` "
"method."
msgstr ""
#: ../Doc/library/inspect.rst:1135
msgid ""
"The optional *context* argument supported by most of these functions "
"specifies the number of lines of context to return, which are centered "
"around the current line."
msgstr ""
#: ../Doc/library/inspect.rst:1142
msgid ""
"Get information about a frame or traceback object. A :term:`named tuple` "
"``Traceback(filename, lineno, function, code_context, index)`` is returned."
msgstr ""
#: ../Doc/library/inspect.rst:1148
msgid ""
"Get a list of frame records for a frame and all outer frames. These frames "
"represent the calls that lead to the creation of *frame*. The first entry in "
"the returned list represents *frame*; the last entry represents the "
"outermost call on *frame*'s stack."
msgstr ""
#: ../Doc/library/inspect.rst:1153 ../Doc/library/inspect.rst:1166
#: ../Doc/library/inspect.rst:1190 ../Doc/library/inspect.rst:1203
msgid ""
"A list of :term:`named tuples <named tuple>` ``FrameInfo(frame, filename, "
"lineno, function, code_context, index)`` is returned."
msgstr ""
#: ../Doc/library/inspect.rst:1161
msgid ""
"Get a list of frame records for a traceback's frame and all inner frames. "
"These frames represent calls made as a consequence of *frame*. The first "
"entry in the list represents *traceback*; the last entry represents where "
"the exception was raised."
msgstr ""
#: ../Doc/library/inspect.rst:1174
msgid "Return the frame object for the caller's stack frame."
msgstr ""
#: ../Doc/library/inspect.rst:1178
msgid ""
"This function relies on Python stack frame support in the interpreter, which "
"isn't guaranteed to exist in all implementations of Python. If running in "
"an implementation without Python stack frame support this function returns "
"``None``."
msgstr ""
#: ../Doc/library/inspect.rst:1186
msgid ""
"Return a list of frame records for the caller's stack. The first entry in "
"the returned list represents the caller; the last entry represents the "
"outermost call on the stack."
msgstr ""
#: ../Doc/library/inspect.rst:1198
msgid ""
"Return a list of frame records for the stack between the current frame and "
"the frame in which an exception currently being handled was raised in. The "
"first entry in the list represents the caller; the last entry represents "
"where the exception was raised."
msgstr ""
#: ../Doc/library/inspect.rst:1210
msgid "Fetching attributes statically"
msgstr ""
#: ../Doc/library/inspect.rst:1212
msgid ""
"Both :func:`getattr` and :func:`hasattr` can trigger code execution when "
"fetching or checking for the existence of attributes. Descriptors, like "
"properties, will be invoked and :meth:`__getattr__` and :meth:"
"`__getattribute__` may be called."
msgstr ""
#: ../Doc/library/inspect.rst:1217
msgid ""
"For cases where you want passive introspection, like documentation tools, "
"this can be inconvenient. :func:`getattr_static` has the same signature as :"
"func:`getattr` but avoids executing code when it fetches attributes."
msgstr ""
#: ../Doc/library/inspect.rst:1223
msgid ""
"Retrieve attributes without triggering dynamic lookup via the descriptor "
"protocol, :meth:`__getattr__` or :meth:`__getattribute__`."
msgstr ""
#: ../Doc/library/inspect.rst:1226
msgid ""
"Note: this function may not be able to retrieve all attributes that getattr "
"can fetch (like dynamically created attributes) and may find attributes that "
"getattr can't (like descriptors that raise AttributeError). It can also "
"return descriptors objects instead of instance members."
msgstr ""
#: ../Doc/library/inspect.rst:1232
msgid ""
"If the instance :attr:`~object.__dict__` is shadowed by another member (for "
"example a property) then this function will be unable to find instance "
"members."
msgstr ""
#: ../Doc/library/inspect.rst:1238
msgid ""
":func:`getattr_static` does not resolve descriptors, for example slot "
"descriptors or getset descriptors on objects implemented in C. The "
"descriptor object is returned instead of the underlying attribute."
msgstr ""
#: ../Doc/library/inspect.rst:1242
msgid ""
"You can handle these with code like the following. Note that for arbitrary "
"getset descriptors invoking these may trigger code execution::"
msgstr ""
#: ../Doc/library/inspect.rst:1268
msgid "Current State of Generators and Coroutines"
msgstr ""
#: ../Doc/library/inspect.rst:1270
msgid ""
"When implementing coroutine schedulers and for other advanced uses of "
"generators, it is useful to determine whether a generator is currently "
"executing, is waiting to start or resume or execution, or has already "
"terminated. :func:`getgeneratorstate` allows the current state of a "
"generator to be determined easily."
msgstr ""
#: ../Doc/library/inspect.rst:1278
msgid "Get current state of a generator-iterator."
msgstr ""
#: ../Doc/library/inspect.rst:1284 ../Doc/library/inspect.rst:1299
msgid "Possible states are:"
msgstr ""
#: ../Doc/library/inspect.rst:1281
msgid "GEN_CREATED: Waiting to start execution."
msgstr ""
#: ../Doc/library/inspect.rst:1282
msgid "GEN_RUNNING: Currently being executed by the interpreter."
msgstr ""
#: ../Doc/library/inspect.rst:1283
msgid "GEN_SUSPENDED: Currently suspended at a yield expression."
msgstr ""
#: ../Doc/library/inspect.rst:1284
msgid "GEN_CLOSED: Execution has completed."
msgstr ""
#: ../Doc/library/inspect.rst:1290
msgid ""
"Get current state of a coroutine object. The function is intended to be "
"used with coroutine objects created by :keyword:`async def` functions, but "
"will accept any coroutine-like object that has ``cr_running`` and "
"``cr_frame`` attributes."
msgstr ""
#: ../Doc/library/inspect.rst:1296
msgid "CORO_CREATED: Waiting to start execution."
msgstr ""
#: ../Doc/library/inspect.rst:1297
msgid "CORO_RUNNING: Currently being executed by the interpreter."
msgstr ""
#: ../Doc/library/inspect.rst:1298
msgid "CORO_SUSPENDED: Currently suspended at an await expression."
msgstr ""
#: ../Doc/library/inspect.rst:1299
msgid "CORO_CLOSED: Execution has completed."
msgstr ""
#: ../Doc/library/inspect.rst:1303
msgid ""
"The current internal state of the generator can also be queried. This is "
"mostly useful for testing purposes, to ensure that internal state is being "
"updated as expected:"
msgstr ""
#: ../Doc/library/inspect.rst:1309
msgid ""
"Get the mapping of live local variables in *generator* to their current "
"values. A dictionary is returned that maps from variable names to values. "
"This is the equivalent of calling :func:`locals` in the body of the "
"generator, and all the same caveats apply."
msgstr ""
#: ../Doc/library/inspect.rst:1314
msgid ""
"If *generator* is a :term:`generator` with no currently associated frame, "
"then an empty dictionary is returned. :exc:`TypeError` is raised if "
"*generator* is not a Python generator object."
msgstr ""
#: ../Doc/library/inspect.rst:1320
msgid ""
"This function relies on the generator exposing a Python stack frame for "
"introspection, which isn't guaranteed to be the case in all implementations "
"of Python. In such cases, this function will always return an empty "
"dictionary."
msgstr ""
#: ../Doc/library/inspect.rst:1329
msgid ""
"This function is analogous to :func:`~inspect.getgeneratorlocals`, but works "
"for coroutine objects created by :keyword:`async def` functions."
msgstr ""
#: ../Doc/library/inspect.rst:1338
msgid "Code Objects Bit Flags"
msgstr ""
#: ../Doc/library/inspect.rst:1340
msgid ""
"Python code objects have a ``co_flags`` attribute, which is a bitmap of the "
"following flags:"
msgstr ""
#: ../Doc/library/inspect.rst:1345
msgid "The code object is optimized, using fast locals."
msgstr ""
#: ../Doc/library/inspect.rst:1349
msgid ""
"If set, a new dict will be created for the frame's ``f_locals`` when the "
"code object is executed."
msgstr ""
#: ../Doc/library/inspect.rst:1354
msgid "The code object has a variable positional parameter (``*args``-like)."
msgstr ""
#: ../Doc/library/inspect.rst:1358
msgid "The code object has a variable keyword parameter (``**kwargs``-like)."
msgstr ""
#: ../Doc/library/inspect.rst:1362
msgid "The flag is set when the code object is a nested function."
msgstr ""
#: ../Doc/library/inspect.rst:1366
msgid ""
"The flag is set when the code object is a generator function, i.e. a "
"generator object is returned when the code object is executed."
msgstr ""
#: ../Doc/library/inspect.rst:1371
msgid "The flag is set if there are no free or cell variables."
msgstr ""
#: ../Doc/library/inspect.rst:1375
msgid ""
"The flag is set when the code object is a coroutine function. When the code "
"object is executed it returns a coroutine object. See :pep:`492` for more "
"details."
msgstr ""
#: ../Doc/library/inspect.rst:1383
msgid ""
"The flag is used to transform generators into generator-based coroutines. "
"Generator objects with this flag can be used in ``await`` expression, and "
"can ``yield from`` coroutine objects. See :pep:`492` for more details."
msgstr ""
#: ../Doc/library/inspect.rst:1392
msgid ""
"The flag is set when the code object is an asynchronous generator function. "
"When the code object is executed it returns an asynchronous generator "
"object. See :pep:`525` for more details."
msgstr ""
#: ../Doc/library/inspect.rst:1399
msgid ""
"The flags are specific to CPython, and may not be defined in other Python "
"implementations. Furthermore, the flags are an implementation detail, and "
"can be removed or deprecated in future Python releases. It's recommended to "
"use public APIs from the :mod:`inspect` module for any introspection needs."
msgstr ""
#: ../Doc/library/inspect.rst:1409
msgid "Command Line Interface"
msgstr "Interface en ligne de commande"
#: ../Doc/library/inspect.rst:1411
msgid ""
"The :mod:`inspect` module also provides a basic introspection capability "
"from the command line."
msgstr ""
#: ../Doc/library/inspect.rst:1416
msgid ""
"By default, accepts the name of a module and prints the source of that "
"module. A class or function within the module can be printed instead by "
"appended a colon and the qualified name of the target object."
msgstr ""
#: ../Doc/library/inspect.rst:1422
msgid ""
"Print information about the specified object rather than the source code"
msgstr ""
#~ msgid "f_restricted"
#~ msgstr "f_restricted"