mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-23 09:19:18 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

bpo-45353: Remind sys.modules users to copy when iterating. (GH-28842)

Browse source 
This is true of all dictionaries in Python, but this one tends to
catch people off guard as they don't realize when sys.modules might
change out from underneath them as a hidden side effect of their
code.  Copying it first avoids the RuntimeError.  An example when
this happens in single threaded code are codecs being loaded which
are an implicit time of use import that most need not think about.
This commit is contained in:
Gregory P. Smith 2021-10-09 12:34:13 -07:00 • committed by GitHub
parent 5b4a7675bc
commit 3d1ca867ed
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

6
Doc/library/sys.rst
View file

@ -1073,7 +1073,11 @@ always available.
This is a dictionary that maps module names to modules which have already been
loaded. This can be manipulated to force reloading of modules and other tricks.
However, replacing the dictionary will not necessarily work as expected and
deleting essential items from the dictionary may cause Python to fail.
deleting essential items from the dictionary may cause Python to fail. If
you want to iterate over this global dictionary always use
``sys.modules.copy()`` or ``tuple(sys.modules)`` to avoid exceptions as its
size may change during iteration as a side effect of code or activity in
other threads.
.. data:: orig_argv