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

1713 lines
49 KiB
Plaintext
Raw Normal View History

2018-07-04 09:06:45 +00:00
# Copyright (C) 2001-2018, Python Software Foundation
2018-07-04 09:08:42 +00:00
# For licence information, see README file.
2016-10-30 09:46:26 +00:00
#
msgid ""
msgstr ""
2019-12-05 22:15:54 +00:00
"Project-Id-Version: Python 3\n"
2016-10-30 09:46:26 +00:00
"Report-Msgid-Bugs-To: \n"
2020-10-02 08:55:01 +00:00
"POT-Creation-Date: 2020-10-01 16:00+0200\n"
2019-09-06 11:50:27 +00:00
"PO-Revision-Date: 2019-09-06 13:49+0200\n"
2017-08-01 11:29:09 +00:00
"Last-Translator: Julien Palard <julien@palard.fr>\n"
2018-07-04 09:14:25 +00:00
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
2017-05-23 22:40:56 +00:00
"Language: fr\n"
2016-10-30 09:46:26 +00:00
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
2017-05-27 21:07:51 +00:00
"X-Generator: Poedit 1.8.11\n"
2016-10-30 09:46:26 +00:00
#: library/inspect.rst:2
2016-10-30 09:46:26 +00:00
msgid ":mod:`inspect` --- Inspect live objects"
msgstr ""
#: library/inspect.rst:10
2016-10-30 09:46:26 +00:00
msgid "**Source code:** :source:`Lib/inspect.py`"
msgstr "**Code source :** :source:`Lib/inspect.py`"
#: library/inspect.rst:14
2016-10-30 09:46:26 +00:00
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
2016-10-30 09:46:26 +00:00
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
2016-10-30 09:46:26 +00:00
msgid "Types and members"
msgstr ""
#: library/inspect.rst:31
2016-10-30 09:46:26 +00:00
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
2016-10-30 09:46:26 +00:00
msgid "Type"
2017-05-28 15:52:50 +00:00
msgstr "Type"
2016-10-30 09:46:26 +00:00
#: library/inspect.rst:41
2016-10-30 09:46:26 +00:00
msgid "Attribute"
2017-03-05 09:57:28 +00:00
msgstr "Attribut"
2016-10-30 09:46:26 +00:00
#: library/inspect.rst:41
2016-10-30 09:46:26 +00:00
msgid "Description"
msgstr "Description"
#: library/inspect.rst:43
2016-10-30 09:46:26 +00:00
msgid "module"
msgstr "module"
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:48 library/inspect.rst:76 library/inspect.rst:231
2016-10-30 09:46:26 +00:00
msgid "__doc__"
msgstr "__doc__"
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:48 library/inspect.rst:76 library/inspect.rst:231
2016-10-30 09:46:26 +00:00
msgid "documentation string"
msgstr ""
#: library/inspect.rst:45
2016-10-30 09:46:26 +00:00
msgid "__file__"
msgstr "__file__"
#: library/inspect.rst:45
2016-10-30 09:46:26 +00:00
msgid "filename (missing for built-in modules)"
msgstr ""
#: library/inspect.rst:48
2016-10-30 09:46:26 +00:00
msgid "class"
msgstr "classe"
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:60 library/inspect.rst:200 library/inspect.rst:233
2016-10-30 09:46:26 +00:00
msgid "__name__"
msgstr "__name__"
#: library/inspect.rst:50
2016-10-30 09:46:26 +00:00
msgid "name with which this class was defined"
msgstr ""
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:63 library/inspect.rst:202 library/inspect.rst:236
2016-10-30 09:46:26 +00:00
msgid "__qualname__"
msgstr "__qualname__"
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:63 library/inspect.rst:202 library/inspect.rst:236
2016-10-30 09:46:26 +00:00
msgid "qualified name"
msgstr "nom qualifié"
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:73 library/inspect.rst:104
2016-10-30 09:46:26 +00:00
msgid "__module__"
msgstr "__module__"
#: library/inspect.rst:55
2016-10-30 09:46:26 +00:00
msgid "name of module in which this class was defined"
msgstr ""
#: library/inspect.rst:58
2016-10-30 09:46:26 +00:00
msgid "method"
msgstr "méthode"
#: library/inspect.rst:60
2016-10-30 09:46:26 +00:00
msgid "name with which this method was defined"
msgstr ""
#: library/inspect.rst:65
2016-10-30 09:46:26 +00:00
msgid "__func__"
msgstr "__func__"
#: library/inspect.rst:65
2016-10-30 09:46:26 +00:00
msgid "function object containing implementation of method"
msgstr ""
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:238
2016-10-30 09:46:26 +00:00
msgid "__self__"
msgstr "__self__"
#: library/inspect.rst:69
2016-10-30 09:46:26 +00:00
msgid "instance to which this method is bound, or ``None``"
msgstr ""
#: library/inspect.rst:73
2020-02-04 10:14:03 +00:00
msgid "name of module in which this method was defined"
msgstr ""
#: library/inspect.rst:76
2016-10-30 09:46:26 +00:00
msgid "function"
msgstr "fonction"
#: library/inspect.rst:78
2016-10-30 09:46:26 +00:00
msgid "name with which this function was defined"
msgstr ""
#: library/inspect.rst:83
2016-10-30 09:46:26 +00:00
msgid "__code__"
msgstr "__code__"
#: library/inspect.rst:83
2016-10-30 09:46:26 +00:00
msgid "code object containing compiled function :term:`bytecode`"
msgstr ""
#: library/inspect.rst:87
2016-10-30 09:46:26 +00:00
msgid "__defaults__"
msgstr "__defaults__"
#: library/inspect.rst:87
2016-10-30 09:46:26 +00:00
msgid "tuple of any default values for positional or keyword parameters"
msgstr ""
#: library/inspect.rst:91
2016-10-30 09:46:26 +00:00
msgid "__kwdefaults__"
msgstr "__kwdefaults__"
#: library/inspect.rst:91
2016-10-30 09:46:26 +00:00
msgid "mapping of any default values for keyword-only parameters"
msgstr ""
#: library/inspect.rst:95
2016-10-30 09:46:26 +00:00
msgid "__globals__"
msgstr "__globals__"
#: library/inspect.rst:95
2016-10-30 09:46:26 +00:00
msgid "global namespace in which this function was defined"
msgstr ""
#: library/inspect.rst:98
2016-10-30 09:46:26 +00:00
msgid "__annotations__"
msgstr "__annotations__"
#: library/inspect.rst:98
2016-10-30 09:46:26 +00:00
msgid ""
"mapping of parameters names to annotations; ``\"return\"`` key is reserved "
"for return annotations."
msgstr ""
#: library/inspect.rst:104
2020-02-04 10:14:03 +00:00
msgid "name of module in which this function was defined"
msgstr ""
#: library/inspect.rst:107
2016-10-30 09:46:26 +00:00
msgid "traceback"
msgstr "traceback"
#: library/inspect.rst:107
2016-10-30 09:46:26 +00:00
msgid "tb_frame"
msgstr "tb_frame"
#: library/inspect.rst:107
2016-10-30 09:46:26 +00:00
msgid "frame object at this level"
msgstr ""
#: library/inspect.rst:110
2016-10-30 09:46:26 +00:00
msgid "tb_lasti"
msgstr "tb_lasti"
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:132
2016-10-30 09:46:26 +00:00
msgid "index of last attempted instruction in bytecode"
msgstr ""
#: library/inspect.rst:113
2016-10-30 09:46:26 +00:00
msgid "tb_lineno"
msgstr "tb_lineno"
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:135
2016-10-30 09:46:26 +00:00
msgid "current line number in Python source code"
msgstr ""
#: library/inspect.rst:116
2016-10-30 09:46:26 +00:00
msgid "tb_next"
msgstr "tb_next"
#: library/inspect.rst:116
2016-10-30 09:46:26 +00:00
msgid "next inner traceback object (called by this level)"
msgstr ""
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:204 library/inspect.rst:221
2016-10-30 09:46:26 +00:00
msgid "frame"
msgstr ""
#: library/inspect.rst:120
2016-10-30 09:46:26 +00:00
msgid "f_back"
msgstr "f_back"
#: library/inspect.rst:120
2016-10-30 09:46:26 +00:00
msgid "next outer frame object (this frame's caller)"
msgstr ""
#: library/inspect.rst:123
2016-10-30 09:46:26 +00:00
msgid "f_builtins"
msgstr "f_builtins"
#: library/inspect.rst:123
2016-10-30 09:46:26 +00:00
msgid "builtins namespace seen by this frame"
msgstr ""
#: library/inspect.rst:126
2016-10-30 09:46:26 +00:00
msgid "f_code"
msgstr "f_code"
#: library/inspect.rst:126
2016-10-30 09:46:26 +00:00
msgid "code object being executed in this frame"
msgstr ""
#: library/inspect.rst:129
2016-10-30 09:46:26 +00:00
msgid "f_globals"
msgstr "f_globals"
#: library/inspect.rst:129
2016-10-30 09:46:26 +00:00
msgid "global namespace seen by this frame"
msgstr ""
#: library/inspect.rst:132
2016-10-30 09:46:26 +00:00
msgid "f_lasti"
msgstr "f_lasti"
#: library/inspect.rst:135
2016-10-30 09:46:26 +00:00
msgid "f_lineno"
msgstr "f_lineno"
#: library/inspect.rst:138
2016-10-30 09:46:26 +00:00
msgid "f_locals"
msgstr "f_locals"
#: library/inspect.rst:138
2016-10-30 09:46:26 +00:00
msgid "local namespace seen by this frame"
msgstr ""
#: library/inspect.rst:141
2016-10-30 09:46:26 +00:00
msgid "f_trace"
msgstr "f_trace"
#: library/inspect.rst:141
2016-10-30 09:46:26 +00:00
msgid "tracing function for this frame, or ``None``"
msgstr ""
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:208 library/inspect.rst:225
2016-10-30 09:46:26 +00:00
msgid "code"
msgstr ""
#: library/inspect.rst:144
2016-10-30 09:46:26 +00:00
msgid "co_argcount"
msgstr "co_argcount"
#: library/inspect.rst:144
2017-05-27 17:46:38 +00:00
msgid ""
"number of arguments (not including keyword only arguments, \\* or \\*\\* "
"args)"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:149
2016-10-30 09:46:26 +00:00
msgid "co_code"
msgstr "co_code"
#: library/inspect.rst:149
2016-10-30 09:46:26 +00:00
msgid "string of raw compiled bytecode"
msgstr ""
#: library/inspect.rst:152
2017-05-27 17:46:38 +00:00
msgid "co_cellvars"
msgstr ""
#: library/inspect.rst:152
2017-05-27 17:46:38 +00:00
msgid "tuple of names of cell variables (referenced by containing scopes)"
msgstr ""
#: library/inspect.rst:156
2016-10-30 09:46:26 +00:00
msgid "co_consts"
msgstr "co_consts"
#: library/inspect.rst:156
2016-10-30 09:46:26 +00:00
msgid "tuple of constants used in the bytecode"
msgstr ""
#: library/inspect.rst:159
2016-10-30 09:46:26 +00:00
msgid "co_filename"
msgstr "co_filename"
#: library/inspect.rst:159
2016-10-30 09:46:26 +00:00
msgid "name of file in which this code object was created"
msgstr ""
#: library/inspect.rst:163
2016-10-30 09:46:26 +00:00
msgid "co_firstlineno"
msgstr "co_firstlineno"
#: library/inspect.rst:163
2016-10-30 09:46:26 +00:00
msgid "number of first line in Python source code"
msgstr ""
#: library/inspect.rst:166
2016-10-30 09:46:26 +00:00
msgid "co_flags"
msgstr "co_flags"
#: library/inspect.rst:166
2016-10-30 09:46:26 +00:00
msgid ""
"bitmap of ``CO_*`` flags, read more :ref:`here <inspect-module-co-flags>`"
msgstr ""
#: library/inspect.rst:170
2016-10-30 09:46:26 +00:00
msgid "co_lnotab"
msgstr "co_lnotab"
#: library/inspect.rst:170
2016-10-30 09:46:26 +00:00
msgid "encoded mapping of line numbers to bytecode indices"
msgstr ""
#: library/inspect.rst:174
2017-05-27 17:46:38 +00:00
msgid "co_freevars"
2017-05-27 21:07:51 +00:00
msgstr "co_freevars"
2017-05-27 17:46:38 +00:00
#: library/inspect.rst:174
2017-05-27 17:46:38 +00:00
msgid "tuple of names of free variables (referenced via a function's closure)"
msgstr ""
#: library/inspect.rst:178
2019-09-04 09:35:23 +00:00
msgid "co_posonlyargcount"
2019-09-06 11:50:27 +00:00
msgstr "co_posonlyargcount"
2017-05-27 17:46:38 +00:00
#: library/inspect.rst:178
2019-09-04 09:35:23 +00:00
msgid "number of positional only arguments"
msgstr ""
#: library/inspect.rst:181
2019-09-04 09:35:23 +00:00
msgid "co_kwonlyargcount"
msgstr "co_kwonlyargcount"
#: library/inspect.rst:181
2017-05-27 17:46:38 +00:00
msgid "number of keyword only arguments (not including \\*\\* arg)"
msgstr ""
#: library/inspect.rst:185
2016-10-30 09:46:26 +00:00
msgid "co_name"
msgstr "co_name"
#: library/inspect.rst:185
2016-10-30 09:46:26 +00:00
msgid "name with which this code object was defined"
msgstr ""
#: library/inspect.rst:188
2016-10-30 09:46:26 +00:00
msgid "co_names"
msgstr "co_names"
#: library/inspect.rst:188
2016-10-30 09:46:26 +00:00
msgid "tuple of names of local variables"
msgstr ""
#: library/inspect.rst:191
2016-10-30 09:46:26 +00:00
msgid "co_nlocals"
msgstr "co_nlocals"
#: library/inspect.rst:191
2016-10-30 09:46:26 +00:00
msgid "number of local variables"
msgstr ""
#: library/inspect.rst:193
2016-10-30 09:46:26 +00:00
msgid "co_stacksize"
msgstr "co_stacksize"
#: library/inspect.rst:193
2016-10-30 09:46:26 +00:00
msgid "virtual machine stack space required"
msgstr ""
#: library/inspect.rst:196
2016-10-30 09:46:26 +00:00
msgid "co_varnames"
msgstr "co_varnames"
#: library/inspect.rst:196
2016-10-30 09:46:26 +00:00
msgid "tuple of names of arguments and local variables"
msgstr ""
#: library/inspect.rst:200
2016-10-30 09:46:26 +00:00
msgid "generator"
msgstr "générateur"
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:214
2016-10-30 09:46:26 +00:00
msgid "name"
msgstr ""
#: library/inspect.rst:204
2016-10-30 09:46:26 +00:00
msgid "gi_frame"
msgstr "gi_frame"
#: library/inspect.rst:206
2016-10-30 09:46:26 +00:00
msgid "gi_running"
msgstr "gi_running"
#: library/inspect.rst:206
2016-10-30 09:46:26 +00:00
msgid "is the generator running?"
msgstr ""
#: library/inspect.rst:208
2016-10-30 09:46:26 +00:00
msgid "gi_code"
msgstr "gi_code"
#: library/inspect.rst:210
2016-10-30 09:46:26 +00:00
msgid "gi_yieldfrom"
msgstr "gi_yieldfrom"
#: library/inspect.rst:210
2016-10-30 09:46:26 +00:00
msgid "object being iterated by ``yield from``, or ``None``"
msgstr ""
#: library/inspect.rst:214
2016-10-30 09:46:26 +00:00
msgid "coroutine"
msgstr "coroutine"
#: library/inspect.rst:218
2016-10-30 09:46:26 +00:00
msgid "cr_await"
msgstr "cr_await"
#: library/inspect.rst:218
2016-10-30 09:46:26 +00:00
msgid "object being awaited on, or ``None``"
msgstr ""
#: library/inspect.rst:221
2016-10-30 09:46:26 +00:00
msgid "cr_frame"
msgstr "cr_frame"
#: library/inspect.rst:223
2016-10-30 09:46:26 +00:00
msgid "cr_running"
msgstr "cr_running"
#: library/inspect.rst:223
2016-10-30 09:46:26 +00:00
msgid "is the coroutine running?"
msgstr ""
#: library/inspect.rst:225
2016-10-30 09:46:26 +00:00
msgid "cr_code"
msgstr "cr_code"
#: library/inspect.rst:227
2018-06-28 13:32:56 +00:00
msgid "cr_origin"
msgstr ""
#: library/inspect.rst:227
2018-06-28 13:32:56 +00:00
msgid "where coroutine was created, or ``None``. See |coroutine-origin-link|"
msgstr ""
#: library/inspect.rst:231
2016-10-30 09:46:26 +00:00
msgid "builtin"
msgstr ""
#: library/inspect.rst:233
2016-10-30 09:46:26 +00:00
msgid "original name of this function or method"
msgstr ""
#: library/inspect.rst:238
2016-10-30 09:46:26 +00:00
msgid "instance to which a method is bound, or ``None``"
msgstr ""
#: library/inspect.rst:245
2016-10-30 09:46:26 +00:00
msgid "Add ``__qualname__`` and ``gi_yieldfrom`` attributes to generators."
msgstr ""
#: library/inspect.rst:247
2016-10-30 09:46:26 +00:00
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:252
2018-06-28 13:32:56 +00:00
msgid "Add ``cr_origin`` attribute to coroutines."
msgstr ""
#: library/inspect.rst:256
2016-10-30 09:46:26 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"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."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:263
2016-10-30 09:46:26 +00:00
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:270
2016-10-30 09:46:26 +00:00
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:276
2016-10-30 09:46:26 +00:00
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:280
2016-10-30 09:46:26 +00:00
msgid "The function is based directly on :mod:`importlib`."
msgstr ""
#: library/inspect.rst:286
msgid "Return ``True`` if the object is a module."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:291
2016-10-30 09:46:26 +00:00
msgid ""
"Return ``True`` if the object is a class, whether built-in or created in "
"Python code."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:297
msgid "Return ``True`` if the object is a bound method written in Python."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:302
2016-10-30 09:46:26 +00:00
msgid ""
"Return ``True`` if the object is a Python function, which includes functions "
2016-10-30 09:46:26 +00:00
"created by a :term:`lambda` expression."
msgstr ""
#: library/inspect.rst:308
msgid "Return ``True`` if the object is a Python generator function."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:310
2019-09-04 09:35:23 +00:00
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
2019-09-04 09:35:23 +00:00
"wrapped function is a Python generator function."
msgstr ""
#: library/inspect.rst:317
msgid "Return ``True`` if the object is a generator."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:322
2016-10-30 09:46:26 +00:00
msgid ""
"Return ``True`` if the object is a :term:`coroutine function` (a function "
2016-10-30 09:46:26 +00:00
"defined with an :keyword:`async def` syntax)."
msgstr ""
#: library/inspect.rst:327
2019-09-04 09:35:23 +00:00
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
2019-09-04 09:35:23 +00:00
"wrapped function is a :term:`coroutine function`."
msgstr ""
#: library/inspect.rst:334
2016-10-30 09:46:26 +00:00
msgid ""
"Return ``True`` if the object is a :term:`coroutine` created by an :keyword:"
2016-10-30 09:46:26 +00:00
"`async def` function."
msgstr ""
#: library/inspect.rst:342
msgid ""
"Return ``True`` if the object can be used in :keyword:`await` expression."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:344
2016-10-30 09:46:26 +00:00
msgid ""
"Can also be used to distinguish generator-based coroutines from regular "
"generators::"
msgstr ""
#: library/inspect.rst:361
2017-04-02 20:14:06 +00:00
msgid ""
"Return ``True`` if the object is an :term:`asynchronous generator` function, "
"for example::"
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/inspect.rst:372
2019-09-04 09:35:23 +00:00
msgid ""
"Functions wrapped in :func:`functools.partial` now return ``True`` if the "
2019-09-04 09:35:23 +00:00
"wrapped function is a :term:`asynchronous generator` function."
msgstr ""
#: library/inspect.rst:379
2017-04-02 20:14:06 +00:00
msgid ""
"Return ``True`` if the object is an :term:`asynchronous generator iterator` "
2017-04-02 20:14:06 +00:00
"created by an :term:`asynchronous generator` function."
msgstr ""
#: library/inspect.rst:386
msgid "Return ``True`` if the object is a traceback."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:391
msgid "Return ``True`` if the object is a frame."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:396
msgid "Return ``True`` if the object is a code."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:401
2016-10-30 09:46:26 +00:00
msgid ""
"Return ``True`` if the object is a built-in function or a bound built-in "
"method."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:406
2016-10-30 09:46:26 +00:00
msgid ""
"Return ``True`` if the object is a user-defined or built-in function or "
"method."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:411
msgid "Return ``True`` if the object is an abstract base class."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:416
2016-10-30 09:46:26 +00:00
msgid ""
"Return ``True`` if the object is a method descriptor, but not if :func:"
2016-10-30 09:46:26 +00:00
"`ismethod`, :func:`isclass`, :func:`isfunction` or :func:`isbuiltin` are "
"true."
msgstr ""
#: library/inspect.rst:420
2016-10-30 09:46:26 +00:00
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:426
2016-10-30 09:46:26 +00:00
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:"
2016-10-30 09:46:26 +00:00
"`__func__` attribute (etc) when an object passes :func:`ismethod`."
msgstr ""
#: library/inspect.rst:434
msgid "Return ``True`` if the object is a data descriptor."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:436
2016-10-30 09:46:26 +00:00
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."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:447
msgid "Return ``True`` if the object is a getset descriptor."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:451
2016-10-30 09:46:26 +00:00
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:458
msgid "Return ``True`` if the object is a member descriptor."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:462
2016-10-30 09:46:26 +00:00
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:470
2016-10-30 09:46:26 +00:00
msgid "Retrieving source code"
msgstr ""
#: library/inspect.rst:474
2016-10-30 09:46:26 +00:00
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:479
2016-10-30 09:46:26 +00:00
msgid "Documentation strings are now inherited if not overridden."
msgstr ""
#: library/inspect.rst:485
2016-10-30 09:46:26 +00:00
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 "
2017-04-02 20:14:06 +00:00
"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."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:494
2016-10-30 09:46:26 +00:00
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:501
2016-10-30 09:46:26 +00:00
msgid "Try to guess which module an object was defined in."
msgstr ""
#: library/inspect.rst:506
2016-10-30 09:46:26 +00:00
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:513
2016-10-30 09:46:26 +00:00
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 ""
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:532
2016-10-30 09:46:26 +00:00
msgid ""
":exc:`OSError` is raised instead of :exc:`IOError`, now an alias of the "
"former."
msgstr ""
#: library/inspect.rst:527
2016-10-30 09:46:26 +00:00
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:539
2016-10-30 09:46:26 +00:00
msgid ""
"Clean up indentation from docstrings that are indented to line up with "
"blocks of code."
msgstr ""
#: library/inspect.rst:542
2016-10-30 09:46:26 +00:00
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:551
2016-10-30 09:46:26 +00:00
msgid "Introspecting callables with the Signature object"
msgstr ""
#: library/inspect.rst:555
2016-10-30 09:46:26 +00:00
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:561
2016-10-30 09:46:26 +00:00
msgid "Return a :class:`Signature` object for the given ``callable``::"
msgstr ""
#: library/inspect.rst:578
2016-10-30 09:46:26 +00:00
msgid ""
2018-09-15 20:37:31 +00:00
"Accepts a wide range of Python callables, from plain functions and classes "
2016-10-30 09:46:26 +00:00
"to :func:`functools.partial` objects."
msgstr ""
#: library/inspect.rst:581
2016-10-30 09:46:26 +00:00
msgid ""
"Raises :exc:`ValueError` if no signature can be provided, and :exc:"
"`TypeError` if that type of object is not supported."
msgstr ""
#: library/inspect.rst:584
2016-10-30 09:46:26 +00:00
msgid ""
2019-03-20 08:41:37 +00:00
"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:588
2019-03-20 08:41:37 +00:00
msgid ""
2016-10-30 09:46:26 +00:00
"``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:595
2016-10-30 09:46:26 +00:00
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:602
2016-10-30 09:46:26 +00:00
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:606
2016-10-30 09:46:26 +00:00
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:612
2016-10-30 09:46:26 +00:00
msgid ""
"The optional *return_annotation* argument, can be an arbitrary Python "
"object, is the \"return\" annotation of the callable."
msgstr ""
#: library/inspect.rst:615
2016-10-30 09:46:26 +00:00
msgid ""
"Signature objects are *immutable*. Use :meth:`Signature.replace` to make a "
"modified copy."
msgstr ""
#: library/inspect.rst:618
2016-10-30 09:46:26 +00:00
msgid "Signature objects are picklable and hashable."
msgstr ""
#: library/inspect.rst:623
2016-10-30 09:46:26 +00:00
msgid "A special class-level marker to specify absence of a return annotation."
msgstr ""
#: library/inspect.rst:627
2016-10-30 09:46:26 +00:00
msgid ""
"An ordered mapping of parameters' names to the corresponding :class:"
2018-06-28 13:32:56 +00:00
"`Parameter` objects. Parameters appear in strict definition order, "
"including keyword-only parameters."
2016-10-30 09:46:26 +00:00
msgstr ""
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:971
2018-06-28 13:32:56 +00:00
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:638
2016-10-30 09:46:26 +00:00
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:643
2016-10-30 09:46:26 +00:00
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:649
2016-10-30 09:46:26 +00:00
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:656
2016-10-30 09:46:26 +00:00
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:673
2016-10-30 09:46:26 +00:00
msgid ""
"Return a :class:`Signature` (or its subclass) object for a given callable "
"``obj``. Pass ``follow_wrapped=False`` to get a signature of ``obj`` "
"without unwrapping its ``__wrapped__`` chain."
msgstr ""
#: library/inspect.rst:677
2016-10-30 09:46:26 +00:00
msgid "This method simplifies subclassing of :class:`Signature`::"
msgstr ""
#: library/inspect.rst:689
2016-10-30 09:46:26 +00:00
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:692
2016-10-30 09:46:26 +00:00
msgid "Parameter objects are picklable and hashable."
msgstr ""
#: library/inspect.rst:697
2016-10-30 09:46:26 +00:00
msgid ""
"A special class-level marker to specify absence of default values and "
"annotations."
msgstr ""
#: library/inspect.rst:702
2016-10-30 09:46:26 +00:00
msgid ""
"The name of the parameter as a string. The name must be a valid Python "
"identifier."
msgstr ""
#: library/inspect.rst:707
2016-10-30 09:46:26 +00:00
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:711
2016-10-30 09:46:26 +00:00
msgid ""
"These parameter names are exposed by this module as names like ``implicit0``."
msgstr ""
#: library/inspect.rst:717
2016-10-30 09:46:26 +00:00
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:722
2016-10-30 09:46:26 +00:00
msgid ""
"The annotation for the parameter. If the parameter has no annotation, this "
"attribute is set to :attr:`Parameter.empty`."
msgstr ""
#: library/inspect.rst:727
2016-10-30 09:46:26 +00:00
msgid ""
"Describes how argument values are bound to the parameter. Possible values "
"(accessible via :class:`Parameter`, like ``Parameter.KEYWORD_ONLY``):"
msgstr ""
#: library/inspect.rst:733
2016-10-30 09:46:26 +00:00
msgid "Name"
msgstr "Nom"
#: library/inspect.rst:733
2016-10-30 09:46:26 +00:00
msgid "Meaning"
msgstr "Signification"
#: library/inspect.rst:735
2016-10-30 09:46:26 +00:00
msgid "*POSITIONAL_ONLY*"
msgstr ""
#: library/inspect.rst:735
2016-10-30 09:46:26 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"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."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/inspect.rst:740
2016-10-30 09:46:26 +00:00
msgid "*POSITIONAL_OR_KEYWORD*"
msgstr ""
#: library/inspect.rst:740
2016-10-30 09:46:26 +00:00
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:745
2016-10-30 09:46:26 +00:00
msgid "*VAR_POSITIONAL*"
msgstr ""
#: library/inspect.rst:745
2016-10-30 09:46:26 +00:00
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:750
2016-10-30 09:46:26 +00:00
msgid "*KEYWORD_ONLY*"
msgstr ""
#: library/inspect.rst:750
2016-10-30 09:46:26 +00:00
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:755
2016-10-30 09:46:26 +00:00
msgid "*VAR_KEYWORD*"
msgstr ""
#: library/inspect.rst:755
2016-10-30 09:46:26 +00:00
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:761
2016-10-30 09:46:26 +00:00
msgid "Example: print all keyword-only arguments without default values::"
msgstr ""
#: library/inspect.rst:775
2019-09-04 09:35:23 +00:00
msgid "Describes a enum value of Parameter.kind."
msgstr ""
#: library/inspect.rst:779
2019-09-04 09:35:23 +00:00
msgid "Example: print all descriptions of arguments::"
msgstr ""
#: library/inspect.rst:794
2016-10-30 09:46:26 +00:00
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:812
2016-10-30 09:46:26 +00:00
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:819
2016-10-30 09:46:26 +00:00
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:824
2016-10-30 09:46:26 +00:00
msgid ""
2020-07-20 08:56:42 +00:00
"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`."
2016-10-30 09:46:26 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:828
2016-10-30 09:46:26 +00:00
msgid ""
"Should be used in conjunction with :attr:`Signature.parameters` for any "
"argument processing purposes."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:833
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:838
msgid ""
":attr:`arguments` is now of type :class:`dict`. Formerly, it was of type :"
"class:`collections.OrderedDict`."
msgstr ""
#: library/inspect.rst:844
2016-10-30 09:46:26 +00:00
msgid ""
"A tuple of positional arguments values. Dynamically computed from the :attr:"
"`arguments` attribute."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:849
2016-10-30 09:46:26 +00:00
msgid ""
"A dict of keyword arguments values. Dynamically computed from the :attr:"
"`arguments` attribute."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:854
2016-10-30 09:46:26 +00:00
msgid "A reference to the parent :class:`Signature` object."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:858
2016-10-30 09:46:26 +00:00
msgid "Set default values for missing arguments."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:860
2016-10-30 09:46:26 +00:00
msgid ""
"For variable-positional arguments (``*args``) the default is an empty tuple."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:863
2016-10-30 09:46:26 +00:00
msgid ""
"For variable-keyword arguments (``**kwargs``) the default is an empty dict."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:876
2016-10-30 09:46:26 +00:00
msgid ""
"The :attr:`args` and :attr:`kwargs` properties can be used to invoke "
"functions::"
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:889
2016-10-30 09:46:26 +00:00
msgid ":pep:`362` - Function Signature Object."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:890
2016-10-30 09:46:26 +00:00
msgid "The detailed specification, implementation details and examples."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:896
2016-10-30 09:46:26 +00:00
msgid "Classes and functions"
2019-03-09 22:39:59 +00:00
msgstr "Classes et fonctions"
2016-10-30 09:46:26 +00:00
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:900
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:911
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"Get the names and default values of a Python function's parameters. A :term:"
2016-10-30 09:46:26 +00:00
"`named tuple` ``ArgSpec(args, varargs, keywords, defaults)`` is returned. "
2017-04-02 20:14:06 +00:00
"*args* is a list of the parameter names. *varargs* and *keywords* are the "
"names of the ``*`` and ``**`` parameters or ``None``. *defaults* is a tuple "
2016-10-30 09:46:26 +00:00
"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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:919
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:924
2017-04-02 20:14:06 +00:00
msgid ""
"Alternatively, use :func:`signature` and :ref:`Signature Object <inspect-"
"signature-object>`, which provide a more structured introspection API for "
"callables."
2016-10-30 09:46:26 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:931
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"Get the names and default values of a Python function's parameters. A :term:"
2016-10-30 09:46:26 +00:00
"`named tuple` is returned:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:934
2016-10-30 09:46:26 +00:00
msgid ""
"``FullArgSpec(args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, "
"annotations)``"
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:937
2017-04-02 20:14:06 +00:00
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 "
2018-06-28 13:32:56 +00:00
"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)."
2017-04-02 20:14:06 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:952
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"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."
2016-10-30 09:46:26 +00:00
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:959
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:964
2017-04-02 20:14:06 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:979
2016-10-30 09:46:26 +00:00
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 ""
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:1023
2017-04-02 20:14:06 +00:00
msgid "This function was inadvertently marked as deprecated in Python 3.5."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:991
2016-10-30 09:46:26 +00:00
msgid ""
"Format a pretty argument spec from the values returned by :func:"
"`getfullargspec`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:994
2016-10-30 09:46:26 +00:00
msgid ""
"The first seven arguments are (``args``, ``varargs``, ``varkw``, "
"``defaults``, ``kwonlyargs``, ``kwonlydefaults``, ``annotations``)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:997
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1001
2016-10-30 09:46:26 +00:00
msgid "For example:"
2019-03-09 22:39:59 +00:00
msgstr "Par exemple :"
2016-10-30 09:46:26 +00:00
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1010
2017-04-02 20:14:06 +00:00
msgid ""
"Use :func:`signature` and :ref:`Signature Object <inspect-signature-"
"object>`, which provide a better introspecting API for callables."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1018
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1028
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1036
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1059
2016-10-30 09:46:26 +00:00
msgid "Use :meth:`Signature.bind` and :meth:`Signature.bind_partial` instead."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1065
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1074
2016-10-30 09:46:26 +00:00
msgid ""
":exc:`TypeError` is raised if *func* is not a Python function or method."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1081
2016-10-30 09:46:26 +00:00
msgid ""
"Get the object wrapped by *func*. It follows the chain of :attr:"
"`__wrapped__` attributes returning the last object in the chain."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1084
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1091
2016-10-30 09:46:26 +00:00
msgid ":exc:`ValueError` is raised if a cycle is encountered."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1099
2016-10-30 09:46:26 +00:00
msgid "The interpreter stack"
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1101
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1109
2016-10-30 09:46:26 +00:00
msgid "Return a named tuple instead of a tuple."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1114
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1122
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1134
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1138
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1145
2016-10-30 09:46:26 +00:00
msgid ""
"Get information about a frame or traceback object. A :term:`named tuple` "
"``Traceback(filename, lineno, function, code_context, index)`` is returned."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1151
2016-10-30 09:46:26 +00:00
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 ""
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:1169 library/inspect.rst:1206
2016-10-30 09:46:26 +00:00
msgid ""
"A list of :term:`named tuples <named tuple>` ``FrameInfo(frame, filename, "
"lineno, function, code_context, index)`` is returned."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1164
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1177
2016-10-30 09:46:26 +00:00
msgid "Return the frame object for the caller's stack frame."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1181
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1189
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1201
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1213
2016-10-30 09:46:26 +00:00
msgid "Fetching attributes statically"
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1215
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1220
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1226
2016-10-30 09:46:26 +00:00
msgid ""
"Retrieve attributes without triggering dynamic lookup via the descriptor "
"protocol, :meth:`__getattr__` or :meth:`__getattribute__`."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1229
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1235
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1241
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1245
2016-10-30 09:46:26 +00:00
msgid ""
"You can handle these with code like the following. Note that for arbitrary "
"getset descriptors invoking these may trigger code execution::"
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1271
2016-10-30 09:46:26 +00:00
msgid "Current State of Generators and Coroutines"
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1273
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1281
2016-10-30 09:46:26 +00:00
msgid "Get current state of a generator-iterator."
msgstr ""
2020-10-02 08:55:01 +00:00
#: library/inspect.rst:1302
2016-10-30 09:46:26 +00:00
msgid "Possible states are:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1284
2016-10-30 09:46:26 +00:00
msgid "GEN_CREATED: Waiting to start execution."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1285
2016-10-30 09:46:26 +00:00
msgid "GEN_RUNNING: Currently being executed by the interpreter."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1286
2016-10-30 09:46:26 +00:00
msgid "GEN_SUSPENDED: Currently suspended at a yield expression."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1287
2016-10-30 09:46:26 +00:00
msgid "GEN_CLOSED: Execution has completed."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1293
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1299
2016-10-30 09:46:26 +00:00
msgid "CORO_CREATED: Waiting to start execution."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1300
2016-10-30 09:46:26 +00:00
msgid "CORO_RUNNING: Currently being executed by the interpreter."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1301
2016-10-30 09:46:26 +00:00
msgid "CORO_SUSPENDED: Currently suspended at an await expression."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1302
2016-10-30 09:46:26 +00:00
msgid "CORO_CLOSED: Execution has completed."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1306
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1312
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1317
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1323
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1332
2016-10-30 09:46:26 +00:00
msgid ""
"This function is analogous to :func:`~inspect.getgeneratorlocals`, but works "
"for coroutine objects created by :keyword:`async def` functions."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1341
2016-10-30 09:46:26 +00:00
msgid "Code Objects Bit Flags"
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1343
2016-10-30 09:46:26 +00:00
msgid ""
"Python code objects have a ``co_flags`` attribute, which is a bitmap of the "
"following flags:"
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1348
2017-05-27 17:46:38 +00:00
msgid "The code object is optimized, using fast locals."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1352
2016-10-30 09:46:26 +00:00
msgid ""
"If set, a new dict will be created for the frame's ``f_locals`` when the "
"code object is executed."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1357
2016-10-30 09:46:26 +00:00
msgid "The code object has a variable positional parameter (``*args``-like)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1361
2016-10-30 09:46:26 +00:00
msgid "The code object has a variable keyword parameter (``**kwargs``-like)."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1365
2017-05-27 17:46:38 +00:00
msgid "The flag is set when the code object is a nested function."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1369
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1374
2016-10-30 09:46:26 +00:00
msgid "The flag is set if there are no free or cell variables."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1378
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1386
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1395
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1402
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1412
2016-10-30 09:46:26 +00:00
msgid "Command Line Interface"
2017-09-12 12:04:46 +00:00
msgstr "Interface en ligne de commande"
2016-10-30 09:46:26 +00:00
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1414
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`inspect` module also provides a basic introspection capability "
"from the command line."
msgstr ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1419
2016-10-30 09:46:26 +00:00
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 ""
2020-07-20 08:56:42 +00:00
#: library/inspect.rst:1425
2016-10-30 09:46:26 +00:00
msgid ""
"Print information about the specified object rather than the source code"
msgstr ""