Встроенные исключения

Контекст исключения

Три атрибута объектов исключения предоставляют информацию о контексте, в котором было поднято исключение:

BaseException.__context__

BaseException.__cause__

BaseException.__suppress_context__

При поднятии нового исключения, в то время как другое исключение уже обрабатывается, атрибут __context__ нового исключения автоматически устанавливается на обрабатываемое исключение. Обработка исключения может происходить, когда используется клауза except или finally, или оператор with.

Этот неявный контекст исключения может быть дополнен явной причиной, используя from с raise:

raise new_exc from original_exc

Выражение, следующее за from, должно быть исключением или None. Оно будет установлено как __cause__ для поднятого исключения. Установка __cause__ также неявным образом устанавливает атрибут __suppress_context__ в True, так что использование raise new_exc from None эффективно заменяет старое исключение новым для отображения (например, конвертирование KeyError в AttributeError), оставив старое исключение доступным в __context__ для интроспекции при отладке.

Стандартный код отображения трассировки показывает эти цепочные исключения в дополнение к трассировке самого исключения. Явно цепочное исключение в __cause__ всегда отображается при наличии. Неявно цепочное исключение в __context__ отображается только если __cause__ равно None и __suppress_context__ ложно.

В любом случае, само исключение всегда отображается после любых цепочных исключений, так что последняя строка трассировки всегда показывает последнее поднятое исключение.

Наследование от встроенных исключений

Пользовательский код может создавать подклассы, наследующие от типа исключения. Рекомендуется наследовать только от одного типа исключения за раз, чтобы избежать возможных конфликтов в том, как базовые классы обрабатывают атрибут args, а также из-за возможных несовместимостей с расположением памяти.

Базовые классы

Следующие исключения в основном используются в качестве базовых классов для других исключений.

exception BaseException

Базовый класс для всех встроенных исключений. Он не предназначен для прямого наследования пользовательскими классами (для этого используйте Exception). Если str() вызывается на экземпляре этого класса, возвращается представление аргумента(ов) экземпляра или пустая строка, если аргументов не было.

args

Кортеж аргументов, переданных конструктору исключения. Некоторые встроенные исключения (например, OSError) ожидают определённого количества аргументов и присваивают специальное значение элементам этого кортежа, в то время как другие обычно вызываются только с одной строкой, содержащей сообщение об ошибке.

with_traceback(tb)

Этот метод устанавливает tb в качестве новой трассировки для исключения и возвращает объект исключения. Он был более распространённым до того, как функции цепочек исключений из PEP 3134 стали доступны. Следующий пример показывает, как мы можем преобразовать экземпляр SomeException в экземпляр OtherException, сохраняя при этом трассировку. После поднятия текущий фрейм добавляется в трассировку OtherException, как бы это произошло с трассировкой исходного SomeException если бы мы позволили ей распространиться на вызывающую сторону.

try:
    ...
except SomeException:
    tb = sys.exception().__traceback__
    raise OtherException(...).with_traceback(tb)

__traceback__

Записываемое поле, которое содержит объект трассировки, связанный с этим исключением. См. также: Оператор raise.

add_note(note)

Добавьте строку note в заметки исключения, которые появляются в стандартной трассировке после строки исключения. Если note не является строкой, поднимается TypeError.

Добавлен в версии 3.11.

__notes__

Список заметок этого исключения, которые были добавлены с помощью add_note(). Этот атрибут создаётся при вызове add_note().

Добавлен в версии 3.11.

exception Exception

Все встроенные исключения, не связанные с выходом из системы, происходят от этого класса. Все определяемые пользователем исключения также должны происходить от этого класса.

exception ArithmeticError

Базовый класс для тех встроенных исключений, которые поднимаются при различных ошибках арифметики: OverflowError, ZeroDivisionError, FloatingPointError.

exception BufferError

Поднимается, когда операция, связанная с буфером, не может быть выполнена.

exception LookupError

Базовый класс для исключений, которые поднимаются, когда ключ или индекс, используемый для отображения или последовательности, являются недопустимыми: IndexError, KeyError. Это может быть поднято непосредственно codecs.lookup().

Конкретные исключения

Ниже приведены исключения, которые обычно генерируются.

exception AssertionError

Вызывается, когда терпит неудачу утверждение assert.

exception AttributeError

Вызывается, когда происходит ошибка при обращении к атрибуту (см. Обращения к атрибутам) или присваивании атрибута. (Если объект не поддерживает обращение к атрибутам или присваивание атрибутов, вызывается TypeError.)

Атрибуты name и obj можно установить, используя ключевые аргументы конструктора. Если они установлены, они представляют имя атрибута, к которому пытались получить доступ, и объект, к которому пытались получить доступ для указанного атрибута, соответственно.

Изменено в версии 3.10: Добавлены атрибуты name и obj.

exception EOFError

Вызывается, когда функция input() достигает конца файла (EOF), не прочитав никаких данных. (Примечание: методы io.IOBase.read() и io.IOBase.readline() возвращают пустую строку при достижении EOF.)

exception FloatingPointError

В настоящее время не используется.

exception GeneratorExit

Вызывается, когда генератор или корутина закрываются; см. generator.close() и coroutine.close(). Он напрямую наследуется от BaseException, а не от Exception, так как технически это не ошибка.

exception ImportError

Вызывается, когда оператор import испытывает проблемы при загрузке модуля. Также вызывается, когда в «списке from» в from ... import имя не найдено.

Дополнительные ключевые аргументы name и path устанавливают соответствующие атрибуты:

name

Имя модуля, который пытались импортировать.

path

Путь к любому файлу, который вызвал исключение.

Изменено в версии 3.3: Добавлены атрибуты name и path.

exception ModuleNotFoundError

Подкласс ImportError, который вызывается оператором import, когда модуль не может быть найден. Также вызывается, когда None найден в sys.modules.

Добавлен в версии 3.6.

exception IndexError

Вызывается, когда индекс последовательности выходит за пределы допустимого диапазона. (Индексы срезов без предупреждений усекаются до попадания в разрешённый диапазон; если индекс не является целым числом, вызывается TypeError.)

exception KeyError

Вызывается, когда ключ отображения (словаря) не найден в наборе существующих ключей.

exception KeyboardInterrupt

Вызывается, когда пользователь нажимает клавишу прерывания (обычно Control-C или Delete). Во время выполнения регулярно проверяются прерывания. Исключение наследуется от BaseException, чтобы не быть случайно перехваченным кодом, который перехватывает Exception, и таким образом предотвратить выход интерпретатора.

Примечание

Перехват KeyboardInterrupt требует особого внимания. Поскольку он может быть вызван в непредсказуемых точках, в некоторых случаях он может оставить выполняемую программу в несогласованном состоянии. Обычно лучше всего позволить KeyboardInterrupt как можно быстрее завершить программу или вообще избежать его возникновения. (См. Примечание о обработчиках сигналов и исключениях.)

exception MemoryError

Вызывается, когда операция исчерпала память, но ситуацию все ещё можно исправить (удалив некоторые объекты). Соответствующее значение — строка, указывающая, какой вид внутренней операции исчерпал память. Обратите внимание, что из-за архитектуры управления памятью (функции malloc() C) интерпретатор не всегда сможет полностью восстановиться от этой ситуации; тем не менее, он генерирует исключение, чтобы можно было вывести трассировку стека, в случае, если причиной была программа-недотёпа.

exception NameError

Вызывается, когда локальное или глобальное имя не найдено. Это относится только к неквалифицированным именам. Соответствующее значение — сообщение об ошибке, которое включает имя, которое не удалось найти.

Атрибут name можно установить, используя ключевой аргумент конструктора. При установке он представляет собой имя переменной, к которой пытались получить доступ.

Изменено в версии 3.10: Добавлен атрибут name.

exception NotImplementedError

Это исключение происходит от RuntimeError. В пользовательских базовых классах абстрактные методы должны вызывать это исключение, когда они требуют, чтобы производные классы переопределили метод, или когда класс разрабатывается, чтобы указать, что фактическая реализация ещё не добавлена.

Примечание

Его не следует использовать для указания того, что оператор или метод вообще не должны поддерживаться — в этом случае либо оставьте оператор/метод неопределённым, либо, если это подкласс, установите его в None.

Примечание

NotImplementedError и NotImplemented не взаимозаменяемы, даже если они имеют схожие имена и цели. Подробности о том, когда его использовать, см. в NotImplemented.

exception OSError([arg])

исключение OSError(errno, strerror[, filename[, winerror[, filename2]]])

Это исключение возникает, когда системная функция возвращает системную ошибку, включая ошибки ввода-вывода, такие как «файл не найден» или «диск заполнен» (не для типов аргументов, нарушающих правила, или других случайных ошибок).

Во втором варианте конструктора устанавливаются соответствующие атрибуты, описанные ниже. Атрибуты по умолчанию равны None, если не указаны. Для обеспечения обратной совместимости, если передано три аргумента, атрибут args содержит только кортеж из двух первых аргументов конструктора.

Конструктор часто фактически возвращает подкласс OSError, как описано в разделе «Системные исключения» ниже. Конкретный подкласс зависит от конечного значения errno. Это поведение наблюдается только при прямом создании объекта OSError или через псевдоним, и не наследуется при наследовании.

errno

Числовой код ошибки из C-переменной errno.

winerror

В Windows это даёт вам собственный код ошибки Windows. Атрибут errno затем представляет собой приблизительный перевод этого кода ошибки в терминах POSIX.

В Windows, если аргумент конструктора winerror — целое число, атрибут errno определяется из кода ошибки Windows, а аргумент errno игнорируется. На других платформах аргумент winerror игнорируется, и атрибут winerror не существует.

strerror

Соответствующее сообщение об ошибке, предоставленное операционной системой. Оно форматируется функциями C perror() в POSIX и FormatMessage() в Windows.

filename

filename2

Для исключений, связанных с файловыми путями (таких как open() или os.unlink()), filename — имя файла, переданное в функцию. Для функций, использующих два файловых пути (например, os.rename()), filename2 соответствует второму имени файла, переданному в функцию.

Изменено в версии 3.3: EnvironmentError, IOError, WindowsError, socket.error, select.error и mmap.error были объединены в OSError, и конструктор может возвращать подкласс.

Изменено в версии 3.4: Атрибут filename теперь содержит исходное имя файла, переданное в функцию, вместо имени, закодированного или декодированного в кодировку/обработчик ошибок файловой системы. Также был добавлен аргумент и атрибут конструктора filename2.

exception OverflowError

Возникает, когда результат арифметической операции слишком велик для представления. Это не может произойти для целых чисел (которые вместо этого вызовут MemoryError, а не сдадутся). Однако по историческим причинам OverflowError иногда возникает для целых чисел, которые выходят за заданный диапазон. Из-за отсутствия стандартизации обработки исключений с плавающей запятой в C большинство операций с плавающей запятой не проверяются.

exception RecursionError

Это исключение наследуется от RuntimeError. Оно возникает, когда интерпретатор обнаруживает, что максимальная глубина рекурсии (см. sys.getrecursionlimit()) превышена.

Добавлена в версии 3.5: Ранее поднималось просто RuntimeError.

exception ReferenceError

Это исключение возникает, когда слабый прокси-объект, созданный функцией weakref.proxy(), используется для доступа к атрибуту объекта-ссылочного после того, как он был собран сборщиком мусора. Дополнительную информацию о слабых ссылках см. в модуле weakref.

exception RuntimeError

Возникает, когда обнаруживается ошибка, которая не попадает ни в одну из других категорий. Соответствующее значение — строка, указывающая, что именно пошло не так.

exception StopIteration

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

value

Объект исключения имеет единственный атрибут value, который передаётся как аргумент при создании исключения и по умолчанию равен None.

Когда функция-генератор или функция-корутина возвращает значение, поднимается новый экземпляр StopIteration, а значение, возвращённое функцией, используется в качестве параметра value конструктора исключения.

Если код генератора напрямую или косвенно вызывает StopIteration, он преобразуется в RuntimeError (сохраняя StopIteration в качестве причины нового исключения).

Изменено в версии 3.3: Добавлен атрибут value и возможность для функций-генераторов использовать его для возвращения значения.

Изменено в версии 3.5: Введено преобразование RuntimeError через from __future__ import generator_stop, см. PEP 479.

Изменено в версии 3.7: Включено PEP 479 по умолчанию для всего кода: ошибка StopIteration, поднятая в функции-генераторе, преобразуется в RuntimeError.

exception StopAsyncIteration

Должен возбуждаться методом __anext__() объекта асинхронного итератора для остановки итерации.

Добавлена в версии 3.5.

exception SyntaxError(message, details)

Вызывается, когда парсер обнаруживает синтаксическую ошибку. Это может произойти в инструкции import, в вызове встроенных функций compile(), exec() или eval(), или при чтении исходного скрипта или стандартного ввода (в интерактивном режиме).

Строка исключения str() возвращает только сообщение об ошибке. Детали — это кортеж, члены которого также доступны в качестве отдельных атрибутов.

filename

Имя файла, в котором произошла синтаксическая ошибка.

lineno

Номер строки в файле, в которой произошла ошибка. Нумерация с 1: первая строка в файле имеет номер lineno. 1.

offset

Столбец в строке, где произошла ошибка. Нумерация с 1: первый символ в строке имеет номер offset. 1.

text

Текст исходного кода, связанный с ошибкой.

end_lineno

Номер строки в файле, где закончилась ошибка. Нумерация с 1: первая строка в файле имеет номер lineno. 1.

end_offset

Столбец в последней строке, где закончилась ошибка. Нумерация с 1: первый символ в строке имеет номер offset. 1.

Для ошибок в полях f-строк сообщение предваряется «f-string: », а смещения — смещениями в тексте, построенном из выражения замены. Например, компиляция f’Bad {a b} field’ приводит к следующему атрибуту args: (‘f-string: …’, (‘’, 1, 2, ‘(a b)n’, 1, 5)).

Изменено в версии 3.10: Добавлены атрибуты end_lineno и end_offset.

exception IndentationError

Базовый класс синтаксических ошибок, связанных с неправильным отступом. Это подкласс SyntaxError.

exception TabError

Вызывается, когда отступ содержит несогласованное использование табуляции и пробелов. Это подкласс IndentationError.

exception SystemError

Вызывается, когда интерпретатор обнаруживает внутреннюю ошибку, но ситуация не выглядит настолько серьёзной, чтобы заставлять его терять надежду. Соответствующее значение — строка, описывающая, что пошло не так (в низкоуровневом представлении).

Вы должны сообщить об этом автору или разработчику вашей Python-интерпретатора. Убедитесь, что вы сообщили о версии Python-интерпретатора (sys.version; она также выводится в начале интерактивной Python-сессии), точном сообщении об ошибке (сопутствующее значение исключения) и, по возможности, исходном коде программы, которая вызвала ошибку.

exception SystemExit

Это исключение вызывается функцией sys.exit(). Оно наследуется от BaseException, а не от Exception, чтобы оно случайно не было перехвачено кодом, перехватывающим Exception. Это позволяет исключению правильно распространяться вверх и заставлять интерпретатор завершиться. При отсутствии обработки исключение приводит к завершению Python-интерпретатора; отладочная информация о стеке вызовов не выводится. Конструктор принимает тот же необязательный аргумент, что и sys.exit(). Если значение — целое число, оно задаёт системный код выхода (передаётся в функцию C exit()); если это None, код выхода — ноль; если это другой тип (например, строка), значение объекта выводится, а код выхода — один.

Вызов sys.exit() преобразуется в исключение, чтобы обработчики очистки (finally -блоки операторов try) могли выполняться, и чтобы отладчик мог выполнить скрипт, не рискуя потерять контроль. Функция os._exit() может использоваться, если абсолютно необходимо немедленно завершить выполнение (например, в дочернем процессе после вызова os.fork()).

code

Код выхода или сообщение об ошибке, передаваемое в конструктор. (По умолчанию None.)

exception TypeError

Вызывается, когда операция или функция применяется к объекту неподходящего типа. Соответствующее значение — строка, содержащая подробности о несоответствии типов.

Это исключение может быть вызвано пользовательским кодом, чтобы указать, что попытка операции над объектом не поддерживается и не должна поддерживаться. Если объект должен поддерживать данную операцию, но ещё не предоставил реализацию, следует использовать исключение NotImplementedError.

Передача аргументов неверного типа (например, передача list вместо ожидаемого int) должно приводить к TypeError, но передача аргументов с неверным значением (например, число вне ожидаемых границ) должна приводить к ValueError.

exception UnboundLocalError

Вызывается, когда ссылка делается на локальную переменную в функции или методе, но этой переменной не было присвоено значение. Это подкласс NameError.

exception UnicodeError

Вызывается при возникновении ошибки кодирования или декодирования, связанной с Unicode. Это подкласс ValueError.

UnicodeError имеет атрибуты, описывающие ошибку кодирования или декодирования. Например, err.object[err.start:err.end] указывает конкретный недействительный ввод, с которым не справился кодек.

encoding

Имя кодировки, вызвавшей ошибку.

reason

Строка, описывающая конкретную ошибку кодека.

object

Объект, который кодек пытался закодировать или декодировать.

start

Первый индекс недействительных данных в object.

end

Индекс после последнего недействительного данных в object.

exception UnicodeEncodeError

Вызывается при возникновении ошибки Unicode при кодировании. Это подкласс UnicodeError.

exception UnicodeDecodeError

Вызывается при возникновении ошибки Unicode при декодировании. Это подкласс UnicodeError.

exception UnicodeTranslateError

Вызывается при возникновении ошибки Unicode при преобразовании. Это подкласс UnicodeError.

exception ValueError

Вызывается, когда операция или функция получает аргумент правильного типа, но неподходящего значения, и ситуация не описывается более точным исключением, таким как IndexError.

exception ZeroDivisionError

Вызывается, когда второй аргумент операции деления или взятия остатка равен нулю. Соответствующее значение — строка, описывающая тип операндов и операцию.

Следующие исключения сохраняются для совместимости с предыдущими версиями; начиная с Python 3.3, они являются псевдонимами OSError.

exception EnvironmentError

exception IOError

exception WindowsError

Доступно только в Windows.

Предупреждения

Следующие исключения используются в качестве категорий предупреждений; см. документацию Категории предупреждений для получения более подробной информации.

exception Warning

Базовый класс для категорий предупреждений.

exception UserWarning

Базовый класс для предупреждений, генерируемых кодом пользователя.

exception DeprecationWarning

Базовый класс для предупреждений о устаревших функциях, когда эти предупреждения предназначены для других разработчиков Python.

Игнорируется стандартными фильтрами предупреждений, за исключением модуля __main__ (PEP 565). Включение Режим разработки Python отображает это предупреждение.

Политика устаревания описана в PEP 387.

exception PendingDeprecationWarning

Базовый класс для предупреждений о функциях, которые устарели и ожидается, что они будут устаревшими в будущем, но на данный момент не устарели.

Этот класс используется редко, поскольку выдача предупреждения о возможном будущем устаревании не является обычной практикой, и предпочтительно использовать DeprecationWarning для уже активных устареваний.

Игнорируется стандартными фильтрами предупреждений. Включение Режим разработки Python отображает это предупреждение.

Политика устаревания описана в PEP 387.

exception SyntaxWarning

Базовый класс для предупреждений о сомнительном синтаксисе.

exception RuntimeWarning

Базовый класс для предупреждений о сомнительном поведении во время выполнения.

exception FutureWarning

Базовый класс для предупреждений об устаревших функциях, когда эти предупреждения предназначены для конечных пользователей приложений, написанных на Python.

exception ImportWarning

Базовый класс для предупреждений о вероятных ошибках в импорте модулей.

Игнорируется стандартными фильтрами предупреждений. Включение Режим разработки Python отображает это предупреждение.

exception UnicodeWarning

Базовый класс для предупреждений, связанных с Unicode.

exception EncodingWarning

Базовый класс для предупреждений, связанных с кодировками.

См. Включение предупреждения EncodingWarning для получения подробной информации.

Добавлена в версии 3.10.

exception BytesWarning

Базовый класс для предупреждений, связанных с bytes и bytearray.

exception ResourceWarning

Базовый класс для предупреждений, связанных с использованием ресурсов.

Игнорируется стандартными фильтрами предупреждений. Включение Режим разработки Python отображает это предупреждение.

Добавлена в версии 3.2.

Группы исключений

Следующие типы используются, когда необходимо поднять несколько не связанных исключений. Они являются частью иерархии исключений, поэтому их можно обработать с помощью except, как и любые другие исключения. Кроме того, они распознаются except*, который сопоставляет их подгруппы на основе типов содержащихся исключений.

exception ExceptionGroup(msg, excs)

exception BaseExceptionGroup(msg, excs)

Оба этих типа исключений оборачивают исключения в последовательности excs. Параметр msg должен быть строкой. Разница между двумя классами заключается в том, что BaseExceptionGroup расширяет BaseException и может оборачивать любое исключение, в то время как ExceptionGroup расширяет Exception и может оборачивать только подклассы Exception. Такое проектирование позволяет обработчику except Exception перехватывать ExceptionGroup, но не BaseExceptionGroup.

Конструктор BaseExceptionGroup возвращает ExceptionGroup, а не BaseExceptionGroup, если все содержащиеся исключения являются экземплярами Exception, что позволяет автоматизировать выбор. Конструктор ExceptionGroup, с другой стороны, генерирует TypeError, если какое-либо из содержащихся исключений не является подклассом Exception.

message

Аргумент msg конструктора. Это атрибут только для чтения.

exceptions

Кортеж исключений из последовательности excs, переданной в конструктор. Это атрибут только для чтения.

subgroup(condition)

Возвращает группу исключений, содержащую только те исключения из текущей группы, которые соответствуют condition, или None если результат пустой.

Условие может быть функцией, принимающей исключение и возвращающей true для тех, которые должны быть в подгруппе, или типом исключения или кортежем типов исключений, используемым для проверки соответствия по тому же алгоритму, что и в except блоке.

Структура вложенности текущего исключения сохраняется в результате, как и значения его message, __traceback__, __cause__, __context__ и __notes__ полей. Пустые вложенные группы исключаются из результата.

Условие проверяется для всех исключений в вложенной группе исключений, включая верхний уровень и любые вложенные группы исключений. Если условие истинно для такой группы исключений, оно включается в результат полностью.

split(condition)

Подобно subgroup(), но возвращает пару (match, rest), где match — результат, соответствующий условию, и rest — оставшаяся несоответствующая часть.

derive(excs)

Возвращает группу исключений с тем же message, но оборачивающим исключения в excs.

Этот метод используется subgroup() и split(), которые используются в различных контекстах для разделения группы исключений. Подклассу необходимо переопределить его, чтобы subgroup() и split() возвращали экземпляры подкласса, а не ExceptionGroup.

subgroup() и split() копируют __traceback__, __cause__, __context__ и __notes__ поля из исходной группы исключений в возвращаемую derive(), поэтому эти поля не требуют обновления derive().

>>> class MyGroup(ExceptionGroup):
...     def derive(self, excs):
...         return MyGroup(self.message, excs)
...
>>> e = MyGroup("eg", [ValueError(1), TypeError(2)])
>>> e.add_note("a note")
>>> e.__context__ = Exception("context")
>>> e.__cause__ = Exception("cause")
>>> try:
...    raise e
... except Exception as e:
...    exc = e
...
>>> match, rest = exc.split(ValueError)
>>> exc, exc.__context__, exc.__cause__, exc.__notes__
(MyGroup('eg', [ValueError(1), TypeError(2)]), Exception('context'), Exception('cause'), ['a note'])
>>> match, match.__context__, match.__cause__, match.__notes__
(MyGroup('eg', [ValueError(1)]), Exception('context'), Exception('cause'), ['a note'])
>>> rest, rest.__context__, rest.__cause__, rest.__notes__
(MyGroup('eg', [TypeError(2)]), Exception('context'), Exception('cause'), ['a note'])
>>> exc.__traceback__ is match.__traceback__ is rest.__traceback__
True

Обратите внимание, что BaseExceptionGroup определяет __new__(), поэтому подклассы, которым требуется другая сигнатура конструктора, должны переопределять её, а не __init__(). Например, следующее определяет подкласс группы исключений, принимающий exit_code и создающий сообщение группы на его основе.

class Errors(ExceptionGroup):
   def __new__(cls, errors, exit_code):
      self = super().__new__(Errors, f"exit code: {exit_code}", errors)
      self.exit_code = exit_code
      return self

   def derive(self, excs):
      return Errors(excs, self.exit_code)

Подобно ExceptionGroup, любой подкласс BaseExceptionGroup, являющийся также подклассом Exception, может оборачивать только экземпляры Exception.

Добавлен в версии 3.11.

Иерархия исключений

Иерархия классов для встроенных исключений:

BaseException
 ├── BaseExceptionGroup
 ├── GeneratorExit
 ├── KeyboardInterrupt
 ├── SystemExit
 └── Exception
      ├── ArithmeticError
      │    ├── FloatingPointError
      │    ├── OverflowError
      │    └── ZeroDivisionError
      ├── AssertionError
      ├── AttributeError
      ├── BufferError
      ├── EOFError
      ├── ExceptionGroup [BaseExceptionGroup]
      ├── ImportError
      │    └── ModuleNotFoundError
      ├── LookupError
      │    ├── IndexError
      │    └── KeyError
      ├── MemoryError
      ├── NameError
      │    └── UnboundLocalError
      ├── OSError
      │    ├── BlockingIOError
      │    ├── ChildProcessError
      │    ├── ConnectionError
      │    │    ├── BrokenPipeError
      │    │    ├── ConnectionAbortedError
      │    │    ├── ConnectionRefusedError
      │    │    └── ConnectionResetError
      │    ├── FileExistsError
      │    ├── FileNotFoundError
      │    ├── InterruptedError
      │    ├── IsADirectoryError
      │    ├── NotADirectoryError
      │    ├── PermissionError
      │    ├── ProcessLookupError
      │    └── TimeoutError
      ├── ReferenceError
      ├── RuntimeError
      │    ├── NotImplementedError
      │    └── RecursionError
      ├── StopAsyncIteration
      ├── StopIteration
      ├── SyntaxError
      │    └── IndentationError
      │         └── TabError
      ├── SystemError
      ├── TypeError
      ├── ValueError
      │    └── UnicodeError
      │         ├── UnicodeDecodeError
      │         ├── UnicodeEncodeError
      │         └── UnicodeTranslateError
      └── Warning
           ├── BytesWarning
           ├── DeprecationWarning
           ├── EncodingWarning
           ├── FutureWarning
           ├── ImportWarning
           ├── PendingDeprecationWarning
           ├── ResourceWarning
           ├── RuntimeWarning
           ├── SyntaxWarning
           ├── UnicodeWarning
           └── UserWarning