This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: weakref.finalize documentation refers to old interpreter shutdown behavior
Type: Stage:
Components: Documentation Versions: Python 3.8, Python 3.7
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: cheryl.sabella, docs@python, josh.r, pitrou
Priority: normal Keywords:

Created on 2015-10-08 02:20 by josh.r, last changed 2022-04-11 14:58 by admin.

Messages (2)
msg252504 - (view) Author: Josh Rosenberg (josh.r) * (Python triager) Date: 2015-10-08 02:20
In weakref.finalize's documentation ( https://docs.python.org/3/library/weakref.html#weakref.finalize ), it says:

"A finalizer will never invoke its callback during the later part of the interpreter shutdown when module globals are liable to have been replaced by None."

While it may not invoke its callback during shutdown (I don't know if it does, or if it should), as of Python 3.4 (which is when weakref.finalize was introduced), module globals aren't set to None anymore, right? https://docs.python.org/3/whatsnew/3.4.html#whatsnew-pep-442

Presumably the docs should be updated not to mention a behavior that no longer occurs (and if it will or should be invoked, weakref.finalizer should have documentation or code updated).
msg336580 - (view) Author: Cheryl Sabella (cheryl.sabella) * (Python committer) Date: 2019-02-25 23:42
Adding @pitrou to the nosylist as he implemented PEP442 in issue 18112.  If he agrees with the proposed change, then I believe this can be marked as 'easy'.
History
Date User Action Args
2022-04-11 14:58:22adminsetgithub: 69524
2019-02-25 23:42:27cheryl.sabellasetnosy: + cheryl.sabella, pitrou

messages: + msg336580
versions: + Python 3.7, Python 3.8, - Python 3.4, Python 3.5, Python 3.6
2015-10-08 02:20:40josh.rcreate