python-docs-fr/library/inspect.po

1919 lines
55 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: 2022-05-22 23:13+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:238
msgid "__doc__"
msgstr "__doc__"
#: library/inspect.rst:48 library/inspect.rst:76 library/inspect.rst:238
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:207 library/inspect.rst:240
msgid "__name__"
msgstr "__name__"
#: library/inspect.rst:50
msgid "name with which this class was defined"
msgstr ""
#: library/inspect.rst:63 library/inspect.rst:209 library/inspect.rst:243
msgid "__qualname__"
msgstr "__qualname__"
#: library/inspect.rst:63 library/inspect.rst:209 library/inspect.rst:243
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:245
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:211 library/inspect.rst:228
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:215 library/inspect.rst:232
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
#, fuzzy
msgid "co_qualname"
msgstr "__qualname__"
#: library/inspect.rst:190
msgid "fully-qualified name with which this code object was defined"
msgstr ""
#: library/inspect.rst:194
msgid "co_names"
msgstr "co_names"
#: library/inspect.rst:194
msgid "tuple of names other than arguments and function locals"
msgstr ""
#: library/inspect.rst:198
msgid "co_nlocals"
msgstr "co_nlocals"
#: library/inspect.rst:198
msgid "number of local variables"
msgstr ""
#: library/inspect.rst:200
msgid "co_stacksize"
msgstr "co_stacksize"
#: library/inspect.rst:200
msgid "virtual machine stack space required"
msgstr ""
#: library/inspect.rst:203
msgid "co_varnames"
msgstr "co_varnames"
#: library/inspect.rst:203
msgid "tuple of names of arguments and local variables"
msgstr ""
#: library/inspect.rst:207
msgid "generator"
msgstr "générateur"
#: library/inspect.rst:221
msgid "name"
msgstr ""
#: library/inspect.rst:211
msgid "gi_frame"
msgstr "gi_frame"
#: library/inspect.rst:213
msgid "gi_running"
msgstr "gi_running"
#: library/inspect.rst:213
msgid "is the generator running?"
msgstr ""
#: library/inspect.rst:215
msgid "gi_code"
msgstr "gi_code"
#: library/inspect.rst:217
msgid "gi_yieldfrom"
msgstr "gi_yieldfrom"
#: library/inspect.rst:217
msgid "object being iterated by ``yield from``, or ``None``"
msgstr ""
#: library/inspect.rst:221
msgid "coroutine"
msgstr "coroutine"
#: library/inspect.rst:225
msgid "cr_await"
msgstr "cr_await"
#: library/inspect.rst:225
msgid "object being awaited on, or ``None``"
msgstr ""
#: library/inspect.rst:228
msgid "cr_frame"
msgstr "cr_frame"
#: library/inspect.rst:230
msgid "cr_running"
msgstr "cr_running"
#: library/inspect.rst:230
msgid "is the coroutine running?"
msgstr ""
#: library/inspect.rst:232
msgid "cr_code"
msgstr "cr_code"
#: library/inspect.rst:234
msgid "cr_origin"
msgstr ""
#: library/inspect.rst:234
msgid "where coroutine was created, or ``None``. See |coroutine-origin-link|"
msgstr ""
#: library/inspect.rst:238
msgid "builtin"
msgstr ""
#: library/inspect.rst:240
msgid "original name of this function or method"
msgstr ""
#: library/inspect.rst:245
msgid "instance to which a method is bound, or ``None``"
msgstr ""
#: library/inspect.rst:252
msgid "Add ``__qualname__`` and ``gi_yieldfrom`` attributes to generators."
msgstr ""
#: library/inspect.rst:254
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:259
msgid "Add ``cr_origin`` attribute to coroutines."
msgstr ""
#: library/inspect.rst:263
msgid "Add ``__builtins__`` attribute to functions."
msgstr ""
#: library/inspect.rst:267
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:274
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:281
msgid ""
"Return all the members of an object in a list of ``(name, value)`` pairs "
"sorted by name without triggering dynamic lookup via the descriptor "
"protocol, __getattr__ or __getattribute__. Optionally, only return members "
"that satisfy a given predicate."
msgstr ""
#: library/inspect.rst:288
msgid ""
":func:`getmembers_static` may not be able to retrieve all members that "
"getmembers can fetch (like dynamically created attributes) and may find "
"members that getmembers can't (like descriptors that raise AttributeError). "
"It can also return descriptor objects instead of instance members in some "
"cases."
msgstr ""
#: library/inspect.rst:299
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:305
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:309
msgid "The function is based directly on :mod:`importlib`."
msgstr ""
#: library/inspect.rst:315
msgid "Return ``True`` if the object is a module."
msgstr ""
#: library/inspect.rst:320
msgid ""
"Return ``True`` if the object is a class, whether built-in or created in "
"Python code."
msgstr ""
#: library/inspect.rst:326
msgid "Return ``True`` if the object is a bound method written in Python."
msgstr ""
#: library/inspect.rst:331
msgid ""
"Return ``True`` if the object is a Python function, which includes functions "
"created by a :term:`lambda` expression."
msgstr ""
#: library/inspect.rst:337
msgid "Return ``True`` if the object is a Python generator function."
msgstr ""
#: library/inspect.rst:339
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
"wrapped function is a Python generator function."
msgstr ""
#: library/inspect.rst:346
msgid "Return ``True`` if the object is a generator."
msgstr ""
#: library/inspect.rst:351
msgid ""
"Return ``True`` if the object is a :term:`coroutine function` (a function "
"defined with an :keyword:`async def` syntax)."
msgstr ""
#: library/inspect.rst:356
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
"wrapped function is a :term:`coroutine function`."
msgstr ""
#: library/inspect.rst:363
msgid ""
"Return ``True`` if the object is a :term:`coroutine` created by an :keyword:"
"`async def` function."
msgstr ""
#: library/inspect.rst:371
msgid ""
"Return ``True`` if the object can be used in :keyword:`await` expression."
msgstr ""
#: library/inspect.rst:373
msgid ""
"Can also be used to distinguish generator-based coroutines from regular "
"generators::"
msgstr ""
#: library/inspect.rst:390
msgid ""
"Return ``True`` if the object is an :term:`asynchronous generator` function, "
"for example::"
msgstr ""
#: library/inspect.rst:401
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
"wrapped function is a :term:`asynchronous generator` function."
msgstr ""
#: library/inspect.rst:408
msgid ""
"Return ``True`` if the object is an :term:`asynchronous generator iterator` "
"created by an :term:`asynchronous generator` function."
msgstr ""
#: library/inspect.rst:415
msgid "Return ``True`` if the object is a traceback."
msgstr ""
#: library/inspect.rst:420
msgid "Return ``True`` if the object is a frame."
msgstr ""
#: library/inspect.rst:425
msgid "Return ``True`` if the object is a code."
msgstr ""
#: library/inspect.rst:430
msgid ""
"Return ``True`` if the object is a built-in function or a bound built-in "
"method."
msgstr ""
#: library/inspect.rst:435
msgid ""
"Return ``True`` if the type of object is a :class:`~types.MethodWrapperType`."
msgstr ""
#: library/inspect.rst:437
msgid ""
"These are instances of :class:`~types.MethodWrapperType`, such as :meth:"
"`~object().__str__`, :meth:`~object().__eq__` and :meth:`~object().__repr__`"
msgstr ""
#: library/inspect.rst:443
msgid ""
"Return ``True`` if the object is a user-defined or built-in function or "
"method."
msgstr ""
#: library/inspect.rst:448
msgid "Return ``True`` if the object is an abstract base class."
msgstr ""
#: library/inspect.rst:453
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:457
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:463
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:471
msgid "Return ``True`` if the object is a data descriptor."
msgstr ""
#: library/inspect.rst:473
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:484
msgid "Return ``True`` if the object is a getset descriptor."
msgstr ""
#: library/inspect.rst:488
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:495
msgid "Return ``True`` if the object is a member descriptor."
msgstr ""
#: library/inspect.rst:499
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:507
msgid "Retrieving source code"
msgstr ""
#: library/inspect.rst:511
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. Return ``None`` if the "
"documentation string is invalid or missing."
msgstr ""
#: library/inspect.rst:517
msgid "Documentation strings are now inherited if not overridden."
msgstr ""
#: library/inspect.rst:523
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:532
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:539
msgid ""
"Try to guess which module an object was defined in. Return ``None`` if the "
"module cannot be determined."
msgstr ""
#: library/inspect.rst:545
msgid ""
"Return the name of the Python source file in which an object was defined or "
"``None`` if no way can be identified to get the source. This will fail with "
"a :exc:`TypeError` if the object is a built-in module, class, or function."
msgstr ""
#: library/inspect.rst:553
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:572
msgid ""
":exc:`OSError` is raised instead of :exc:`IOError`, now an alias of the "
"former."
msgstr ""
#: library/inspect.rst:567
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:579
msgid ""
"Clean up indentation from docstrings that are indented to line up with "
"blocks of code."
msgstr ""
#: library/inspect.rst:582
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:591
msgid "Introspecting callables with the Signature object"
msgstr ""
#: library/inspect.rst:595
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:601
msgid "Return a :class:`Signature` object for the given ``callable``::"
msgstr ""
#: library/inspect.rst:618
msgid ""
"Accepts a wide range of Python callables, from plain functions and classes "
"to :func:`functools.partial` objects."
msgstr ""
#: library/inspect.rst:621
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:630
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:636
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:640
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:645
msgid "``globals``, ``locals``, and ``eval_str`` parameters."
msgstr ""
#: library/inspect.rst:650
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:657
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:661
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:667
msgid ""
"The optional *return_annotation* argument, can be an arbitrary Python "
"object, is the \"return\" annotation of the callable."
msgstr ""
#: library/inspect.rst:670
msgid ""
"Signature objects are *immutable*. Use :meth:`Signature.replace` to make a "
"modified copy."
msgstr ""
#: library/inspect.rst:673
msgid "Signature objects are picklable and hashable."
msgstr ""
#: library/inspect.rst:678
msgid "A special class-level marker to specify absence of a return annotation."
msgstr ""
#: library/inspect.rst:682
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:1010
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:693
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:698
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:704
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:711
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:728
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:733
msgid "This method simplifies subclassing of :class:`Signature`::"
msgstr ""
#: library/inspect.rst:742
msgid "``globalns`` and ``localns`` parameters."
msgstr ""
#: library/inspect.rst:748
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:751
msgid "Parameter objects are picklable and hashable."
msgstr ""
#: library/inspect.rst:756
msgid ""
"A special class-level marker to specify absence of default values and "
"annotations."
msgstr ""
#: library/inspect.rst:761
msgid ""
"The name of the parameter as a string. The name must be a valid Python "
"identifier."
msgstr ""
#: library/inspect.rst:766
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:770
msgid ""
"These parameter names are exposed by this module as names like ``implicit0``."
msgstr ""
#: library/inspect.rst:776
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:781
msgid ""
"The annotation for the parameter. If the parameter has no annotation, this "
"attribute is set to :attr:`Parameter.empty`."
msgstr ""
#: library/inspect.rst:786
msgid ""
"Describes how argument values are bound to the parameter. Possible values "
"(accessible via :class:`Parameter`, like ``Parameter.KEYWORD_ONLY``):"
msgstr ""
#: library/inspect.rst:792
msgid "Name"
msgstr "Nom"
#: library/inspect.rst:792
msgid "Meaning"
msgstr "Signification"
#: library/inspect.rst:794
msgid "*POSITIONAL_ONLY*"
msgstr ""
#: library/inspect.rst:794
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:799
msgid "*POSITIONAL_OR_KEYWORD*"
msgstr ""
#: library/inspect.rst:799
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:804
msgid "*VAR_POSITIONAL*"
msgstr ""
#: library/inspect.rst:804
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:809
msgid "*KEYWORD_ONLY*"
msgstr ""
#: library/inspect.rst:809
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:814
msgid "*VAR_KEYWORD*"
msgstr ""
#: library/inspect.rst:814
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:820
msgid "Example: print all keyword-only arguments without default values::"
msgstr ""
#: library/inspect.rst:834
msgid "Describes a enum value of Parameter.kind."
msgstr ""
#: library/inspect.rst:838
msgid "Example: print all descriptions of arguments::"
msgstr ""
#: library/inspect.rst:853
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:871
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:878
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:883
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:887
msgid ""
"Should be used in conjunction with :attr:`Signature.parameters` for any "
"argument processing purposes."
msgstr ""
#: library/inspect.rst:892
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:897
msgid ""
":attr:`arguments` is now of type :class:`dict`. Formerly, it was of type :"
"class:`collections.OrderedDict`."
msgstr ""
#: library/inspect.rst:903
msgid ""
"A tuple of positional arguments values. Dynamically computed from the :attr:"
"`arguments` attribute."
msgstr ""
#: library/inspect.rst:908
msgid ""
"A dict of keyword arguments values. Dynamically computed from the :attr:"
"`arguments` attribute."
msgstr ""
#: library/inspect.rst:913
msgid "A reference to the parent :class:`Signature` object."
msgstr ""
#: library/inspect.rst:917
msgid "Set default values for missing arguments."
msgstr ""
#: library/inspect.rst:919
msgid ""
"For variable-positional arguments (``*args``) the default is an empty tuple."
msgstr ""
#: library/inspect.rst:922
msgid ""
"For variable-keyword arguments (``**kwargs``) the default is an empty dict."
msgstr ""
#: library/inspect.rst:935
msgid ""
"The :attr:`args` and :attr:`kwargs` properties can be used to invoke "
"functions::"
msgstr ""
#: library/inspect.rst:948
msgid ":pep:`362` - Function Signature Object."
msgstr ""
#: library/inspect.rst:949
msgid "The detailed specification, implementation details and examples."
msgstr ""
#: library/inspect.rst:955
msgid "Classes and functions"
msgstr "Classes et fonctions"
#: library/inspect.rst:959
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:970
msgid ""
"Get the names and default values of a Python function's parameters. A :term:"
"`named tuple` is returned:"
msgstr ""
#: library/inspect.rst:973
msgid ""
"``FullArgSpec(args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, "
"annotations)``"
msgstr ""
#: library/inspect.rst:976
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:991
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:998
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:1003
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:1018
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:1035
msgid "This function was inadvertently marked as deprecated in Python 3.5."
msgstr ""
#: library/inspect.rst:1030
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:1040
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:1048
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:1071
msgid "Use :meth:`Signature.bind` and :meth:`Signature.bind_partial` instead."
msgstr ""
#: library/inspect.rst:1077
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:1086
msgid ""
":exc:`TypeError` is raised if *func* is not a Python function or method."
msgstr ""
#: library/inspect.rst:1093
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:1096
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:1103
msgid ":exc:`ValueError` is raised if a cycle is encountered."
msgstr ""
#: library/inspect.rst:1110
msgid "Compute the annotations dict for an object."
msgstr ""
#: library/inspect.rst:1112
msgid ""
"``obj`` may be a callable, class, or module. Passing in an object of any "
"other type raises :exc:`TypeError`."
msgstr ""
#: library/inspect.rst:1115
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:1119
msgid "This function handles several details for you:"
msgstr ""
#: library/inspect.rst:1121
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:1125
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:1129
msgid ""
"Ignores inherited annotations on classes. If a class doesn't have its own "
"annotations dict, returns an empty dict."
msgstr ""
#: library/inspect.rst:1131
msgid ""
"All accesses to object members and dict values are done using ``getattr()`` "
"and ``dict.get()`` for safety."
msgstr ""
#: library/inspect.rst:1133
msgid "Always, always, always returns a freshly-created dict."
msgstr ""
#: library/inspect.rst:1135
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:1138
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:1142
msgid ""
"If eval_str is false (the default), values of type ``str`` are unchanged."
msgstr ""
#: library/inspect.rst:1144
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:1149
msgid "If ``obj`` is a module, ``globals`` defaults to ``obj.__dict__``."
msgstr ""
#: library/inspect.rst:1150
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:1153
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:1157
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:1167
msgid "The interpreter stack"
msgstr ""
#: library/inspect.rst:1169
msgid ""
"Some of the following functions return :class:`FrameInfo` objects. For "
"backwards compatibility these objects allow tuple-like operations on all "
"attributes except ``positions``. This behavior is considered deprecated and "
"may be removed in the future."
msgstr ""
#: library/inspect.rst:1178
msgid "The :ref:`frame object <frame-objects>` that the record corresponds to."
msgstr ""
#: library/inspect.rst:1182
msgid ""
"The file name associated with the code being executed by the frame this "
"record corresponds to."
msgstr ""
#: library/inspect.rst:1187
msgid ""
"The line number of the current line associated with the code being executed "
"by the frame this record corresponds to."
msgstr ""
#: library/inspect.rst:1192
msgid ""
"The function name that is being executed by the frame this record "
"corresponds to."
msgstr ""
#: library/inspect.rst:1196
msgid ""
"A list of lines of context from the source code that's being executed by the "
"frame this record corresponds to."
msgstr ""
#: library/inspect.rst:1239
msgid ""
"The index of the current line being executed in the :attr:`code_context` "
"list."
msgstr ""
#: library/inspect.rst:1205
msgid ""
"A :class:`dis.Positions` object containing the start line number, end line "
"number, start column offset, and end column offset associated with the "
"instruction being executed by the frame this record corresponds to."
msgstr ""
#: library/inspect.rst:1209
msgid "Return a named tuple instead of a tuple."
msgstr ""
#: library/inspect.rst:1212
msgid ""
"Changed the return object from a named tuple to a regular object (that is "
"backwards compatible with the previous named tuple)."
msgstr ""
#: library/inspect.rst:1220
msgid ""
"The file name associated with the code being executed by the frame this "
"traceback corresponds to."
msgstr ""
#: library/inspect.rst:1225
msgid ""
"The line number of the current line associated with the code being executed "
"by the frame this traceback corresponds to."
msgstr ""
#: library/inspect.rst:1230
msgid ""
"The function name that is being executed by the frame this traceback "
"corresponds to."
msgstr ""
#: library/inspect.rst:1234
msgid ""
"A list of lines of context from the source code that's being executed by the "
"frame this traceback corresponds to."
msgstr ""
#: library/inspect.rst:1243
msgid ""
"A :class:`dis.Positions` object containing the start line number, end line "
"number, start column offset, and end column offset associated with the "
"instruction being executed by the frame this traceback corresponds to."
msgstr ""
#: library/inspect.rst:1250
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:1258
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:1270
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:1274
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:1281
msgid ""
"Get information about a frame or traceback object. A :class:`Traceback` "
"object is returned."
msgstr ""
#: library/inspect.rst:1284
msgid "A :class:`Traceback` object is returned instead of a named tuple."
msgstr ""
#: library/inspect.rst:1289
msgid ""
"Get a list of :class:`FrameInfo` objects 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:1309 library/inspect.rst:1350
msgid ""
"A list of :term:`named tuples <named tuple>` ``FrameInfo(frame, filename, "
"lineno, function, code_context, index)`` is returned."
msgstr ""
#: library/inspect.rst:1314 library/inspect.rst:1355
msgid "A list of :class:`FrameInfo` objects is returned."
msgstr ""
#: library/inspect.rst:1304
msgid ""
"Get a list of :class:`FrameInfo` objects 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:1319
msgid "Return the frame object for the caller's stack frame."
msgstr ""
#: library/inspect.rst:1323
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:1331
msgid ""
"Return a list of :class:`FrameInfo` objects 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:1345
msgid ""
"Return a list of :class:`FrameInfo` objects 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:1359
msgid "Fetching attributes statically"
msgstr ""
#: library/inspect.rst:1361
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:1366
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:1372
msgid ""
"Retrieve attributes without triggering dynamic lookup via the descriptor "
"protocol, :meth:`__getattr__` or :meth:`__getattribute__`."
msgstr ""
#: library/inspect.rst:1375
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:1381
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:1387
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:1391
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:1417
msgid "Current State of Generators and Coroutines"
msgstr ""
#: library/inspect.rst:1419
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:1427
msgid "Get current state of a generator-iterator."
msgstr ""
#: library/inspect.rst:1448
msgid "Possible states are:"
msgstr ""
#: library/inspect.rst:1430
msgid "GEN_CREATED: Waiting to start execution."
msgstr ""
#: library/inspect.rst:1431
msgid "GEN_RUNNING: Currently being executed by the interpreter."
msgstr ""
#: library/inspect.rst:1432
msgid "GEN_SUSPENDED: Currently suspended at a yield expression."
msgstr ""
#: library/inspect.rst:1433
msgid "GEN_CLOSED: Execution has completed."
msgstr ""
#: library/inspect.rst:1439
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:1445
msgid "CORO_CREATED: Waiting to start execution."
msgstr ""
#: library/inspect.rst:1446
msgid "CORO_RUNNING: Currently being executed by the interpreter."
msgstr ""
#: library/inspect.rst:1447
msgid "CORO_SUSPENDED: Currently suspended at an await expression."
msgstr ""
#: library/inspect.rst:1448
msgid "CORO_CLOSED: Execution has completed."
msgstr ""
#: library/inspect.rst:1452
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:1458
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:1463
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:1469
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:1478
msgid ""
"This function is analogous to :func:`~inspect.getgeneratorlocals`, but works "
"for coroutine objects created by :keyword:`async def` functions."
msgstr ""
#: library/inspect.rst:1487
msgid "Code Objects Bit Flags"
msgstr ""
#: library/inspect.rst:1489
msgid ""
"Python code objects have a ``co_flags`` attribute, which is a bitmap of the "
"following flags:"
msgstr ""
#: library/inspect.rst:1494
msgid "The code object is optimized, using fast locals."
msgstr ""
#: library/inspect.rst:1498
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:1503
msgid "The code object has a variable positional parameter (``*args``-like)."
msgstr ""
#: library/inspect.rst:1507
msgid "The code object has a variable keyword parameter (``**kwargs``-like)."
msgstr ""
#: library/inspect.rst:1511
msgid "The flag is set when the code object is a nested function."
msgstr ""
#: library/inspect.rst:1515
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:1520
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:1528
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:1537
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:1544
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:1554
msgid "Command Line Interface"
msgstr "Interface en ligne de commande"
#: library/inspect.rst:1556
msgid ""
"The :mod:`inspect` module also provides a basic introspection capability "
"from the command line."
msgstr ""
#: library/inspect.rst:1561
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:1567
msgid ""
"Print information about the specified object rather than the source code"
msgstr ""
#~ msgid "For example:"
#~ msgstr "Par exemple :"