You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Add inspect.signature support for more builtins #107161
Like mentioned before for datetime classes, inspect.signature() also fails on many classes (and some functions) in builtins. However, this is not universal behaviour, as inspect.signature() works well with some classes (and most functions) in builtins.
The functions and classes in builtins that inspect.signature() supports have a str__text_signature__ pseudo-attribute, e.g.:
>>> divmod.__text_signature__
'($module, x, y, /)'
>>> complex.__text_signature__
'(real=0, imag=0)'
The proposed enhancement is to add the same __text_signature__ to others:
Functions: anext, breakpoint, dir, getattr, iter, max, min, next, vars
Classes: bool, filter, int, map, range, slice, str, and many more, incl. all Exception classes
Pitch
This addition will help consistency and avoid confusion and the need for special-casing.
Example
I ran into this when coding an arity() function using inspect.signature().parameters. My arity() works e.g. for float and complex, but fails for int, which was unexpected and confusing.
Beneficial side-effect
Likely, this will also improve help() output, e.g.
>>> help(iter)
iter(...) <<< signature missing
Get an iterator from an object.
Already available
This might seem challenging for some of the builtins functions and classes that have multiple signatures (e.g. iter(iterable) next to iter(callable, sentinel)). However, these are already available in the typeshed stub file, builtins.pyi.
A small update for python 3.13.1 and a more exhaustive list:
inspect.signature fails on the following builtins: anext, bytearray, bytes, dict, dir, getattr, int, iter, max, min, next, range, slice, str, super, type, vars
As well as all error types, which are callable.
import inspect
failing = []
for k in dir(__builtins__):
v = eval(k)
if not hasattr(v, "__call__"):
continue
try:
sig = inspect.signature(v)
except:
failing.append(k)
print(failing)
Activity
[-]Add inspect.signature support for builtins[/-][+]Add inspect.signature support for more builtins[/+]za3k commentedon Mar 1, 2025
A small update for python 3.13.1 and a more exhaustive list:
inspect.signaturefails on the following builtins:anext,bytearray,bytes,dict,dir,getattr,int,iter,max,min,next,range,slice,str,super,type,varsAs well as all error types, which are callable.
skirpichev commentedon Mar 1, 2025
For exception types: #111405
For mentioned above builtins we can't do anything, until #73536 will be solved.
Dutcho commentedon Mar 12, 2025
It looks #73536 can be solved by multi-signatures. What's required for it to be resolved?
And for #111405, brian030128 wanted to work on that. Don't know if it ever matured?