Fix #16832 - expose cache validity checking support in ABCMeta

This commit is contained in:
Łukasz Langa 2013-05-25 18:41:50 +02:00
parent b961955e95
commit eadd8cf507
3 changed files with 34 additions and 0 deletions

View file

@ -58,6 +58,10 @@ This module provides the following classes:
.. versionchanged:: 3.3
Returns the registered subclass, to allow usage as a class decorator.
.. versionchanged:: 3.4
To detect calls to :meth:`register`, you can use the
:func:`get_cache_token` function.
You can also override this method in an abstract base class:
.. method:: __subclasshook__(subclass)
@ -308,6 +312,19 @@ The :mod:`abc` module also provides the following decorators:
:func:`abstractmethod`, making this decorator redundant.
The :mod:`abc` module also provides the following functions:
.. function:: get_cache_token()
Returns the current abstract base class cache token.
The token is an opaque integer identifying the current version of the
abstract base class cache for virtual subclasses. This number changes
with every call to :meth:`ABCMeta.register` on any ABC.
.. versionadded:: 3.4
.. rubric:: Footnotes
.. [#] C++ programmers should note that Python's virtual base class