Yu1709$!%yuyu!$%wutu!5=126+

                
____  ___       .__                 
\   \/  /  _____|  |   ______  _  __
 \     /  /  ___/  |  /  _ \ \/ \/ /
 /     \  \___ \|  |_(  <_> )     / 
/___/\  \/____  >____/\____/ \/\_/  
      \_/     \/    @ligmakokz

Editing: atexit.rst

:mod:`!atexit` --- Exit handlers
================================

.. module:: atexit
   :synopsis: Register and execute cleanup functions.

.. moduleauthor:: Skip Montanaro <skip.montanaro@gmail.com>
.. sectionauthor:: Skip Montanaro <skip.montanaro@gmail.com>

--------------

The :mod:`atexit` module defines functions to register and unregister cleanup
functions.  Functions thus registered are automatically executed upon normal
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.

**Note:** The effect of registering or unregistering functions from within
a cleanup function is undefined.

.. versionchanged:: 3.7
    When used with C-API subinterpreters, registered functions
    are local to the interpreter they were registered in.

.. function:: register(func, *args, **kwargs)

Register *func* as a function to be executed at termination.  Any optional
   arguments that are to be passed to *func* must be passed as arguments to
   :func:`register`.  It is possible to register the same function and arguments
   more than once.

At normal program termination (for instance, if :func:`sys.exit` is called or
   the main module's execution completes), all functions registered are called in
   last in, first out order.  The assumption is that lower level modules will
   normally be imported before higher level modules and thus must be cleaned up
   later.

If an exception is raised during execution of the exit handlers, a traceback is
   printed (unless :exc:`SystemExit` is raised) and the exception information is
   saved.  After all exit handlers have had a chance to run, the last exception to
   be raised is re-raised.

This function returns *func*, which makes it possible to use it as a
   decorator.

.. warning::
       Starting new threads or calling :func:`os.fork` from a registered
       function can lead to race condition between the main Python
       runtime thread freeing thread states while internal :mod:`threading`
       routines or the new process try to use that state. This can lead to
       crashes rather than clean shutdown.

.. versionchanged:: 3.12
       Attempts to start a new thread or :func:`os.fork` a new process
       in a registered function now leads to :exc:`RuntimeError`.

.. function:: unregister(func)

Remove *func* from the list of functions to be run at interpreter shutdown.
   :func:`unregister` silently does nothing if *func* was not previously
   registered.  If *func* has been registered more than once, every occurrence
   of that function in the :mod:`atexit` call stack will be removed.  Equality
   comparisons (``==``) are used internally during unregistration, so function
   references do not need to have matching identities.

.. seealso::

Module :mod:`readline`
      Useful example of :mod:`atexit` to read and write :mod:`readline` history
      files.

.. _atexit-example:

:mod:`atexit` Example
---------------------

The following simple example demonstrates how a module can initialize a counter
from a file when it is imported and save the counter's updated value
automatically when the program terminates without relying on the application
making an explicit call into this module at termination. ::

try:
       with open('counterfile') as infile:
           _count = int(infile.read())
   except FileNotFoundError:
       _count = 0

def incrcounter(n):
       global _count
       _count = _count + n

def savecounter():
       with open('counterfile', 'w') as outfile:
           outfile.write('%d' % _count)

import atexit

atexit.register(savecounter)

Positional and keyword arguments may also be passed to :func:`register` to be
passed along to the registered function when it is called::

def goodbye(name, adjective):
       print('Goodbye %s, it was %s to meet you.' % (name, adjective))

import atexit

atexit.register(goodbye, 'Donny', 'nice')
   # or:
   atexit.register(goodbye, adjective='nice', name='Donny')

Usage as a :term:`decorator`::

import atexit

@atexit.register
   def goodbye():
       print('You are now leaving the Python sector.')

This only works with functions that can be called without arguments.

Name	Type	Actions
2to3.rst	File
__future__.rst	File
__main__.rst	File
_thread.rst	File
abc.rst	File
aifc.rst	File
allos.rst	File
archiving.rst	File
argparse.rst	File
array.rst	File
ast.rst	File
asyncio-api-index.rst	File
asyncio-dev.rst	File
asyncio-eventloop.rst	File
asyncio-exceptions.rst	File
asyncio-extending.rst	File
asyncio-future.rst	File
asyncio-llapi-index.rst	File
asyncio-platforms.rst	File
asyncio-policy.rst	File
asyncio-protocol.rst	File
asyncio-queue.rst	File
asyncio-runner.rst	File
asyncio-stream.rst	File
asyncio-subprocess.rst	File
asyncio-sync.rst	File
asyncio-task.rst	File
asyncio.rst	File
atexit.rst	File
audioop.rst	File
audit_events.rst	File
base64.rst	File
bdb.rst	File
binary.rst	File
binascii.rst	File
bisect.rst	File
builtins.rst	File
bz2.rst	File
calendar.rst	File
cgi.rst	File
cgitb.rst	File
chunk.rst	File
cmath.rst	File
cmd.rst	File
cmdline.rst	File
code.rst	File
codecs.rst	File
codeop.rst	File
collections.abc.rst	File
collections.rst	File
colorsys.rst	File
compileall.rst	File
concurrency.rst	File
concurrent.futures.rst	File
concurrent.rst	File
configparser.rst	File
constants.rst	File
contextlib.rst	File
contextvars.rst	File
copy.rst	File
copyreg.rst	File
crypt.rst	File
crypto.rst	File
csv.rst	File
ctypes.rst	File
curses.ascii.rst	File
curses.panel.rst	File
curses.rst	File
custominterp.rst	File
dataclasses.rst	File
datatypes.rst	File
datetime.rst	File
dbm.rst	File
debug.rst	File
decimal.rst	File
development.rst	File
devmode.rst	File
dialog.rst	File
difflib.rst	File
dis.rst	File
distribution.rst	File
doctest.rst	File
email.charset.rst	File
email.compat32-message.rst	File
email.contentmanager.rst	File
email.encoders.rst	File
email.errors.rst	File
email.examples.rst	File
email.generator.rst	File
email.header.rst	File
email.headerregistry.rst	File
email.iterators.rst	File
email.message.rst	File
email.mime.rst	File
email.parser.rst	File
email.policy.rst	File
email.rst	File
email.utils.rst	File
ensurepip.rst	File
enum.rst	File
errno.rst	File
exceptions.rst	File
faulthandler.rst	File
fcntl.rst	File
filecmp.rst	File
fileformats.rst	File
fileinput.rst	File
filesys.rst	File
fnmatch.rst	File
fractions.rst	File
frameworks.rst	File
ftplib.rst	File
functional.rst	File
functions.rst	File
functools.rst	File
gc.rst	File
getopt.rst	File
getpass.rst	File
gettext.rst	File
glob.rst	File
graphlib.rst	File
grp.rst	File
gzip.rst	File
hashlib-blake2-tree.png	File
hashlib.rst	File
heapq.rst	File
hmac.rst	File
html.entities.rst	File
html.parser.rst	File
html.rst	File
http.client.rst	File
http.cookiejar.rst	File
http.cookies.rst	File
http.rst	File
http.server.rst	File
i18n.rst	File
idle.rst	File
imaplib.rst	File
imghdr.rst	File
importlib.metadata.rst	File
importlib.resources.abc.rst	File
importlib.resources.rst	File
importlib.rst	File
index.rst	File
inspect.rst	File
internet.rst	File
intro.rst	File
io.rst	File
ipaddress.rst	File
ipc.rst	File
itertools.rst	File
json.rst	File
kde_example.png	File
keyword.rst	File
language.rst	File
linecache.rst	File
locale.rst	File
logging.config.rst	File
logging.handlers.rst	File
logging.rst	File
lzma.rst	File
mailbox.rst	File
mailcap.rst	File
markup.rst	File
marshal.rst	File
math.rst	File
mimetypes.rst	File
mm.rst	File
mmap.rst	File
modulefinder.rst	File
modules.rst	File
msilib.rst	File
msvcrt.rst	File
multiprocessing.rst	File
multiprocessing.shared_memory.rst	File
netdata.rst	File
netrc.rst	File
nis.rst	File
nntplib.rst	File
numbers.rst	File
numeric.rst	File
operator.rst	File
optparse.rst	File
os.path.rst	File
os.rst	File
ossaudiodev.rst	File
pathlib-inheritance.png	File
pathlib-inheritance.svg	File
pathlib.rst	File
pdb.rst	File
persistence.rst	File
pickle.rst	File
pickletools.rst	File
pipes.rst	File
pkgutil.rst	File
platform.rst	File
plistlib.rst	File
poplib.rst	File
posix.rst	File
pprint.rst	File
profile.rst	File
pty.rst	File
pwd.rst	File
py_compile.rst	File
pyclbr.rst	File
pydoc.rst	File
pyexpat.rst	File
python.rst	File
queue.rst	File
quopri.rst	File
random.rst	File
re.rst	File
readline.rst	File
reprlib.rst	File
resource.rst	File
rlcompleter.rst	File
runpy.rst	File
sched.rst	File
secrets.rst	File
security_warnings.rst	File
select.rst	File
selectors.rst	File
shelve.rst	File
shlex.rst	File
shutil.rst	File
signal.rst	File
site.rst	File
smtplib.rst	File
sndhdr.rst	File
socket.rst	File
socketserver.rst	File
spwd.rst	File
sqlite3.rst	File
ssl.rst	File
stat.rst	File
statistics.rst	File
stdtypes.rst	File
string.rst	File
stringprep.rst	File
struct.rst	File
subprocess.rst	File
sunau.rst	File
superseded.rst	File
symtable.rst	File
sys.monitoring.rst	File
sys.rst	File
sys_path_init.rst	File
sysconfig.rst	File
syslog.rst	File
tabnanny.rst	File
tarfile.rst	File
telnetlib.rst	File
tempfile.rst	File
termios.rst	File
test.rst	File
text.rst	File
textwrap.rst	File
threading.rst	File
time.rst	File
timeit.rst	File
tk.rst	File
tk_msg.png	File
tkinter.colorchooser.rst	File
tkinter.dnd.rst	File
tkinter.font.rst	File
tkinter.messagebox.rst	File
tkinter.rst	File
tkinter.scrolledtext.rst	File
tkinter.tix.rst	File
tkinter.ttk.rst	File
token-list.inc	File
token.rst	File
tokenize.rst	File
tomllib.rst	File
trace.rst	File
traceback.rst	File
tracemalloc.rst	File
tty.rst	File
tulip_coro.dia	File
tulip_coro.png	File
turtle-star.pdf	File
turtle-star.png	File
turtle-star.ps	File
turtle.rst	File
types.rst	File
typing.rst	File
unicodedata.rst	File
unittest.mock-examples.rst	File
unittest.mock.rst	File
unittest.rst	File
unix.rst	File
urllib.error.rst	File
urllib.parse.rst	File
urllib.request.rst	File
urllib.robotparser.rst	File
urllib.rst	File
uu.rst	File
uuid.rst	File
venv.rst	File
warnings.rst	File
wave.rst	File
weakref.rst	File
webbrowser.rst	File
windows.rst	File
winreg.rst	File
winsound.rst	File
wsgiref.rst	File
xdrlib.rst	File
xml.dom.minidom.rst	File
xml.dom.pulldom.rst	File
xml.dom.rst	File
xml.etree.elementtree.rst	File
xml.rst	File
xml.sax.handler.rst	File
xml.sax.reader.rst	File
xml.sax.rst	File
xml.sax.utils.rst	File
xmlrpc.client.rst	File
xmlrpc.rst	File
xmlrpc.server.rst	File
zipapp.rst	File
zipfile.rst	File
zipimport.rst	File
zlib.rst	File
zoneinfo.rst	File