mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 10:19:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Issue 20691: Add follow_wrapped arg to inspect.signature/from_callable.

Browse source
This commit is contained in:
Yury Selivanov 2015-05-20 14:30:08 -04:00
parent 1f507a8140
commit bcd4fc161a
5 changed files with 36 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

14
Doc/library/inspect.rst
View file

@ -431,7 +431,7 @@ 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.
.. function:: signature(callable)
.. function:: signature(callable, \*, follow_wrapped=True)
Return a :class:`Signature` object for the given ``callable``::
@ -456,6 +456,11 @@ function.
Raises :exc:`ValueError` if no signature can be provided, and
:exc:`TypeError` if that type of object is not supported.
.. versionadded:: 3.5
``follow_wrapped`` parameter. Pass ``False`` to get a signature of
``callable`` specifically (``callable.__wrapped__`` will not be used to
unwrap decorated callables.)
.. note::
Some callables may not be introspectable in certain implementations of
@ -528,12 +533,13 @@ function.
>>> str(new_sig)
"(a, b) -> 'new return anno'"
.. classmethod:: Signature.from_callable(obj)
.. classmethod:: Signature.from_callable(obj, \*, follow_wrapped=True)
Return a :class:`Signature` (or its subclass) object for a given callable
``obj``. This method simplifies subclassing of :class:`Signature`:
``obj``. Pass ``follow_wrapped=False`` to get a signature of ``obj``
without unwrapping its ``__wrapped__`` chain.
::
This method simplifies subclassing of :class:`Signature`::
class MySignature(Signature):
pass