From 3edcc7832e04691bc6309915201e4461a18a0eb0 Mon Sep 17 00:00:00 2001 From: R David Murray Date: Tue, 24 Dec 2013 16:13:32 -0500 Subject: [PATCH] #16832: s/integer/object/ in docs/docstring, and add whatsnew entry. --- Doc/library/abc.rst | 6 +++--- Doc/whatsnew/3.4.rst | 6 ++++++ Lib/abc.py | 6 +++--- 3 files changed, 12 insertions(+), 6 deletions(-) diff --git a/Doc/library/abc.rst b/Doc/library/abc.rst index 7853d31b55a..7a73704bf68 100644 --- a/Doc/library/abc.rst +++ b/Doc/library/abc.rst @@ -318,9 +318,9 @@ The :mod:`abc` module also provides the following functions: 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. + The token is an opaque object (that supports equality testing) identifying + the current version of the abstract base class cache for virtual subclasses. + The token changes with every call to :meth:`ABCMeta.register` on any ABC. .. versionadded:: 3.4 diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst index d4f92aacc86..9f8583d4d3c 100644 --- a/Doc/whatsnew/3.4.rst +++ b/Doc/whatsnew/3.4.rst @@ -473,6 +473,12 @@ trace memory blocks allocated by Python. It provides the following information: Improved Modules ================ +abc +--- + +New function :func:`abc.get_cache_token` can be used to know when to invalidate +caches that are affected by changes in the object graph. (Contributed +by Łukasz Langa in :issue:`16832`.) aifc ---- diff --git a/Lib/abc.py b/Lib/abc.py index 264c60c428b..0358a4696d3 100644 --- a/Lib/abc.py +++ b/Lib/abc.py @@ -241,8 +241,8 @@ class ABC(metaclass=ABCMeta): def get_cache_token(): """Returns the current ABC cache token. - The token is an opaque integer identifying the current version of - the ABC cache for virtual subclasses. This number changes with - every call to ``register()`` on any ABC. + The token is an opaque object (supporting equality testing) identifying the + current version of the ABC cache for virtual subclasses. The token changes + with every call to ``register()`` on any ABC. """ return ABCMeta._abc_invalidation_counter