diff options
| -rw-r--r-- | Doc/library/atexit.rst | 15 | ||||
| -rw-r--r-- | Misc/NEWS | 3 |
2 files changed, 11 insertions, 7 deletions
diff --git a/Doc/library/atexit.rst b/Doc/library/atexit.rst index 3d5c014762..2e22cab1cd 100644 --- a/Doc/library/atexit.rst +++ b/Doc/library/atexit.rst @@ -9,13 +9,14 @@ The :mod:`atexit` module defines functions to register and unregister cleanup functions. Functions thus registered are automatically executed upon normal -interpreter termination. The order in which the functions are called is not -defined; if you have cleanup operations that depend on each other, you should -wrap them in a function and register that one. This keeps :mod:`atexit` simple. - -Note: the functions registered via this module are not called when the program -is killed by a signal not handled by Python, when a Python fatal internal error -is detected, or when :func:`os._exit` is called. +interpreter termination. :mod:`atexit` runs these functions in the *reverse* +order in which they were registered; if you register ``A``, ``B``, and ``C``, +at interpreter termination time they will be run in the order ``C``, ``B``, +``A``. + +**Note:** The functions registered via this module are not called when the +program is killed by a signal not handled by Python, when a Python fatal +internal error is detected, or when :func:`os._exit` is called. .. function:: register(func, *args, **kargs) @@ -35,6 +35,9 @@ Core and Builtins Library ------- +- Issue #15233: Python now guarantees that callables registered with + the atexit module will be called in a deterministic order. + - Issue #15238: shutil.copystat now copies Linux "extended attributes". - Issue #15230: runpy.run_path now correctly sets __package__ as described |