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

1850 lines
53 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: 2021-09-23 16:16+0200\n"
"PO-Revision-Date: 2021-09-23 16:27+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"
#: library/inspect.rst:2
msgid ":mod:`inspect` --- Inspect live objects"
msgstr ""
#: library/inspect.rst:10
msgid "**Source code:** :source:`Lib/inspect.py`"
msgstr "**Code source :** :source:`Lib/inspect.py`"
#: 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 ""
#: 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 ""
#: library/inspect.rst:29
msgid "Types and members"
msgstr ""
#: 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 ""
#: library/inspect.rst:41
msgid "Type"
msgstr "Type"
#: library/inspect.rst:41
msgid "Attribute"
msgstr "Attribut"
#: library/inspect.rst:41
msgid "Description"
msgstr "Description"
#: library/inspect.rst:43
msgid "module"
msgstr "module"
#: library/inspect.rst:48 library/inspect.rst:76 library/inspect.rst:233
msgid "__doc__"
msgstr "__doc__"
#: library/inspect.rst:48 library/inspect.rst:76 library/inspect.rst:233
msgid "documentation string"
msgstr ""
#: library/inspect.rst:45
msgid "__file__"
msgstr "__file__"
#: library/inspect.rst:45
msgid "filename (missing for built-in modules)"
msgstr ""
#: library/inspect.rst:48
msgid "class"
msgstr "classe"
#: library/inspect.rst:60 library/inspect.rst:202 library/inspect.rst:235
msgid "__name__"
msgstr "__name__"
#: library/inspect.rst:50
msgid "name with which this class was defined"
msgstr ""
#: library/inspect.rst:63 library/inspect.rst:204 library/inspect.rst:238
msgid "__qualname__"
msgstr "__qualname__"
#: library/inspect.rst:63 library/inspect.rst:204 library/inspect.rst:238
msgid "qualified name"
msgstr "nom qualifié"
#: library/inspect.rst:73 library/inspect.rst:106
msgid "__module__"
msgstr "__module__"
#: library/inspect.rst:55
msgid "name of module in which this class was defined"
msgstr ""
#: library/inspect.rst:58
msgid "method"
msgstr "méthode"
#: library/inspect.rst:60
msgid "name with which this method was defined"
msgstr ""
#: library/inspect.rst:65
msgid "__func__"
msgstr "__func__"
#: library/inspect.rst:65
msgid "function object containing implementation of method"
msgstr ""
#: library/inspect.rst:240
msgid "__self__"
msgstr "__self__"
#: library/inspect.rst:69
msgid "instance to which this method is bound, or ``None``"
msgstr ""
#: library/inspect.rst:73
msgid "name of module in which this method was defined"
msgstr ""
#: library/inspect.rst:76
msgid "function"
msgstr "fonction"
#: library/inspect.rst:78
msgid "name with which this function was defined"
msgstr ""
#: library/inspect.rst:83
msgid "__code__"
msgstr "__code__"
#: library/inspect.rst:83
msgid "code object containing compiled function :term:`bytecode`"
msgstr ""
#: library/inspect.rst:87
msgid "__defaults__"
msgstr "__defaults__"
#: library/inspect.rst:87
msgid "tuple of any default values for positional or keyword parameters"
msgstr ""
#: library/inspect.rst:91
msgid "__kwdefaults__"
msgstr "__kwdefaults__"
#: library/inspect.rst:91
msgid "mapping of any default values for keyword-only parameters"
msgstr ""
#: library/inspect.rst:95
msgid "__globals__"
msgstr "__globals__"
#: library/inspect.rst:95
msgid "global namespace in which this function was defined"
msgstr ""
#: library/inspect.rst:98
msgid "__builtins__"
msgstr "__builtins__"
#: library/inspect.rst:98
msgid "builtins namespace"
msgstr ""
#: library/inspect.rst:100
msgid "__annotations__"
msgstr "__annotations__"
#: library/inspect.rst:100
msgid ""
"mapping of parameters names to annotations; ``\"return\"`` key is reserved "
"for return annotations."
msgstr ""
#: library/inspect.rst:106
msgid "name of module in which this function was defined"
msgstr ""
#: library/inspect.rst:109
msgid "traceback"
msgstr "traceback"
#: library/inspect.rst:109
msgid "tb_frame"
msgstr "tb_frame"
#: library/inspect.rst:109
msgid "frame object at this level"
msgstr ""
#: library/inspect.rst:112
msgid "tb_lasti"
msgstr "tb_lasti"
#: library/inspect.rst:134
msgid "index of last attempted instruction in bytecode"
msgstr ""
#: library/inspect.rst:115
msgid "tb_lineno"
msgstr "tb_lineno"
#: library/inspect.rst:137
msgid "current line number in Python source code"
msgstr ""
#: library/inspect.rst:118
msgid "tb_next"
msgstr "tb_next"
#: library/inspect.rst:118
msgid "next inner traceback object (called by this level)"
msgstr ""
#: library/inspect.rst:206 library/inspect.rst:223
msgid "frame"
msgstr ""
#: library/inspect.rst:122
msgid "f_back"
msgstr "f_back"
#: library/inspect.rst:122
msgid "next outer frame object (this frame's caller)"
msgstr ""
#: library/inspect.rst:125
msgid "f_builtins"
msgstr "f_builtins"
#: library/inspect.rst:125
msgid "builtins namespace seen by this frame"
msgstr ""
#: library/inspect.rst:128
msgid "f_code"
msgstr "f_code"
#: library/inspect.rst:128
msgid "code object being executed in this frame"
msgstr ""
#: library/inspect.rst:131
msgid "f_globals"
msgstr "f_globals"
#: library/inspect.rst:131
msgid "global namespace seen by this frame"
msgstr ""
#: library/inspect.rst:134
msgid "f_lasti"
msgstr "f_lasti"
#: library/inspect.rst:137
msgid "f_lineno"
msgstr "f_lineno"
#: library/inspect.rst:140
msgid "f_locals"
msgstr "f_locals"
#: library/inspect.rst:140
msgid "local namespace seen by this frame"
msgstr ""
#: library/inspect.rst:143
msgid "f_trace"
msgstr "f_trace"
#: library/inspect.rst:143
msgid "tracing function for this frame, or ``None``"
msgstr ""
#: library/inspect.rst:210 library/inspect.rst:227
msgid "code"
msgstr ""
#: library/inspect.rst:146
msgid "co_argcount"
msgstr "co_argcount"
#: library/inspect.rst:146
msgid ""
"number of arguments (not including keyword only arguments, \\* or \\*\\* "
"args)"
msgstr ""
#: library/inspect.rst:151
msgid "co_code"
msgstr "co_code"
#: library/inspect.rst:151
msgid "string of raw compiled bytecode"
msgstr ""
#: library/inspect.rst:154
msgid "co_cellvars"
msgstr ""
#: library/inspect.rst:154
msgid "tuple of names of cell variables (referenced by containing scopes)"
msgstr ""
#: library/inspect.rst:158
msgid "co_consts"
msgstr "co_consts"
#: library/inspect.rst:158
msgid "tuple of constants used in the bytecode"
msgstr ""
#: library/inspect.rst:161
msgid "co_filename"
msgstr "co_filename"
#: library/inspect.rst:161
msgid "name of file in which this code object was created"
msgstr ""
#: library/inspect.rst:165
msgid "co_firstlineno"
msgstr "co_firstlineno"
#: library/inspect.rst:165
msgid "number of first line in Python source code"
msgstr ""
#: library/inspect.rst:168
msgid "co_flags"
msgstr "co_flags"
#: library/inspect.rst:168
msgid ""
"bitmap of ``CO_*`` flags, read more :ref:`here <inspect-module-co-flags>`"
msgstr ""
#: library/inspect.rst:172
msgid "co_lnotab"
msgstr "co_lnotab"
#: library/inspect.rst:172
msgid "encoded mapping of line numbers to bytecode indices"
msgstr ""
#: library/inspect.rst:176
msgid "co_freevars"
msgstr "co_freevars"
#: library/inspect.rst:176
msgid "tuple of names of free variables (referenced via a function's closure)"
msgstr ""
#: library/inspect.rst:180
msgid "co_posonlyargcount"
msgstr "co_posonlyargcount"
#: library/inspect.rst:180
msgid "number of positional only arguments"
msgstr ""
#: library/inspect.rst:183
msgid "co_kwonlyargcount"
msgstr "co_kwonlyargcount"
#: library/inspect.rst:183
msgid "number of keyword only arguments (not including \\*\\* arg)"
msgstr ""
#: library/inspect.rst:187
msgid "co_name"
msgstr "co_name"
#: library/inspect.rst:187
msgid "name with which this code object was defined"
msgstr ""
#: library/inspect.rst:190
msgid "co_names"
msgstr "co_names"
#: library/inspect.rst:190
msgid "tuple of names of local variables"
msgstr ""
#: library/inspect.rst:193
msgid "co_nlocals"
msgstr "co_nlocals"
#: library/inspect.rst:193
msgid "number of local variables"
msgstr ""
#: library/inspect.rst:195
msgid "co_stacksize"
msgstr "co_stacksize"
#: library/inspect.rst:195
msgid "virtual machine stack space required"
msgstr ""
#: library/inspect.rst:198
msgid "co_varnames"
msgstr "co_varnames"
#: library/inspect.rst:198
msgid "tuple of names of arguments and local variables"
msgstr ""
#: library/inspect.rst:202
msgid "generator"
msgstr "générateur"
#: library/inspect.rst:216
msgid "name"
msgstr ""
#: library/inspect.rst:206
msgid "gi_frame"
msgstr "gi_frame"
#: library/inspect.rst:208
msgid "gi_running"
msgstr "gi_running"
#: library/inspect.rst:208
msgid "is the generator running?"
msgstr ""
#: library/inspect.rst:210
msgid "gi_code"
msgstr "gi_code"
#: library/inspect.rst:212
msgid "gi_yieldfrom"
msgstr "gi_yieldfrom"
#: library/inspect.rst:212
msgid "object being iterated by ``yield from``, or ``None``"
msgstr ""
#: library/inspect.rst:216
msgid "coroutine"
msgstr "coroutine"
#: library/inspect.rst:220
msgid "cr_await"
msgstr "cr_await"
#: library/inspect.rst:220
msgid "object being awaited on, or ``None``"
msgstr ""
#: library/inspect.rst:223
msgid "cr_frame"
msgstr "cr_frame"
#: library/inspect.rst:225
msgid "cr_running"
msgstr "cr_running"
#: library/inspect.rst:225
msgid "is the coroutine running?"
msgstr ""
#: library/inspect.rst:227
msgid "cr_code"
msgstr "cr_code"
#: library/inspect.rst:229
msgid "cr_origin"
msgstr ""
#: library/inspect.rst:229
msgid "where coroutine was created, or ``None``. See |coroutine-origin-link|"
msgstr ""
#: library/inspect.rst:233
msgid "builtin"
msgstr ""
#: library/inspect.rst:235
msgid "original name of this function or method"
msgstr ""
#: library/inspect.rst:240
msgid "instance to which a method is bound, or ``None``"
msgstr ""
#: library/inspect.rst:247
msgid "Add ``__qualname__`` and ``gi_yieldfrom`` attributes to generators."
msgstr ""
#: library/inspect.rst:249
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 ""
#: library/inspect.rst:254
msgid "Add ``cr_origin`` attribute to coroutines."
msgstr ""
#: library/inspect.rst:258
msgid "Add ``__builtins__`` attribute to functions."
msgstr ""
#: library/inspect.rst:262
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 ""
#: library/inspect.rst:269
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 ""
#: library/inspect.rst:276
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 ""
#: library/inspect.rst:282
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 ""
#: library/inspect.rst:286
msgid "The function is based directly on :mod:`importlib`."
msgstr ""
#: library/inspect.rst:292
msgid "Return ``True`` if the object is a module."
msgstr ""
#: library/inspect.rst:297
msgid ""
"Return ``True`` if the object is a class, whether built-in or created in "
"Python code."
msgstr ""
#: library/inspect.rst:303
msgid "Return ``True`` if the object is a bound method written in Python."
msgstr ""
#: library/inspect.rst:308
msgid ""
"Return ``True`` if the object is a Python function, which includes functions "
"created by a :term:`lambda` expression."
msgstr ""
#: library/inspect.rst:314
msgid "Return ``True`` if the object is a Python generator function."
msgstr ""
#: library/inspect.rst:316
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
"wrapped function is a Python generator function."
msgstr ""
#: library/inspect.rst:323
msgid "Return ``True`` if the object is a generator."
msgstr ""
#: library/inspect.rst:328
msgid ""
"Return ``True`` if the object is a :term:`coroutine function` (a function "
"defined with an :keyword:`async def` syntax)."
msgstr ""
#: library/inspect.rst:333
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
"wrapped function is a :term:`coroutine function`."
msgstr ""
#: library/inspect.rst:340
msgid ""
"Return ``True`` if the object is a :term:`coroutine` created by an :keyword:"
"`async def` function."
msgstr ""
#: library/inspect.rst:348
msgid ""
"Return ``True`` if the object can be used in :keyword:`await` expression."
msgstr ""
#: library/inspect.rst:350
msgid ""
"Can also be used to distinguish generator-based coroutines from regular "
"generators::"
msgstr ""
#: library/inspect.rst:367
msgid ""
"Return ``True`` if the object is an :term:`asynchronous generator` function, "
"for example::"
msgstr ""
#: library/inspect.rst:378
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
"wrapped function is a :term:`asynchronous generator` function."
msgstr ""
#: library/inspect.rst:385
msgid ""
"Return ``True`` if the object is an :term:`asynchronous generator iterator` "
"created by an :term:`asynchronous generator` function."
msgstr ""
#: library/inspect.rst:392
msgid "Return ``True`` if the object is a traceback."
msgstr ""
#: library/inspect.rst:397
msgid "Return ``True`` if the object is a frame."
msgstr ""
#: library/inspect.rst:402
msgid "Return ``True`` if the object is a code."
msgstr ""
#: library/inspect.rst:407
msgid ""
"Return ``True`` if the object is a built-in function or a bound built-in "
"method."
msgstr ""
#: library/inspect.rst:412
msgid ""
"Return ``True`` if the object is a user-defined or built-in function or "
"method."
msgstr ""
#: library/inspect.rst:417
msgid "Return ``True`` if the object is an abstract base class."
msgstr ""
#: library/inspect.rst:422
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 ""
#: library/inspect.rst:426
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 ""
#: library/inspect.rst:432
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 ""
#: library/inspect.rst:440
msgid "Return ``True`` if the object is a data descriptor."
msgstr ""
#: library/inspect.rst:442
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 ""
#: library/inspect.rst:453
msgid "Return ``True`` if the object is a getset descriptor."
msgstr ""
#: library/inspect.rst:457
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 ""
#: library/inspect.rst:464
msgid "Return ``True`` if the object is a member descriptor."
msgstr ""
#: library/inspect.rst:468
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 ""
#: library/inspect.rst:476
msgid "Retrieving source code"
msgstr ""
#: library/inspect.rst:480
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 ""
#: library/inspect.rst:485
msgid "Documentation strings are now inherited if not overridden."
msgstr ""
#: library/inspect.rst:491
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 ""
#: library/inspect.rst:500
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 ""
#: library/inspect.rst:507
msgid "Try to guess which module an object was defined in."
msgstr ""
#: library/inspect.rst:512
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 ""
#: library/inspect.rst:519
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 ""
#: library/inspect.rst:538
msgid ""
":exc:`OSError` is raised instead of :exc:`IOError`, now an alias of the "
"former."
msgstr ""
#: library/inspect.rst:533
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 ""
#: library/inspect.rst:545
msgid ""
"Clean up indentation from docstrings that are indented to line up with "
"blocks of code."
msgstr ""
#: library/inspect.rst:548
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 ""
#: library/inspect.rst:557
msgid "Introspecting callables with the Signature object"
msgstr ""
#: library/inspect.rst:561
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 ""
#: library/inspect.rst:567
msgid "Return a :class:`Signature` object for the given ``callable``::"
msgstr ""
#: library/inspect.rst:584
msgid ""
"Accepts a wide range of Python callables, from plain functions and classes "
"to :func:`functools.partial` objects."
msgstr ""
#: library/inspect.rst:587
msgid ""
"For objects defined in modules using stringized annotations (``from "
"__future__ import annotations``), :func:`signature` will attempt to "
"automatically un-stringize the annotations using :func:`inspect."
"get_annotations()`. The ``global``, ``locals``, and ``eval_str`` parameters "
"are passed into :func:`inspect.get_annotations()` when resolving the "
"annotations; see the documentation for :func:`inspect.get_annotations()` for "
"instructions on how to use these parameters."
msgstr ""
#: library/inspect.rst:596
msgid ""
"Raises :exc:`ValueError` if no signature can be provided, and :exc:"
"`TypeError` if that type of object is not supported. Also, if the "
"annotations are stringized, and ``eval_str`` is not false, the ``eval()`` "
"call(s) to un-stringize the annotations could potentially raise any kind of "
"exception."
msgstr ""
#: library/inspect.rst:602
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 ""
#: library/inspect.rst:606
msgid ""
"``follow_wrapped`` parameter. Pass ``False`` to get a signature of "
"``callable`` specifically (``callable.__wrapped__`` will not be used to "
"unwrap decorated callables.)"
msgstr ""
#: library/inspect.rst:611
msgid "``globals``, ``locals``, and ``eval_str`` parameters."
msgstr ""
#: library/inspect.rst:616
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 ""
#: library/inspect.rst:623
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 ""
#: library/inspect.rst:627
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 ""
#: library/inspect.rst:633
msgid ""
"The optional *return_annotation* argument, can be an arbitrary Python "
"object, is the \"return\" annotation of the callable."
msgstr ""
#: library/inspect.rst:636
msgid ""
"Signature objects are *immutable*. Use :meth:`Signature.replace` to make a "
"modified copy."
msgstr ""
#: library/inspect.rst:639
msgid "Signature objects are picklable and hashable."
msgstr ""
#: library/inspect.rst:644
msgid "A special class-level marker to specify absence of a return annotation."
msgstr ""
#: library/inspect.rst:648
msgid ""
"An ordered mapping of parameters' names to the corresponding :class:"
"`Parameter` objects. Parameters appear in strict definition order, "
"including keyword-only parameters."
msgstr ""
#: library/inspect.rst:996
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 ""
#: library/inspect.rst:659
msgid ""
"The \"return\" annotation for the callable. If the callable has no \"return"
"\" annotation, this attribute is set to :attr:`Signature.empty`."
msgstr ""
#: library/inspect.rst:664
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 ""
#: library/inspect.rst:670
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 ""
#: library/inspect.rst:677
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 ""
#: library/inspect.rst:694
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. ``globalns`` and ``localns`` "
"will be used as the namespaces when resolving annotations."
msgstr ""
#: library/inspect.rst:699
msgid "This method simplifies subclassing of :class:`Signature`::"
msgstr ""
#: library/inspect.rst:708
msgid "``globalns`` and ``localns`` parameters."
msgstr ""
#: library/inspect.rst:714
msgid ""
"Parameter objects are *immutable*. Instead of modifying a Parameter object, "
"you can use :meth:`Parameter.replace` to create a modified copy."
msgstr ""
#: library/inspect.rst:717
msgid "Parameter objects are picklable and hashable."
msgstr ""
#: library/inspect.rst:722
msgid ""
"A special class-level marker to specify absence of default values and "
"annotations."
msgstr ""
#: library/inspect.rst:727
msgid ""
"The name of the parameter as a string. The name must be a valid Python "
"identifier."
msgstr ""
#: library/inspect.rst:732
msgid ""
"CPython generates implicit parameter names of the form ``.0`` on the code "
"objects used to implement comprehensions and generator expressions."
msgstr ""
#: library/inspect.rst:736
msgid ""
"These parameter names are exposed by this module as names like ``implicit0``."
msgstr ""
#: library/inspect.rst:742
msgid ""
"The default value for the parameter. If the parameter has no default value, "
"this attribute is set to :attr:`Parameter.empty`."
msgstr ""
#: library/inspect.rst:747
msgid ""
"The annotation for the parameter. If the parameter has no annotation, this "
"attribute is set to :attr:`Parameter.empty`."
msgstr ""
#: library/inspect.rst:752
msgid ""
"Describes how argument values are bound to the parameter. Possible values "
"(accessible via :class:`Parameter`, like ``Parameter.KEYWORD_ONLY``):"
msgstr ""
#: library/inspect.rst:758
msgid "Name"
msgstr "Nom"
#: library/inspect.rst:758
msgid "Meaning"
msgstr "Signification"
#: library/inspect.rst:760
msgid "*POSITIONAL_ONLY*"
msgstr ""
#: library/inspect.rst:760
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 ""
#: library/inspect.rst:765
msgid "*POSITIONAL_OR_KEYWORD*"
msgstr ""
#: library/inspect.rst:765
msgid ""
"Value may be supplied as either a keyword or positional argument (this is "
"the standard binding behaviour for functions implemented in Python.)"
msgstr ""
#: library/inspect.rst:770
msgid "*VAR_POSITIONAL*"
msgstr ""
#: library/inspect.rst:770
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 ""
#: library/inspect.rst:775
msgid "*KEYWORD_ONLY*"
msgstr ""
#: library/inspect.rst:775
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 ""
#: library/inspect.rst:780
msgid "*VAR_KEYWORD*"
msgstr ""
#: library/inspect.rst:780
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 ""
#: library/inspect.rst:786
msgid "Example: print all keyword-only arguments without default values::"
msgstr ""
#: library/inspect.rst:800
msgid "Describes a enum value of Parameter.kind."
msgstr ""
#: library/inspect.rst:804
msgid "Example: print all descriptions of arguments::"
msgstr ""
#: library/inspect.rst:819
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 ""
#: library/inspect.rst:837
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 ""
#: library/inspect.rst:844
msgid ""
"Result of a :meth:`Signature.bind` or :meth:`Signature.bind_partial` call. "
"Holds the mapping of arguments to the function's parameters."
msgstr ""
#: library/inspect.rst:849
msgid ""
"A mutable mapping of parameters' names to arguments' values. Contains only "
"explicitly bound arguments. Changes in :attr:`arguments` will reflect in :"
"attr:`args` and :attr:`kwargs`."
msgstr ""
#: library/inspect.rst:853
msgid ""
"Should be used in conjunction with :attr:`Signature.parameters` for any "
"argument processing purposes."
msgstr ""
#: library/inspect.rst:858
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 ""
#: library/inspect.rst:863
msgid ""
":attr:`arguments` is now of type :class:`dict`. Formerly, it was of type :"
"class:`collections.OrderedDict`."
msgstr ""
#: library/inspect.rst:869
msgid ""
"A tuple of positional arguments values. Dynamically computed from the :attr:"
"`arguments` attribute."
msgstr ""
#: library/inspect.rst:874
msgid ""
"A dict of keyword arguments values. Dynamically computed from the :attr:"
"`arguments` attribute."
msgstr ""
#: library/inspect.rst:879
msgid "A reference to the parent :class:`Signature` object."
msgstr ""
#: library/inspect.rst:883
msgid "Set default values for missing arguments."
msgstr ""
#: library/inspect.rst:885
msgid ""
"For variable-positional arguments (``*args``) the default is an empty tuple."
msgstr ""
#: library/inspect.rst:888
msgid ""
"For variable-keyword arguments (``**kwargs``) the default is an empty dict."
msgstr ""
#: library/inspect.rst:901
msgid ""
"The :attr:`args` and :attr:`kwargs` properties can be used to invoke "
"functions::"
msgstr ""
#: library/inspect.rst:914
msgid ":pep:`362` - Function Signature Object."
msgstr ""
#: library/inspect.rst:915
msgid "The detailed specification, implementation details and examples."
msgstr ""
#: library/inspect.rst:921
msgid "Classes and functions"
msgstr "Classes et fonctions"
#: library/inspect.rst:925
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 ""
#: library/inspect.rst:936
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 ""
#: library/inspect.rst:944
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 ""
#: library/inspect.rst:949
msgid ""
"Alternatively, use :func:`signature` and :ref:`Signature Object <inspect-"
"signature-object>`, which provide a more structured introspection API for "
"callables."
msgstr ""
#: library/inspect.rst:956
msgid ""
"Get the names and default values of a Python function's parameters. A :term:"
"`named tuple` is returned:"
msgstr ""
#: library/inspect.rst:959
msgid ""
"``FullArgSpec(args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, "
"annotations)``"
msgstr ""
#: library/inspect.rst:962
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 ""
#: library/inspect.rst:977
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 ""
#: library/inspect.rst:984
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 ""
#: library/inspect.rst:989
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 ""
#: library/inspect.rst:1004
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 ""
#: library/inspect.rst:1048
msgid "This function was inadvertently marked as deprecated in Python 3.5."
msgstr ""
#: library/inspect.rst:1016
msgid ""
"Format a pretty argument spec from the values returned by :func:"
"`getfullargspec`."
msgstr ""
#: library/inspect.rst:1019
msgid ""
"The first seven arguments are (``args``, ``varargs``, ``varkw``, "
"``defaults``, ``kwonlyargs``, ``kwonlydefaults``, ``annotations``)."
msgstr ""
#: library/inspect.rst:1022
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 ""
#: library/inspect.rst:1026
msgid "For example:"
msgstr "Par exemple :"
#: library/inspect.rst:1035
msgid ""
"Use :func:`signature` and :ref:`Signature Object <inspect-signature-"
"object>`, which provide a better introspecting API for callables."
msgstr ""
#: library/inspect.rst:1043
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 ""
#: library/inspect.rst:1053
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 ""
#: library/inspect.rst:1061
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 ""
#: library/inspect.rst:1084
msgid "Use :meth:`Signature.bind` and :meth:`Signature.bind_partial` instead."
msgstr ""
#: library/inspect.rst:1090
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 ""
#: library/inspect.rst:1099
msgid ""
":exc:`TypeError` is raised if *func* is not a Python function or method."
msgstr ""
#: library/inspect.rst:1106
msgid ""
"Get the object wrapped by *func*. It follows the chain of :attr:"
"`__wrapped__` attributes returning the last object in the chain."
msgstr ""
#: library/inspect.rst:1109
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 ""
#: library/inspect.rst:1116
msgid ":exc:`ValueError` is raised if a cycle is encountered."
msgstr ""
#: library/inspect.rst:1123
msgid "Compute the annotations dict for an object."
msgstr ""
#: library/inspect.rst:1125
msgid ""
"``obj`` may be a callable, class, or module. Passing in an object of any "
"other type raises :exc:`TypeError`."
msgstr ""
#: library/inspect.rst:1128
msgid ""
"Returns a dict. ``get_annotations()`` returns a new dict every time it's "
"called; calling it twice on the same object will return two different but "
"equivalent dicts."
msgstr ""
#: library/inspect.rst:1132
msgid "This function handles several details for you:"
msgstr ""
#: library/inspect.rst:1134
msgid ""
"If ``eval_str`` is true, values of type ``str`` will be un-stringized using :"
"func:`eval()`. This is intended for use with stringized annotations (``from "
"__future__ import annotations``)."
msgstr ""
#: library/inspect.rst:1138
msgid ""
"If ``obj`` doesn't have an annotations dict, returns an empty dict. "
"(Functions and methods always have an annotations dict; classes, modules, "
"and other types of callables may not.)"
msgstr ""
#: library/inspect.rst:1142
msgid ""
"Ignores inherited annotations on classes. If a class doesn't have its own "
"annotations dict, returns an empty dict."
msgstr ""
#: library/inspect.rst:1144
msgid ""
"All accesses to object members and dict values are done using ``getattr()`` "
"and ``dict.get()`` for safety."
msgstr ""
#: library/inspect.rst:1146
msgid "Always, always, always returns a freshly-created dict."
msgstr ""
#: library/inspect.rst:1148
msgid ""
"``eval_str`` controls whether or not values of type ``str`` are replaced "
"with the result of calling :func:`eval()` on those values:"
msgstr ""
#: library/inspect.rst:1151
msgid ""
"If eval_str is true, :func:`eval()` is called on values of type ``str``. "
"(Note that ``get_annotations`` doesn't catch exceptions; if :func:`eval()` "
"raises an exception, it will unwind the stack past the ``get_annotations`` "
"call.)"
msgstr ""
#: library/inspect.rst:1155
msgid ""
"If eval_str is false (the default), values of type ``str`` are unchanged."
msgstr ""
#: library/inspect.rst:1157
msgid ""
"``globals`` and ``locals`` are passed in to :func:`eval()`; see the "
"documentation for :func:`eval()` for more information. If ``globals`` or "
"``locals`` is ``None``, this function may replace that value with a context-"
"specific default, contingent on ``type(obj)``:"
msgstr ""
#: library/inspect.rst:1162
msgid "If ``obj`` is a module, ``globals`` defaults to ``obj.__dict__``."
msgstr ""
#: library/inspect.rst:1163
msgid ""
"If ``obj`` is a class, ``globals`` defaults to ``sys.modules[obj.__module__]."
"__dict__`` and ``locals`` defaults to the ``obj`` class namespace."
msgstr ""
#: library/inspect.rst:1166
msgid ""
"If ``obj`` is a callable, ``globals`` defaults to ``obj.__globals__``, "
"although if ``obj`` is a wrapped function (using ``functools."
"update_wrapper()``) it is first unwrapped."
msgstr ""
#: library/inspect.rst:1170
msgid ""
"Calling ``get_annotations`` is best practice for accessing the annotations "
"dict of any object. See :ref:`annotations-howto` for more information on "
"annotations best practices."
msgstr ""
#: library/inspect.rst:1180
msgid "The interpreter stack"
msgstr ""
#: library/inspect.rst:1182
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 ""
#: library/inspect.rst:1190
msgid "Return a named tuple instead of a tuple."
msgstr ""
#: library/inspect.rst:1195
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 ""
#: library/inspect.rst:1203
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 ""
#: library/inspect.rst:1215
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 ""
#: library/inspect.rst:1219
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 ""
#: library/inspect.rst:1226
msgid ""
"Get information about a frame or traceback object. A :term:`named tuple` "
"``Traceback(filename, lineno, function, code_context, index)`` is returned."
msgstr ""
#: library/inspect.rst:1232
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 ""
#: library/inspect.rst:1250 library/inspect.rst:1287
msgid ""
"A list of :term:`named tuples <named tuple>` ``FrameInfo(frame, filename, "
"lineno, function, code_context, index)`` is returned."
msgstr ""
#: library/inspect.rst:1245
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 ""
#: library/inspect.rst:1258
msgid "Return the frame object for the caller's stack frame."
msgstr ""
#: library/inspect.rst:1262
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 ""
#: library/inspect.rst:1270
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 ""
#: library/inspect.rst:1282
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 ""
#: library/inspect.rst:1294
msgid "Fetching attributes statically"
msgstr ""
#: library/inspect.rst:1296
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 ""
#: library/inspect.rst:1301
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 ""
#: library/inspect.rst:1307
msgid ""
"Retrieve attributes without triggering dynamic lookup via the descriptor "
"protocol, :meth:`__getattr__` or :meth:`__getattribute__`."
msgstr ""
#: library/inspect.rst:1310
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 ""
#: library/inspect.rst:1316
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 ""
#: library/inspect.rst:1322
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 ""
#: library/inspect.rst:1326
msgid ""
"You can handle these with code like the following. Note that for arbitrary "
"getset descriptors invoking these may trigger code execution::"
msgstr ""
#: library/inspect.rst:1352
msgid "Current State of Generators and Coroutines"
msgstr ""
#: library/inspect.rst:1354
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 ""
#: library/inspect.rst:1362
msgid "Get current state of a generator-iterator."
msgstr ""
#: library/inspect.rst:1383
msgid "Possible states are:"
msgstr ""
#: library/inspect.rst:1365
msgid "GEN_CREATED: Waiting to start execution."
msgstr ""
#: library/inspect.rst:1366
msgid "GEN_RUNNING: Currently being executed by the interpreter."
msgstr ""
#: library/inspect.rst:1367
msgid "GEN_SUSPENDED: Currently suspended at a yield expression."
msgstr ""
#: library/inspect.rst:1368
msgid "GEN_CLOSED: Execution has completed."
msgstr ""
#: library/inspect.rst:1374
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 ""
#: library/inspect.rst:1380
msgid "CORO_CREATED: Waiting to start execution."
msgstr ""
#: library/inspect.rst:1381
msgid "CORO_RUNNING: Currently being executed by the interpreter."
msgstr ""
#: library/inspect.rst:1382
msgid "CORO_SUSPENDED: Currently suspended at an await expression."
msgstr ""
#: library/inspect.rst:1383
msgid "CORO_CLOSED: Execution has completed."
msgstr ""
#: library/inspect.rst:1387
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 ""
#: library/inspect.rst:1393
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 ""
#: library/inspect.rst:1398
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 ""
#: library/inspect.rst:1404
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 ""
#: library/inspect.rst:1413
msgid ""
"This function is analogous to :func:`~inspect.getgeneratorlocals`, but works "
"for coroutine objects created by :keyword:`async def` functions."
msgstr ""
#: library/inspect.rst:1422
msgid "Code Objects Bit Flags"
msgstr ""
#: library/inspect.rst:1424
msgid ""
"Python code objects have a ``co_flags`` attribute, which is a bitmap of the "
"following flags:"
msgstr ""
#: library/inspect.rst:1429
msgid "The code object is optimized, using fast locals."
msgstr ""
#: library/inspect.rst:1433
msgid ""
"If set, a new dict will be created for the frame's ``f_locals`` when the "
"code object is executed."
msgstr ""
#: library/inspect.rst:1438
msgid "The code object has a variable positional parameter (``*args``-like)."
msgstr ""
#: library/inspect.rst:1442
msgid "The code object has a variable keyword parameter (``**kwargs``-like)."
msgstr ""
#: library/inspect.rst:1446
msgid "The flag is set when the code object is a nested function."
msgstr ""
#: library/inspect.rst:1450
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 ""
#: library/inspect.rst:1455
msgid "The flag is set if there are no free or cell variables."
msgstr ""
#: library/inspect.rst:1459
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 ""
#: library/inspect.rst:1467
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 ""
#: library/inspect.rst:1476
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 ""
#: library/inspect.rst:1483
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 ""
#: library/inspect.rst:1493
msgid "Command Line Interface"
msgstr "Interface en ligne de commande"
#: library/inspect.rst:1495
msgid ""
"The :mod:`inspect` module also provides a basic introspection capability "
"from the command line."
msgstr ""
#: library/inspect.rst:1500
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 ""
#: library/inspect.rst:1506
msgid ""
"Print information about the specified object rather than the source code"
msgstr ""