#16832: s/integer/object/ in docs/docstring, and add whatsnew entry.

diff --git a/Doc/library/abc.rst b/Doc/library/abc.rst
index 7853d31b55a1f47ed63547bce7ce6482a305fd8a..7a73704bf682f8e8cafee1af6f00177c041b9997 100644 (file)
--- 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 d4f92aacc86700df4a0278399d3dee19dc21eb1f..9f8583d4d3ccb981ff2da0a4bf0cc42427f22613 100644 (file)
--- 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 264c60c428b4d14ff95170a44917a81801aeba73..0358a4696d3fa83622912258811883404990b74b 100644 (file)
--- 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