29.8. atexit – обработчики завершения¶atexit – Exit handlers

Модуль atexit определяет функции для регистрации и отмены регистрации функций очистки. Зарегистрированные таким образом функции автоматически выполняются при нормальном завершении интерпретатора. atexit запускает эти функции в обратном порядке относительно того, в котором они были зарегистрированы; если зарегистрировать A, B и C, то при завершении интерпретатора они будут выполнены в порядке C, B, A.

Примечание: Функции, зарегистрированные через этот модуль, не вызываются, когда программа уничтожается сигналом, не обрабатываемым Python, когда обнаружена фатальная внутренняя ошибка Python, или когда вызывается os._exit().

atexit.register(func, *args, **kargs)¶

Регистрирует func как функцию, которая будет выполнена при завершении. Любые необязательные аргументы, которые должны быть переданы func, необходимо передать в качестве аргументов в register(). Можно зарегистрировать одну и ту же функцию и аргументы несколько раз.

При нормальном завершении программы (например, если вызывается sys.exit() или завершается выполнение главного модуля) все зарегистрированные функции вызываются в порядке «последним пришёл – первым обслужен». Предполагается, что модули нижнего уровня обычно импортируются раньше модулей верхнего уровня и, следовательно, должны очищаться позже.

Если во время выполнения обработчиков завершения возникает исключение, выводится трассировка (если только не было возбуждено SystemExit), а информация об исключении сохраняется. После того как все обработчики завершения отработают, последнее возникшее исключение возбуждается повторно.

Эта функция возвращает func, что позволяет использовать её как декоратор.

atexit.unregister(func)¶

Удаляет func из списка функций, выполняемых при завершении интерпретатора. После вызова unregister() гарантируется, что func не будет вызвана при завершении интерпретатора, даже если она была зарегистрирована несколько раз. unregister() безмолвно ничего не делает, если func не была зарегистрирована ранее.

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)

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

import atexit
atexit.register(goodbye, 'Donny', 'nice')

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

import atexit

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