bpo-30533: Add docs for `inspect.getmembers_static` (#29874)

* Add docs for `inspect.getmembers_static`

* update
This commit is contained in:
Weipeng Hong 2021-12-02 03:23:46 +08:00 committed by GitHub
parent ee94aa0850
commit c2bb29ce9a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 25 additions and 0 deletions

View File

@ -275,6 +275,24 @@ attributes:
listed in the metaclass' custom :meth:`__dir__`.
.. function:: getmembers_static(object[, predicate])
Return all the members of an object in a list of ``(name, value)``
pairs sorted by name without triggering dynamic lookup via the descriptor
protocol, __getattr__ or __getattribute__. Optionally, only return members
that satisfy a given predicate.
.. note::
:func:`getmembers_static` may not be able to retrieve all members
that getmembers can fetch (like dynamically created attributes)
and may find members that getmembers can't (like descriptors
that raise AttributeError). It can also return descriptor objects
instead of instance members in some cases.
.. versionadded:: 3.11
.. function:: getmodulename(path)
Return the name of the module named by the file *path*, without including the

View File

@ -207,6 +207,13 @@ fractions
(Contributed by Mark Dickinson in :issue:`44547`.)
inspect
-------
* Add :func:`inspect.getmembers_static`: return all members without
triggering dynamic lookup via the descriptor protocol. (Contributed by
Weipeng Hong in :issue:`30533`.)
math
----
* Add :func:`math.exp2`: return 2 raised to the power of x.