summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorYury Selivanov <yselivanov@sprymix.com>2014-04-08 16:03:07 (GMT)
committerYury Selivanov <yselivanov@sprymix.com>2014-04-08 16:03:07 (GMT)
commitd3f918ca44f98683a8d0394a3610452303ceb3fd (patch)
treef0ed71397fbf916ad8157b1242e89d5924d3d7fb
parent0fceaf45e2f6695685785e18852902740210a128 (diff)
downloadcpython-d3f918ca44f98683a8d0394a3610452303ceb3fd.zip
cpython-d3f918ca44f98683a8d0394a3610452303ceb3fd.tar.gz
cpython-d3f918ca44f98683a8d0394a3610452303ceb3fd.tar.bz2
docs: Document __objclass__. Closes #19281.
Initial patch by Nick Coghlan
-rw-r--r--Doc/reference/datamodel.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index 8204dc3..a78b222 100644
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -1467,6 +1467,14 @@ class' :attr:`__dict__`.
Called to delete the attribute on an instance *instance* of the owner class.
+The :attr:`__objclass__` is interpreted by the :mod:`inspect` module as
+specifying the class where this object was defined (setting this appropriately
+can assist in runtime introspection of dynamic class attributes). For callables,
+it may indicate that an instance of the given type (or a subclass) is expected
+or required as the first positional argument (for example, CPython sets this
+attribute for unbound methods that are implemented in C).
+
+
.. _descriptor-invocation:
Invoking Descriptors