forked from AFPy/python-docs-fr
918 lines
26 KiB
Plaintext
918 lines
26 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 1990-2016, Python Software Foundation
|
|
# This file is distributed under the same license as the Python package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 2.7\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2016-10-30 10:44+0100\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../Doc/library/inspect.rst:2
|
|
msgid ":mod:`inspect` --- Inspect live objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:12
|
|
msgid "**Source code:** :source:`Lib/inspect.py`"
|
|
msgstr "**Code source :** :source:`Lib/inspect.py`"
|
|
|
|
#: ../Doc/library/inspect.rst:16
|
|
msgid ""
|
|
"The :mod:`inspect` module provides several useful functions to help get "
|
|
"information about live objects such as modules, classes, methods, functions, "
|
|
"tracebacks, frame objects, and code objects. For example, it can help you "
|
|
"examine the contents of a class, retrieve the source code of a method, "
|
|
"extract and format the argument list for a function, or get all the "
|
|
"information you need to display a detailed traceback."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:23
|
|
msgid ""
|
|
"There are four main kinds of services provided by this module: type "
|
|
"checking, getting source code, inspecting classes and functions, and "
|
|
"examining the interpreter stack."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:31
|
|
msgid "Types and members"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:33
|
|
msgid ""
|
|
"The :func:`getmembers` function retrieves the members of an object such as a "
|
|
"class or module. The sixteen functions whose names begin with \"is\" are "
|
|
"mainly provided as convenient choices for the second argument to :func:"
|
|
"`getmembers`. They also help you determine when you can expect to find the "
|
|
"following special attributes:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:40
|
|
msgid "Type"
|
|
msgstr "Type"
|
|
|
|
#: ../Doc/library/inspect.rst:40
|
|
msgid "Attribute"
|
|
msgstr "Attribut"
|
|
|
|
#: ../Doc/library/inspect.rst:40
|
|
msgid "Description"
|
|
msgstr "Description"
|
|
|
|
#: ../Doc/library/inspect.rst:40
|
|
msgid "Notes"
|
|
msgstr "Notes"
|
|
|
|
#: ../Doc/library/inspect.rst:42
|
|
msgid "module"
|
|
msgstr "module"
|
|
|
|
#: ../Doc/library/inspect.rst:42 ../Doc/library/inspect.rst:47
|
|
#: ../Doc/library/inspect.rst:52 ../Doc/library/inspect.rst:68
|
|
#: ../Doc/library/inspect.rst:208
|
|
msgid "__doc__"
|
|
msgstr "__doc__"
|
|
|
|
#: ../Doc/library/inspect.rst:42 ../Doc/library/inspect.rst:47
|
|
#: ../Doc/library/inspect.rst:52 ../Doc/library/inspect.rst:68
|
|
#: ../Doc/library/inspect.rst:208
|
|
msgid "documentation string"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:44
|
|
msgid "__file__"
|
|
msgstr "__file__"
|
|
|
|
#: ../Doc/library/inspect.rst:44
|
|
msgid "filename (missing for built-in modules)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:47
|
|
msgid "class"
|
|
msgstr "classe"
|
|
|
|
#: ../Doc/library/inspect.rst:49
|
|
msgid "__module__"
|
|
msgstr "__module__"
|
|
|
|
#: ../Doc/library/inspect.rst:49
|
|
msgid "name of module in which this class was defined"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:52
|
|
msgid "method"
|
|
msgstr "méthode"
|
|
|
|
#: ../Doc/library/inspect.rst:54 ../Doc/library/inspect.rst:70
|
|
#: ../Doc/library/inspect.rst:210
|
|
msgid "__name__"
|
|
msgstr "__name__"
|
|
|
|
#: ../Doc/library/inspect.rst:54
|
|
msgid "name with which this method was defined"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:57
|
|
msgid "im_class"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:57
|
|
msgid "class object that asked for this method"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:57
|
|
msgid "\\(1)"
|
|
msgstr "\\(1)"
|
|
|
|
#: ../Doc/library/inspect.rst:60
|
|
msgid "im_func or __func__"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:60
|
|
msgid "function object containing implementation of method"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:64
|
|
msgid "im_self or __self__"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:64
|
|
msgid "instance to which this method is bound, or ``None``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:68
|
|
msgid "function"
|
|
msgstr "fonction"
|
|
|
|
#: ../Doc/library/inspect.rst:70
|
|
msgid "name with which this function was defined"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:73
|
|
msgid "func_code"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:73
|
|
msgid "code object containing compiled function :term:`bytecode`"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:77
|
|
msgid "func_defaults"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:77
|
|
msgid "tuple of any default values for arguments"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:80
|
|
msgid "func_doc"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:80
|
|
msgid "(same as __doc__)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:82
|
|
msgid "func_globals"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:82
|
|
msgid "global namespace in which this function was defined"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:85
|
|
msgid "func_name"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:85
|
|
msgid "(same as __name__)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:87
|
|
msgid "generator"
|
|
msgstr "générateur"
|
|
|
|
#: ../Doc/library/inspect.rst:87
|
|
msgid "__iter__"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:87
|
|
msgid "defined to support iteration over container"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:90
|
|
msgid "close"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:90
|
|
msgid ""
|
|
"raises new GeneratorExit exception inside the generator to terminate the "
|
|
"iteration"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:95
|
|
msgid "gi_code"
|
|
msgstr "gi_code"
|
|
|
|
#: ../Doc/library/inspect.rst:95
|
|
msgid "code object"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:97
|
|
msgid "gi_frame"
|
|
msgstr "gi_frame"
|
|
|
|
#: ../Doc/library/inspect.rst:97
|
|
msgid "frame object or possibly ``None`` once the generator has been exhausted"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:102
|
|
msgid "gi_running"
|
|
msgstr "gi_running"
|
|
|
|
#: ../Doc/library/inspect.rst:102
|
|
msgid "set to 1 when generator is executing, 0 otherwise"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:105
|
|
msgid "next"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:105
|
|
msgid "return the next item from the container"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:108
|
|
msgid "send"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:108
|
|
msgid ""
|
|
"resumes the generator and \"sends\" a value that becomes the result of the "
|
|
"current yield-expression"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:113
|
|
msgid "throw"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:113
|
|
msgid "used to raise an exception inside the generator"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:117
|
|
msgid "traceback"
|
|
msgstr "traceback"
|
|
|
|
#: ../Doc/library/inspect.rst:117
|
|
msgid "tb_frame"
|
|
msgstr "tb_frame"
|
|
|
|
#: ../Doc/library/inspect.rst:117
|
|
msgid "frame object at this level"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:120
|
|
msgid "tb_lasti"
|
|
msgstr "tb_lasti"
|
|
|
|
#: ../Doc/library/inspect.rst:120 ../Doc/library/inspect.rst:153
|
|
msgid "index of last attempted instruction in bytecode"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:123
|
|
msgid "tb_lineno"
|
|
msgstr "tb_lineno"
|
|
|
|
#: ../Doc/library/inspect.rst:123 ../Doc/library/inspect.rst:156
|
|
msgid "current line number in Python source code"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:126
|
|
msgid "tb_next"
|
|
msgstr "tb_next"
|
|
|
|
#: ../Doc/library/inspect.rst:126
|
|
msgid "next inner traceback object (called by this level)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:130
|
|
msgid "frame"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:130
|
|
msgid "f_back"
|
|
msgstr "f_back"
|
|
|
|
#: ../Doc/library/inspect.rst:130
|
|
msgid "next outer frame object (this frame's caller)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:133
|
|
msgid "f_builtins"
|
|
msgstr "f_builtins"
|
|
|
|
#: ../Doc/library/inspect.rst:133
|
|
msgid "builtins namespace seen by this frame"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:136
|
|
msgid "f_code"
|
|
msgstr "f_code"
|
|
|
|
#: ../Doc/library/inspect.rst:136
|
|
msgid "code object being executed in this frame"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:139
|
|
msgid "f_exc_traceback"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:139
|
|
msgid "traceback if raised in this frame, or ``None``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:142
|
|
msgid "f_exc_type"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:142
|
|
msgid "exception type if raised in this frame, or ``None``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:146
|
|
msgid "f_exc_value"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:146
|
|
msgid "exception value if raised in this frame, or ``None``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:150
|
|
msgid "f_globals"
|
|
msgstr "f_globals"
|
|
|
|
#: ../Doc/library/inspect.rst:150
|
|
msgid "global namespace seen by this frame"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:153
|
|
msgid "f_lasti"
|
|
msgstr "f_lasti"
|
|
|
|
#: ../Doc/library/inspect.rst:156
|
|
msgid "f_lineno"
|
|
msgstr "f_lineno"
|
|
|
|
#: ../Doc/library/inspect.rst:159
|
|
msgid "f_locals"
|
|
msgstr "f_locals"
|
|
|
|
#: ../Doc/library/inspect.rst:159
|
|
msgid "local namespace seen by this frame"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:162
|
|
msgid "f_restricted"
|
|
msgstr "f_restricted"
|
|
|
|
#: ../Doc/library/inspect.rst:162
|
|
msgid "0 or 1 if frame is in restricted execution mode"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:165
|
|
msgid "f_trace"
|
|
msgstr "f_trace"
|
|
|
|
#: ../Doc/library/inspect.rst:165
|
|
msgid "tracing function for this frame, or ``None``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:168
|
|
msgid "code"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:168
|
|
msgid "co_argcount"
|
|
msgstr "co_argcount"
|
|
|
|
#: ../Doc/library/inspect.rst:168
|
|
msgid "number of arguments (not including \\* or \\*\\* args)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:172
|
|
msgid "co_code"
|
|
msgstr "co_code"
|
|
|
|
#: ../Doc/library/inspect.rst:172
|
|
msgid "string of raw compiled bytecode"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:175
|
|
msgid "co_consts"
|
|
msgstr "co_consts"
|
|
|
|
#: ../Doc/library/inspect.rst:175
|
|
msgid "tuple of constants used in the bytecode"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:178
|
|
msgid "co_filename"
|
|
msgstr "co_filename"
|
|
|
|
#: ../Doc/library/inspect.rst:178
|
|
msgid "name of file in which this code object was created"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:182
|
|
msgid "co_firstlineno"
|
|
msgstr "co_firstlineno"
|
|
|
|
#: ../Doc/library/inspect.rst:182
|
|
msgid "number of first line in Python source code"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:185
|
|
msgid "co_flags"
|
|
msgstr "co_flags"
|
|
|
|
#: ../Doc/library/inspect.rst:185
|
|
msgid "bitmap: 1=optimized ``|`` 2=newlocals ``|`` 4=\\*arg ``|`` 8=\\*\\*arg"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:189
|
|
msgid "co_lnotab"
|
|
msgstr "co_lnotab"
|
|
|
|
#: ../Doc/library/inspect.rst:189
|
|
msgid "encoded mapping of line numbers to bytecode indices"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:193
|
|
msgid "co_name"
|
|
msgstr "co_name"
|
|
|
|
#: ../Doc/library/inspect.rst:193
|
|
msgid "name with which this code object was defined"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:196
|
|
msgid "co_names"
|
|
msgstr "co_names"
|
|
|
|
#: ../Doc/library/inspect.rst:196
|
|
msgid "tuple of names of local variables"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:199
|
|
msgid "co_nlocals"
|
|
msgstr "co_nlocals"
|
|
|
|
#: ../Doc/library/inspect.rst:199
|
|
msgid "number of local variables"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:201
|
|
msgid "co_stacksize"
|
|
msgstr "co_stacksize"
|
|
|
|
#: ../Doc/library/inspect.rst:201
|
|
msgid "virtual machine stack space required"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:204
|
|
msgid "co_varnames"
|
|
msgstr "co_varnames"
|
|
|
|
#: ../Doc/library/inspect.rst:204
|
|
msgid "tuple of names of arguments and local variables"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:208
|
|
msgid "builtin"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:210
|
|
msgid "original name of this function or method"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:213
|
|
msgid "__self__"
|
|
msgstr "__self__"
|
|
|
|
#: ../Doc/library/inspect.rst:213
|
|
msgid "instance to which a method is bound, or ``None``"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:218
|
|
msgid "Note:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:221
|
|
msgid ":attr:`im_class` used to refer to the class that defined the method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:227
|
|
msgid ""
|
|
"Return all the members of an object in a list of (name, value) pairs sorted "
|
|
"by name. If the optional *predicate* argument is supplied, only members for "
|
|
"which the predicate returns a true value are included."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:233
|
|
msgid ""
|
|
":func:`getmembers` does not return metaclass attributes when the argument is "
|
|
"a class (this behavior is inherited from the :func:`dir` function)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:239
|
|
msgid ""
|
|
"Return a tuple of values that describe how Python will interpret the file "
|
|
"identified by *path* if it is a module, or ``None`` if it would not be "
|
|
"identified as a module. The return tuple is ``(name, suffix, mode, "
|
|
"module_type)``, where *name* is the name of the module without the name of "
|
|
"any enclosing package, *suffix* is the trailing part of the file name (which "
|
|
"may not be a dot-delimited extension), *mode* is the :func:`open` mode that "
|
|
"would be used (``'r'`` or ``'rb'``), and *module_type* is an integer giving "
|
|
"the type of the module. *module_type* will have a value which can be "
|
|
"compared to the constants defined in the :mod:`imp` module; see the "
|
|
"documentation for that module for more information on module types."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:250
|
|
msgid ""
|
|
"Returns a :term:`named tuple` ``ModuleInfo(name, suffix, mode, "
|
|
"module_type)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:257
|
|
msgid ""
|
|
"Return the name of the module named by the file *path*, without including "
|
|
"the names of enclosing packages. This uses the same algorithm as the "
|
|
"interpreter uses when searching for modules. If the name cannot be matched "
|
|
"according to the interpreter's rules, ``None`` is returned."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:265
|
|
msgid "Return true if the object is a module."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:270
|
|
msgid ""
|
|
"Return true if the object is a class, whether built-in or created in Python "
|
|
"code."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:276
|
|
msgid ""
|
|
"Return true if the object is a bound or unbound method written in Python."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:282
|
|
msgid ""
|
|
"Return true if the object is a Python function, which includes functions "
|
|
"created by a :term:`lambda` expression."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:288
|
|
msgid "Return true if the object is a Python generator function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:295
|
|
msgid "Return true if the object is a generator."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:302
|
|
msgid "Return true if the object is a traceback."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:307
|
|
msgid "Return true if the object is a frame."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:312
|
|
msgid "Return true if the object is a code."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:317
|
|
msgid ""
|
|
"Return true if the object is a built-in function or a bound built-in method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:322
|
|
msgid ""
|
|
"Return true if the object is a user-defined or built-in function or method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:327
|
|
msgid "Return true if the object is an abstract base class."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:334
|
|
msgid ""
|
|
"Return true if the object is a method descriptor, but not if :func:"
|
|
"`ismethod`, :func:`isclass`, :func:`isfunction` or :func:`isbuiltin` are "
|
|
"true."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:338
|
|
msgid ""
|
|
"This is new as of Python 2.2, and, for example, is true of ``int.__add__``. "
|
|
"An object passing this test has a :meth:`~object.__get__` method but not a :"
|
|
"meth:`~object.__set__` method, but beyond that the set of attributes "
|
|
"varies. A :attr:`~definition.__name__` attribute is usually sensible, and :"
|
|
"attr:`__doc__` often is."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:345
|
|
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:"
|
|
"`im_func` attribute (etc) when an object passes :func:`ismethod`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:353
|
|
msgid "Return true if the object is a data descriptor."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:355
|
|
msgid ""
|
|
"Data descriptors have both a :attr:`~object.__get__` and a :attr:`~object."
|
|
"__set__` method. Examples are properties (defined in Python), getsets, and "
|
|
"members. The latter two are defined in C and there are more specific tests "
|
|
"available for those types, which is robust across Python implementations. "
|
|
"Typically, data descriptors will also have :attr:`~definition.__name__` and :"
|
|
"attr:`__doc__` attributes (properties, getsets, and members have both of "
|
|
"these attributes), but this is not guaranteed."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:368
|
|
msgid "Return true if the object is a getset descriptor."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:372
|
|
msgid ""
|
|
"getsets are attributes defined in extension modules via :c:type:"
|
|
"`PyGetSetDef` structures. For Python implementations without such types, "
|
|
"this method will always return ``False``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:381
|
|
msgid "Return true if the object is a member descriptor."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:385
|
|
msgid ""
|
|
"Member descriptors are attributes defined in extension modules via :c:type:"
|
|
"`PyMemberDef` structures. For Python implementations without such types, "
|
|
"this method will always return ``False``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:395
|
|
msgid "Retrieving source code"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:399
|
|
msgid ""
|
|
"Get the documentation string for an object, cleaned up with :func:`cleandoc`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:404
|
|
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)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:411
|
|
msgid ""
|
|
"Return the name of the (text or binary) file in which an object was defined. "
|
|
"This will fail with a :exc:`TypeError` if the object is a built-in module, "
|
|
"class, or function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:418
|
|
msgid "Try to guess which module an object was defined in."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:423
|
|
msgid ""
|
|
"Return the name of the Python source file in which an object was defined. "
|
|
"This will fail with a :exc:`TypeError` if the object is a built-in module, "
|
|
"class, or function."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:430
|
|
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:`IOError` is raised if the source "
|
|
"code cannot be retrieved."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:440
|
|
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:`IOError` is raised if "
|
|
"the source code cannot be retrieved."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:448
|
|
msgid ""
|
|
"Clean up indentation from docstrings that are indented to line up with "
|
|
"blocks of code."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:451
|
|
msgid ""
|
|
"All leading whitespace is removed from the first line. Any leading "
|
|
"whitespace that can be uniformly removed from the second line onwards is "
|
|
"removed. Empty lines at the beginning and end are subsequently removed. "
|
|
"Also, all tabs are expanded to spaces."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:462
|
|
msgid "Classes and functions"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:467
|
|
msgid ""
|
|
"Arrange the given list of classes into a hierarchy of nested lists. Where a "
|
|
"nested list appears, it contains classes derived from the class whose entry "
|
|
"immediately precedes the list. Each entry is a 2-tuple containing a class "
|
|
"and a tuple of its base classes. If the *unique* argument is true, exactly "
|
|
"one entry appears in the returned structure for each class in the given "
|
|
"list. Otherwise, classes using multiple inheritance and their descendants "
|
|
"will appear multiple times."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:478
|
|
msgid ""
|
|
"Get the names and default values of a Python function's arguments. A tuple "
|
|
"of four things is returned: ``(args, varargs, keywords, defaults)``. *args* "
|
|
"is a list of the argument names (it may contain nested lists). *varargs* and "
|
|
"*keywords* are the names of the ``*`` and ``**`` arguments or ``None``. "
|
|
"*defaults* is a tuple of default argument values or ``None`` if there are no "
|
|
"default arguments; if this tuple has *n* elements, they correspond to the "
|
|
"last *n* elements listed in *args*."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:486
|
|
msgid ""
|
|
"Returns a :term:`named tuple` ``ArgSpec(args, varargs, keywords, defaults)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:493
|
|
msgid ""
|
|
"Get information about arguments passed into a particular frame. A tuple of "
|
|
"four things is returned: ``(args, varargs, keywords, locals)``. *args* is a "
|
|
"list of the argument names (it may contain nested lists). *varargs* and "
|
|
"*keywords* are the names of the ``*`` and ``**`` arguments or ``None``. "
|
|
"*locals* is the locals dictionary of the given frame."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:499
|
|
msgid ""
|
|
"Returns a :term:`named tuple` ``ArgInfo(args, varargs, keywords, locals)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:506
|
|
msgid ""
|
|
"Format a pretty argument spec from the four values returned by :func:"
|
|
"`getargspec`. The format\\* arguments are the corresponding optional "
|
|
"formatting functions that are called to turn names and values into strings."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:513
|
|
msgid ""
|
|
"Format a pretty argument spec from the four values returned by :func:"
|
|
"`getargvalues`. The format\\* arguments are the corresponding optional "
|
|
"formatting functions that are called to turn names and values into strings."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:520
|
|
msgid ""
|
|
"Return a tuple of class cls's base classes, including cls, in method "
|
|
"resolution order. No class appears more than once in this tuple. Note that "
|
|
"the method resolution order depends on cls's type. Unless a very peculiar "
|
|
"user-defined metatype is in use, cls will be the first element of the tuple."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:528
|
|
msgid ""
|
|
"Bind the *args* and *kwds* to the argument names of the Python function or "
|
|
"method *func*, as if it was called with them. For bound methods, bind also "
|
|
"the first argument (typically named ``self``) to the associated instance. A "
|
|
"dict is returned, mapping the argument names (including the names of the "
|
|
"``*`` and ``**`` arguments, if any) to their values from *args* and *kwds*. "
|
|
"In case of invoking *func* incorrectly, i.e. whenever ``func(*args, "
|
|
"**kwds)`` would raise an exception because of incompatible signature, an "
|
|
"exception of the same type and the same or similar message is raised. For "
|
|
"example::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:555
|
|
msgid "The interpreter stack"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:557
|
|
msgid ""
|
|
"When the following functions return \"frame records,\" each record is a "
|
|
"tuple of six items: the frame object, the filename, the line number of the "
|
|
"current line, the function name, a list of lines of context from the source "
|
|
"code, and the index of the current line within that list."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:564
|
|
msgid ""
|
|
"Keeping references to frame objects, as found in the first element of the "
|
|
"frame records these functions return, can cause your program to create "
|
|
"reference cycles. Once a reference cycle has been created, the lifespan of "
|
|
"all objects which can be accessed from the objects which form the cycle can "
|
|
"become much longer even if Python's optional cycle detector is enabled. If "
|
|
"such cycles must be created, it is important to ensure they are explicitly "
|
|
"broken to avoid the delayed destruction of objects and increased memory "
|
|
"consumption which occurs."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:572
|
|
msgid ""
|
|
"Though the cycle detector will catch these, destruction of the frames (and "
|
|
"local variables) can be made deterministic by removing the cycle in a :"
|
|
"keyword:`finally` clause. This is also important if the cycle detector was "
|
|
"disabled when Python was compiled or using :func:`gc.disable`. For example::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:584
|
|
msgid ""
|
|
"The optional *context* argument supported by most of these functions "
|
|
"specifies the number of lines of context to return, which are centered "
|
|
"around the current line."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:591
|
|
msgid ""
|
|
"Get information about a frame or traceback object. A 5-tuple is returned, "
|
|
"the last five elements of the frame's frame record."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:594
|
|
msgid ""
|
|
"Returns a :term:`named tuple` ``Traceback(filename, lineno, function, "
|
|
"code_context, index)``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:601
|
|
msgid ""
|
|
"Get a list of frame records for a frame and all outer frames. These frames "
|
|
"represent the calls that lead to the creation of *frame*. The first entry in "
|
|
"the returned list represents *frame*; the last entry represents the "
|
|
"outermost call on *frame*'s stack."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:609
|
|
msgid ""
|
|
"Get a list of frame records for a traceback's frame and all inner frames. "
|
|
"These frames represent calls made as a consequence of *frame*. The first "
|
|
"entry in the list represents *traceback*; the last entry represents where "
|
|
"the exception was raised."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:617
|
|
msgid "Return the frame object for the caller's stack frame."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:621
|
|
msgid ""
|
|
"This function relies on Python stack frame support in the interpreter, which "
|
|
"isn't guaranteed to exist in all implementations of Python. If running in "
|
|
"an implementation without Python stack frame support this function returns "
|
|
"``None``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:629
|
|
msgid ""
|
|
"Return a list of frame records for the caller's stack. The first entry in "
|
|
"the returned list represents the caller; the last entry represents the "
|
|
"outermost call on the stack."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/inspect.rst:636
|
|
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 ""
|