mirror of
https://github.com/python/cpython.git
synced 2025-08-04 17:08:35 +00:00
[3.11] gh-115937: Remove implementation details from inspect.signature() docs (GH-116086) (#116107)
gh-115937: Remove implementation details from inspect.signature() docs (GH-116086)
(cherry picked from commit fb2e17b642
)
Co-authored-by: Erlend E. Aasland <erlend@python.org>
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
This commit is contained in:
parent
e7dc85308f
commit
6e328371c5
1 changed files with 7 additions and 3 deletions
|
@ -634,9 +634,6 @@ function.
|
|||
Accepts a wide range of Python callables, from plain functions and classes to
|
||||
:func:`functools.partial` objects.
|
||||
|
||||
If the passed object has a ``__signature__`` attribute, this function
|
||||
returns it without further computations.
|
||||
|
||||
For objects defined in modules using stringized annotations
|
||||
(``from __future__ import annotations``), :func:`signature` will
|
||||
attempt to automatically un-stringize the annotations using
|
||||
|
@ -671,6 +668,13 @@ function.
|
|||
Python. For example, in CPython, some built-in functions defined in
|
||||
C provide no metadata about their arguments.
|
||||
|
||||
.. impl-detail::
|
||||
|
||||
If the passed object has a :attr:`!__signature__` attribute,
|
||||
we may use it to create the signature.
|
||||
The exact semantics are an implementation detail and are subject to
|
||||
unannounced changes. Consult the source code for current semantics.
|
||||
|
||||
|
||||
.. class:: Signature(parameters=None, *, return_annotation=Signature.empty)
|
||||
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue