Документация Python неофициальный перевод

atexit.md

86 строк · 6.7 КБ · обычная страница · сырой текст · скачать

1> **Источник:** https://python-all.ru/3.2/library/atexit.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 27.8. [`atexit`](https://python-all.ru/3.2/library/atexit.html#module-atexit) – Обработчики завершения89Модуль [`atexit`](https://python-all.ru/3.2/library/atexit.html#module-atexit) определяет функции для регистрации и отмены регистрации функций очистки. Зарегистрированные таким образом функции автоматически выполняются при нормальном завершении интерпретатора. Порядок вызова функций не определён; если операции очистки зависят друг от друга, их следует обернуть в функцию и зарегистрировать её. Это сохраняет простоту [`atexit`](https://python-all.ru/3.2/library/atexit.html#module-atexit).1011Примечание: функции, зарегистрированные через этот модуль, не вызываются, когда программа завершается по сигналу, не обрабатываемому Python, когда обнаружена фатальная внутренняя ошибка Python, или когда вызывается [`os._exit()`](https://python-all.ru/3.2/library/os.html#os._exit).1213#### `atexit.register(func, *args, **kargs)`1415Регистрирует *func* как функцию, которая будет выполнена при завершении. Любые необязательные аргументы, которые должны быть переданы *func*, необходимо передать в качестве аргументов в [`register()`](https://python-all.ru/3.2/library/atexit.html#atexit.register). Можно зарегистрировать одну и ту же функцию и аргументы несколько раз.1617При нормальном завершении программы (например, если вызывается [`sys.exit()`](https://python-all.ru/3.2/library/sys.html#sys.exit) или завершается выполнение главного модуля) все зарегистрированные функции вызываются в порядке «последним пришёл – первым обслужен». Предполагается, что модули нижнего уровня обычно импортируются раньше модулей верхнего уровня и, следовательно, должны очищаться позже.1819Если во время выполнения обработчиков завершения возникает исключение, выводится трассировка (если только не было возбуждено [`SystemExit`](https://python-all.ru/3.2/library/exceptions.html#SystemExit)), а информация об исключении сохраняется. После того как все обработчики завершения отработают, последнее возникшее исключение возбуждается повторно.2021Эта функция возвращает *func*, что позволяет использовать её как декоратор.2223#### `atexit.unregister(func)`2425Удаляет *func* из списка функций, выполняемых при завершении интерпретатора. После вызова [`unregister()`](https://python-all.ru/3.2/library/atexit.html#atexit.unregister) гарантируется, что *func* не будет вызвана при завершении интерпретатора, даже если она была зарегистрирована несколько раз. [`unregister()`](https://python-all.ru/3.2/library/atexit.html#atexit.unregister) безмолвно ничего не делает, если *func* не была зарегистрирована ранее.2627> **См. также**28>29> **Модуль [`readline`](https://python-all.ru/3.2/library/readline.html#module-readline)**30>31> Полезный пример использования32>33> [`atexit`](https://python-all.ru/3.2/library/atexit.html#module-atexit)34>35> для чтения и записи файлов истории36>37> [`readline`](https://python-all.ru/3.2/library/readline.html#module-readline)38>39> .4041## 27.8.1. [`atexit`](https://python-all.ru/3.2/library/atexit.html#module-atexit) Пример4243Следующий простой пример демонстрирует, как модуль может инициализировать счётчик из файла при импорте и автоматически сохранять обновлённое значение счётчика при завершении программы, не полагаясь на явный вызов этого модуля приложением при завершении.4445```python46try:47    _count = int(open("counter").read())48except IOError:49    _count = 05051def incrcounter(n):52    global _count53    _count = _count + n5455def savecounter():56    open("counter", "w").write("%d" % _count)5758import atexit59atexit.register(savecounter)60```6162Позиционные и именованные аргументы также могут быть переданы в [`register()`](https://python-all.ru/3.2/library/atexit.html#atexit.register) для последующей передачи зарегистрированной функции при её вызове:6364```python65def goodbye(name, adjective):66    print('Goodbye, %s, it was %s to meet you.' % (name, adjective))6768import atexit69atexit.register(goodbye, 'Donny', 'nice')7071# или:72atexit.register(goodbye, adjective='nice', name='Donny')73```7475Использование в качестве [*декоратора*](https://python-all.ru/3.2/glossary.html#term-decorator):7677```python78import atexit7980@atexit.register81def goodbye():82    print("You are now leaving the Python sector.")83```8485Это работает только с функциями, которые можно вызывать без аргументов.86