Staging
v0.5.1
https://github.com/python/cpython
Revision 049039832da3d02592d680cebf71ab8a665a6564 authored by Antoine Pitrou on 10 June 2020, 20:37:21 UTC, committed by GitHub on 10 June 2020, 20:37:21 UTC


The doccumentation at https://docs.python.org/3.10/library/weakref.html cautions that the `WeakKeyDictionary` and `WeakValueDictionary` are susceptible to the problem of dictionary mutation during iteration.

These notes present the user with a problem that has no easy solution.

I dug into the implementation and found that fortunately, Antoine Pitrou already addressed this challenge (10 years ago!) by introducing an `_IterationGuard` context manager to the implementation, which delays mutation while an iteration is in progress.

I asked for confirmation and @pitrou agreed that these notes could be removed:
https://github.com/python/cpython/commit/c1baa601e2b558deb690edfdf334fceee3b03327GH-commitcomment-39514438.
(cherry picked from commit 1642c0ef750f96664a98cadb09301d492098d2fb)

Co-authored-by: Daniel Fortunov <asqui@users.noreply.github.com>

Automerge-Triggered-By: @pitrou
1 parent 4b378ac
History
Tip revision: 049039832da3d02592d680cebf71ab8a665a6564 authored by Antoine Pitrou on 10 June 2020, 20:37:21 UTC
[3.7] bpo-40895: Update weakref documentation to remove old warnings (GH-20687) (GH-20793)
Tip revision: 0490398
File Mode Size
internal
Python-ast.h -rw-r--r-- 21.3 KB
Python.h -rw-r--r-- 3.5 KB
abstract.h -rw-r--r-- 39.8 KB
accu.h -rw-r--r-- 1016 bytes
asdl.h -rw-r--r-- 1.2 KB
ast.h -rw-r--r-- 641 bytes
bitset.h -rw-r--r-- 810 bytes
bltinmodule.h -rw-r--r-- 264 bytes
boolobject.h -rw-r--r-- 886 bytes
bytearrayobject.h -rw-r--r-- 2.1 KB
bytes_methods.h -rw-r--r-- 3.2 KB
bytesobject.h -rw-r--r-- 8.3 KB
cellobject.h -rw-r--r-- 713 bytes
ceval.h -rw-r--r-- 8.5 KB
classobject.h -rw-r--r-- 1.6 KB
code.h -rw-r--r-- 5.9 KB
codecs.h -rw-r--r-- 6.6 KB
compile.h -rw-r--r-- 2.9 KB
complexobject.h -rw-r--r-- 1.8 KB
context.h -rw-r--r-- 2.0 KB
datetime.h -rw-r--r-- 9.6 KB
descrobject.h -rw-r--r-- 3.1 KB
dictobject.h -rw-r--r-- 7.2 KB
dtoa.h -rw-r--r-- 458 bytes
dynamic_annotations.h -rw-r--r-- 21.9 KB
enumobject.h -rw-r--r-- 253 bytes
errcode.h -rw-r--r-- 1.7 KB
eval.h -rw-r--r-- 1.2 KB
fileobject.h -rw-r--r-- 1.8 KB
fileutils.h -rw-r--r-- 4.4 KB
floatobject.h -rw-r--r-- 4.7 KB
frameobject.h -rw-r--r-- 3.2 KB
funcobject.h -rw-r--r-- 4.1 KB
genobject.h -rw-r--r-- 3.6 KB
graminit.h -rw-r--r-- 1.9 KB
grammar.h -rw-r--r-- 2.3 KB
import.h -rw-r--r-- 4.9 KB
intrcheck.h -rw-r--r-- 861 bytes
iterobject.h -rw-r--r-- 567 bytes
listobject.h -rw-r--r-- 2.9 KB
longintrepr.h -rw-r--r-- 3.7 KB
longobject.h -rw-r--r-- 8.4 KB
marshal.h -rw-r--r-- 803 bytes
memoryobject.h -rw-r--r-- 2.7 KB
metagrammar.h -rw-r--r-- 253 bytes
methodobject.h -rw-r--r-- 4.4 KB
modsupport.h -rw-r--r-- 8.4 KB
moduleobject.h -rw-r--r-- 2.2 KB
namespaceobject.h -rw-r--r-- 349 bytes
node.h -rw-r--r-- 1.1 KB
object.h -rw-r--r-- 40.9 KB
objimpl.h -rw-r--r-- 14.1 KB
odictobject.h -rw-r--r-- 1.2 KB
opcode.h -rw-r--r-- 5.0 KB
osdefs.h -rw-r--r-- 691 bytes
osmodule.h -rw-r--r-- 291 bytes
parsetok.h -rw-r--r-- 2.8 KB
patchlevel.h -rw-r--r-- 1.3 KB
pgen.h -rw-r--r-- 253 bytes
pgenheaders.h -rw-r--r-- 1.2 KB
py_curses.h -rw-r--r-- 4.0 KB
pyarena.h -rw-r--r-- 2.7 KB
pyatomic.h -rw-r--r-- 15.7 KB
pycapsule.h -rw-r--r-- 1.7 KB
pyctype.h -rw-r--r-- 1.3 KB
pydebug.h -rw-r--r-- 1.2 KB
pydtrace.d -rw-r--r-- 969 bytes
pydtrace.h -rw-r--r-- 2.2 KB
pyerrors.h -rw-r--r-- 17.0 KB
pyexpat.h -rw-r--r-- 2.4 KB
pyfpe.h -rw-r--r-- 341 bytes
pyhash.h -rw-r--r-- 4.0 KB
pylifecycle.h -rw-r--r-- 7.6 KB
pymacconfig.h -rw-r--r-- 2.9 KB
pymacro.h -rw-r--r-- 3.5 KB
pymath.h -rw-r--r-- 8.1 KB
pymem.h -rw-r--r-- 8.8 KB
pyport.h -rw-r--r-- 27.6 KB
pystate.h -rw-r--r-- 15.9 KB
pystrcmp.h -rw-r--r-- 436 bytes
pystrhex.h -rw-r--r-- 495 bytes
pystrtod.h -rw-r--r-- 1.4 KB
pythonrun.h -rw-r--r-- 6.1 KB
pythread.h -rw-r--r-- 5.2 KB
pytime.h -rw-r--r-- 8.7 KB
rangeobject.h -rw-r--r-- 629 bytes
setobject.h -rw-r--r-- 3.3 KB
sliceobject.h -rw-r--r-- 2.4 KB
structmember.h -rw-r--r-- 2.0 KB
structseq.h -rw-r--r-- 1.3 KB
symtable.h -rw-r--r-- 4.8 KB
sysmodule.h -rw-r--r-- 1.5 KB
token.h -rw-r--r-- 2.4 KB
traceback.h -rw-r--r-- 3.6 KB
tupleobject.h -rw-r--r-- 2.4 KB
typeslots.h -rw-r--r-- 2.2 KB
ucnhash.h -rw-r--r-- 1.0 KB
unicodeobject.h -rw-r--r-- 80.3 KB
warnings.h -rw-r--r-- 1.7 KB
weakrefobject.h -rw-r--r-- 2.8 KB

back to top