]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.13] gh-142119: Clarify that one `contextvars.Token` can only reset once in a lifet...
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Tue, 27 Jan 2026 10:39:20 +0000 (11:39 +0100)
committerGitHub <noreply@github.com>
Tue, 27 Jan 2026 10:39:20 +0000 (11:39 +0100)
(cherry picked from commit 487bd2dea538e36cb620dd9e0f298d731b9ede8a)

Co-authored-by: Bartosz Sławecki <bartosz@ilikepython.com>
Doc/library/contextvars.rst

index 2b1fb9fdd29cd88993398586aa5415acf7127c91..c34f439282eb7f9654361c04a3f807a8922d1aed 100644 (file)
@@ -93,13 +93,15 @@ Context Variables
           # After the reset call the var has no value again, so
           # var.get() would raise a LookupError.
 
+      The same *token* cannot be used twice.
+
 
 .. class:: Token
 
    *Token* objects are returned by the :meth:`ContextVar.set` method.
    They can be passed to the :meth:`ContextVar.reset` method to revert
    the value of the variable to what it was before the corresponding
-   *set*.
+   *set*. A single token cannot reset a context variable more than once.
 
    .. attribute:: Token.var