> **Источник:** https://python-all.ru/3.16/library/exceptions.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

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

В Python все исключения должны быть экземплярами класса, производного от [`BaseException`](https://python-all.ru/3.16/library/exceptions.html#BaseException). В операторе [`try`](https://python-all.ru/3.16/reference/compound_stmts.html#try) с предложением [`except`](https://python-all.ru/3.16/reference/compound_stmts.html#except), в котором указан конкретный класс, это предложение также обрабатывает любые классы исключений, производные от этого класса (но не классы исключений, от которых *он* сам является производным). Два класса исключений, не связанных через наследование, никогда не эквивалентны, даже если они имеют одинаковые имена.

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

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

Встроенные классы исключений могут быть подклассифицированы для определения новых исключений; программистам рекомендуется наследовать новые исключения от класса [`Exception`](https://python-all.ru/3.16/library/exceptions.html#Exception) или одного из его подклассов, а не от [`BaseException`](https://python-all.ru/3.16/library/exceptions.html#BaseException). Дополнительная информация об определении исключений доступна в Python Tutorial в разделе [Пользовательские исключения](https://python-all.ru/3.16/tutorial/errors.html#tut-userexceptions).

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

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

#### `BaseException.__context__`

#### `BaseException.__cause__`

#### `BaseException.__suppress_context__`

При возбуждении нового исключения, когда другое исключение уже обрабатывается, атрибут `__context__` нового исключения автоматически устанавливается на обрабатываемое исключение. Исключение может обрабатываться при использовании предложения [`except`](https://python-all.ru/3.16/reference/compound_stmts.html#except) или [`finally`](https://python-all.ru/3.16/reference/compound_stmts.html#finally), или оператора [`with`](https://python-all.ru/3.16/reference/compound_stmts.html#with).

Этот неявный контекст исключения может быть дополнен явной причиной с помощью `from` с [`raise`](https://python-all.ru/3.16/reference/simple_stmts.html#raise):

```python
raise new_exc from original_exc
```

Выражение после [`from`](https://python-all.ru/3.16/reference/simple_stmts.html#raise) должно быть исключением или `None`. Оно будет установлено как `__cause__` у возбуждённого исключения. Установка `__cause__` также неявно устанавливает атрибут `__suppress_context__` в `True`, так что использование `raise new_exc from None` фактически заменяет старое исключение новым для целей отображения (например, преобразование [`KeyError`](https://python-all.ru/3.16/library/exceptions.html#KeyError) в [`AttributeError`](https://python-all.ru/3.16/library/exceptions.html#AttributeError)), оставляя старое исключение доступным в `__context__` для анализа при отладке.

Код отображения стандартной трассировки показывает эти цепочки исключений в дополнение к трассировке самого исключения. Явно связанное исключение в `__cause__` всегда показывается, если присутствует. Неявно связанное исключение в `__context__` показывается только если `__cause__` равно [`None`](https://python-all.ru/3.16/library/constants.html#None) и `__suppress_context__` равно false.

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

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

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

**Особенность реализации CPython:** Большинство встроенных исключений реализованы на C для эффективности, см.: [Objects/exceptions.c](https://python-all.ru/src/main/Objects/exceptions.c). Некоторые из них имеют собственную компоновку памяти, что делает невозможным создание подкласса, наследующего от нескольких типов исключений. Компоновка памяти типа является деталью реализации и может измениться между версиями Python, что приведёт к новым конфликтам в будущем. Поэтому рекомендуется вообще избегать наследования от нескольких типов исключений.

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

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

#### `exception BaseException`

Базовый класс для всех встроенных исключений. Он не предназначен для прямого наследования пользовательскими классами (для этого используйте [`Exception`](https://python-all.ru/3.16/library/exceptions.html#Exception)). Если для экземпляра этого класса вызвать [`str()`](https://python-all.ru/3.16/library/stdtypes.html#str), возвращается строковое представление аргумента(ов) экземпляра, или пустая строка, если аргументов не было.

#### `args`

Кортеж аргументов, переданных конструктору исключения. Некоторые встроенные исключения (например, [`OSError`](https://python-all.ru/3.16/library/exceptions.html#OSError)) ожидают определённое количество аргументов и присваивают элементам этого кортежа специальное значение, в то время как другие обычно вызываются только с одной строкой, содержащей сообщение об ошибке.

#### `with_traceback(tb)`

Этот метод устанавливает *tb* в качестве новой трассировки для исключения и возвращает объект исключения. Он чаще использовался до появления возможностей цепочек исключений из [**PEP 3134**](https://python-all.ru/3.16/library/exceptions.html). Следующий пример показывает, как можно преобразовать экземпляр `SomeException` в экземпляр `OtherException`, сохранив трассировку. После возбуждения текущий фрейм помещается в трассировку `OtherException`, как это произошло бы с трассировкой исходного `SomeException`, если бы мы позволили ему распространиться до вызывающего кода.

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

#### `__traceback__`

Поле для записи, которое содержит [объект трассировки](https://python-all.ru/3.16/reference/datamodel.html#traceback-objects), связанный с этим исключением. См. также: [Оператор raise](https://python-all.ru/3.16/reference/simple_stmts.html#raise).

#### `add_note(note)`

Добавляет строку `note` к заметкам исключения, которые появляются в стандартной трассировке после строки исключения. Возбуждается [`TypeError`](https://python-all.ru/3.16/library/exceptions.html#TypeError), если `note` не является строкой.

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

#### `__notes__`

Список примечаний этого исключения, добавленных с помощью [`add_note()`](https://python-all.ru/3.16/library/exceptions.html#BaseException.add_note). Этот атрибут создаётся при вызове `add_note()`.

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

#### `exception Exception`

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

#### `exception ArithmeticError`

Базовый класс для встроенных исключений, которые возбуждаются при различных арифметических ошибках: [`OverflowError`](https://python-all.ru/3.16/library/exceptions.html#OverflowError), [`ZeroDivisionError`](https://python-all.ru/3.16/library/exceptions.html#ZeroDivisionError), [`FloatingPointError`](https://python-all.ru/3.16/library/exceptions.html#FloatingPointError).

#### `exception BufferError`

Возбуждается, когда не может быть выполнена операция, связанная с [буфером](https://python-all.ru/3.16/c-api/buffer.html#bufferobjects).

#### `exception LookupError`

Базовый класс для исключений, возбуждаемых, когда ключ или индекс, используемые в отображении или последовательности, недействительны: [`IndexError`](https://python-all.ru/3.16/library/exceptions.html#IndexError), [`KeyError`](https://python-all.ru/3.16/library/exceptions.html#KeyError). Оно может быть возбуждено напрямую с помощью [`codecs.lookup()`](https://python-all.ru/3.16/library/codecs.html#codecs.lookup).

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

Обычно возбуждаются следующие исключения.

#### `exception AssertionError`

Возбуждается, когда оператор [`assert`](https://python-all.ru/3.16/reference/simple_stmts.html#assert) завершается неудачно.

#### `exception AttributeError`

Возбуждается при неудачном обращении к атрибуту (см. [Обращения к атрибутам](https://python-all.ru/3.16/reference/expressions.html#attribute-references)) или присваивании. (Если объект вообще не поддерживает обращения к атрибутам или их присваивание, возбуждается [`TypeError`](https://python-all.ru/3.16/library/exceptions.html#TypeError).)

Необязательные именованные аргументы *name* и *obj* устанавливают соответствующие атрибуты:

#### `name`

Имя атрибута, к которому была предпринята попытка обращения.

#### `obj`

Объект, к которому было выполнено обращение для получения указанного атрибута.

Изменено в версии 3.10: Добавлены атрибуты [`name`](https://python-all.ru/3.16/library/exceptions.html#AttributeError.name) и [`obj`](https://python-all.ru/3.16/library/exceptions.html#AttributeError.obj).

#### `exception EOFError`

Возбуждается, когда функция [`input()`](https://python-all.ru/3.16/library/functions.html#input) достигает конца файла (EOF), не прочитав ни одного байта данных. (Примечание: методы [`io.TextIOBase.read()`](https://python-all.ru/3.16/library/io.html#io.TextIOBase.read) и [`io.IOBase.readline()`](https://python-all.ru/3.16/library/io.html#io.IOBase.readline) возвращают пустую строку при достижении EOF.)

#### `exception FloatingPointError`

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

#### `exception GeneratorExit`

Возбуждается при закрытии [генератора](https://python-all.ru/3.16/glossary.html#term-generator) или [корутины](https://python-all.ru/3.16/glossary.html#term-coroutine); см. [`generator.close()`](https://python-all.ru/3.16/reference/expressions.html#generator.close) и [`coroutine.close()`](https://python-all.ru/3.16/reference/datamodel.html#coroutine.close). Это исключение напрямую наследуется от [`BaseException`](https://python-all.ru/3.16/library/exceptions.html#BaseException), а не от [`Exception`](https://python-all.ru/3.16/library/exceptions.html#Exception), поскольку технически не является ошибкой.

#### `exception ImportError`

Возбуждается, когда оператор [`import`](https://python-all.ru/3.16/reference/simple_stmts.html#import) испытывает проблемы при попытке загрузить модуль. Также возбуждается, когда «список from» в `from ... import` содержит имя, которое не удаётся найти.

Необязательные именованные аргументы *name* и *path* устанавливают соответствующие атрибуты:

#### `name`

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

#### `path`

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

Изменено в версии 3.3: Добавлены атрибуты [`name`](https://python-all.ru/3.16/library/exceptions.html#ImportError.name) и [`path`](https://python-all.ru/3.16/library/exceptions.html#ImportError.path).

#### `exception ModuleNotFoundError`

Подкласс [`ImportError`](https://python-all.ru/3.16/library/exceptions.html#ImportError), который вызывается [`import`](https://python-all.ru/3.16/reference/simple_stmts.html#import), когда модуль не может быть найден. Также вызывается, когда `None` обнаружен в [`sys.modules`](https://python-all.ru/3.16/library/sys.html#sys.modules).

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

#### `exception ImportCycleError`

Подкласс [`ImportError`](https://python-all.ru/3.16/library/exceptions.html#ImportError), который вызывается, когда ленивый импорт не удаётся, поскольку он (прямо или косвенно) пытается импортировать самого себя.

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

#### `exception IndexError`

Вызывается, когда индекс последовательности выходит за диапазон. (Индексы среза молча обрезаются, чтобы попасть в допустимый диапазон; если индекс не является целым числом, вызывается [`TypeError`](https://python-all.ru/3.16/library/exceptions.html#TypeError).)

#### `exception KeyError`

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

#### `exception KeyboardInterrupt`

Вызывается, когда пользователь нажимает клавишу прерывания (обычно `Control`-`C` или `Delete`). Во время выполнения регулярно выполняется проверка прерываний. Исключение наследуется от [`BaseException`](https://python-all.ru/3.16/library/exceptions.html#BaseException), чтобы случайно не быть перехваченным кодом, который ловит [`Exception`](https://python-all.ru/3.16/library/exceptions.html#Exception), и тем самым предотвратить завершение интерпретатора.

> **Примечание**
>
> Перехват `KeyboardInterrupt` требует особого внимания. Поскольку он может быть вызван в непредсказуемых точках, это может в некоторых обстоятельствах оставить выполняющуюся программу в несогласованном состоянии. Обычно лучше позволить `KeyboardInterrupt` завершить программу как можно быстрее или вообще избегать его вызова. (См. [Примечание об обработчиках сигналов и исключениях](https://python-all.ru/3.16/library/signal.html#handlers-and-exceptions).)

#### `exception MemoryError`

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

#### `exception NameError`

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

Необязательный аргумент только по ключевому слову *name* устанавливает атрибут:

#### `name`

Имя переменной, к которой была предпринята попытка доступа.

Изменено в версии 3.10: Добавлен атрибут [`name`](https://python-all.ru/3.16/library/exceptions.html#NameError.name).

#### `exception NotImplementedError`

Это исключение является производным от [`RuntimeError`](https://python-all.ru/3.16/library/exceptions.html#RuntimeError). В определённых пользователями базовых классах абстрактные методы должны вызывать это исключение, когда они требуют, чтобы производные классы переопределили метод, или пока класс находится в разработке, чтобы указать, что реальная реализация ещё не добавлена.

> **Примечание**
>
> Он не должен использоваться для указания того, что оператор или метод не предназначен для поддержки вообще – в этом случае либо оставьте оператор/метод неопределённым, либо, если это подкласс, установите его в [`None`](https://python-all.ru/3.16/library/constants.html#None).

> **Внимание**
>
> `NotImplementedError` и `NotImplemented` не взаимозаменяемы. Это исключение следует использовать только так, как описано выше; подробнее о правильном использовании встроенной константы см. [`NotImplemented`](https://python-all.ru/3.16/library/constants.html#NotImplemented).

#### `exception OSError([arg])`

#### `exception OSError(errno, strerror[, filename[, winerror[, filename2]]])`

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

Вторая форма конструктора устанавливает соответствующие атрибуты, описанные ниже. Атрибуты по умолчанию равны [`None`](https://python-all.ru/3.16/library/constants.html#None), если не указаны. Для обратной совместимости, если передано три аргумента, атрибут [`args`](https://python-all.ru/3.16/library/exceptions.html#BaseException.args) содержит только кортеж из двух элементов из первых двух аргументов конструктора.

Конструктор часто фактически возвращает подкласс `OSError`, как описано в [Исключения ОС](https://python-all.ru/3.16/library/exceptions.html#os-exceptions) ниже. Конкретный подкласс зависит от конечного значения [`errno`](https://python-all.ru/3.16/library/exceptions.html#OSError.errno). Это поведение происходит только при конструировании `OSError` напрямую или через псевдоним и не наследуется при создании подклассов.

#### `errno`

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

#### `winerror`

В Windows это возвращает собственный код ошибки Windows. Атрибут [`errno`](https://python-all.ru/3.16/library/exceptions.html#OSError.errno) является приблизительным переводом этого кода в терминах POSIX.

В Windows, если аргумент конструктора *winerror* является целым числом, атрибут [`errno`](https://python-all.ru/3.16/library/exceptions.html#OSError.errno) определяется из кода ошибки Windows, а аргумент *errno* игнорируется. На других платформах аргумент *winerror* игнорируется, а атрибут [`winerror`](https://python-all.ru/3.16/library/exceptions.html#OSError.winerror) не существует.

#### `strerror`

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

#### `filename`

#### `filename2`

Для исключений, связанных с путём файловой системы (например, [`open()`](https://python-all.ru/3.16/library/functions.html#open) или [`os.unlink()`](https://python-all.ru/3.16/library/os.html#os.unlink)), [`filename`](https://python-all.ru/3.16/library/exceptions.html#OSError.filename) – это имя файла, переданное функции. Для функций, работающих с двумя путями (например, [`os.rename()`](https://python-all.ru/3.16/library/os.html#os.rename)), [`filename2`](https://python-all.ru/3.16/library/exceptions.html#OSError.filename2) соответствует второму имени файла, переданному функции.

Изменено в версии 3.3: [`EnvironmentError`](https://python-all.ru/3.16/library/exceptions.html#EnvironmentError), [`IOError`](https://python-all.ru/3.16/library/exceptions.html#IOError), [`WindowsError`](https://python-all.ru/3.16/library/exceptions.html#WindowsError), [`socket.error`](https://python-all.ru/3.16/library/socket.html#socket.error), [`select.error`](https://python-all.ru/3.16/library/select.html#select.error) и `mmap.error` были объединены в `OSError`, и конструктор может возвращать подкласс.

Изменено в версии 3.4: Атрибут [`filename`](https://python-all.ru/3.16/library/exceptions.html#OSError.filename) теперь содержит исходное имя файла, переданное функции, а не имя, закодированное или декодированное с помощью [кодировки файловой системы и обработчика ошибок](https://python-all.ru/3.16/glossary.html#term-filesystem-encoding-and-error-handler). Также были добавлены аргумент конструктора и атрибут *filename2*.

#### `exception OverflowError`

Возникает, когда результат арифметической операции слишком велик для представления. Для целых чисел этого не происходит (они скорее вызовут [`MemoryError`](https://python-all.ru/3.16/library/exceptions.html#MemoryError), чем откажутся от значения). Однако по историческим причинам OverflowError иногда возникает для целых чисел, выходящих за требуемый диапазон. Из-за отсутствия стандартизации обработки исключений с плавающей точкой в C, большинство операций с плавающей точкой не проверяются.

#### `exception PythonFinalizationError`

Это исключение является производным от [`RuntimeError`](https://python-all.ru/3.16/library/exceptions.html#RuntimeError). Возникает, когда операция блокируется во время завершения работы интерпретатора, также известного как [финализация Python](https://python-all.ru/3.16/glossary.html#term-interpreter-shutdown).

Примеры операций, которые могут быть заблокированы с помощью `PythonFinalizationError` во время финализации Python:

- Создание нового потока Python.
- [`Joining`](https://python-all.ru/3.16/library/threading.html#threading.Thread.join) запущенного потока-демона.
- [`os.fork()`](https://python-all.ru/3.16/library/os.html#os.fork),
- при захвате блокировки, такой как [`threading.Lock`](https://python-all.ru/3.16/library/threading.html#threading.Lock), когда известно, что в противном случае операция привела бы к взаимоблокировке.

См. также функцию [`sys.is_finalizing()`](https://python-all.ru/3.16/library/sys.html#sys.is_finalizing).

Добавлено в версии 3.13: Ранее вызывалось простое [`RuntimeError`](https://python-all.ru/3.16/library/exceptions.html#RuntimeError).

Изменено в версии 3.14: [`threading.Thread.join()`](https://python-all.ru/3.16/library/threading.html#threading.Thread.join) теперь может вызывать это исключение.

Изменено в версии 3.15: Это исключение может быть вызвано при захвате [`threading.Lock()`](https://python-all.ru/3.16/library/threading.html#threading.Lock) или [`threading.RLock()`](https://python-all.ru/3.16/library/threading.html#threading.RLock).

#### `exception RecursionError`

Это исключение является производным от [`RuntimeError`](https://python-all.ru/3.16/library/exceptions.html#RuntimeError). Возникает, когда интерпретатор обнаруживает, что превышена максимальная глубина рекурсии (см. [`sys.getrecursionlimit()`](https://python-all.ru/3.16/library/sys.html#sys.getrecursionlimit)).

Добавлено в версии 3.5: Ранее вызывалось простое [`RuntimeError`](https://python-all.ru/3.16/library/exceptions.html#RuntimeError).

#### `exception ReferenceError`

Это исключение возникает, когда прокси-объект слабой ссылки, созданный функцией [`weakref.proxy()`](https://python-all.ru/3.16/library/weakref.html#weakref.proxy), используется для доступа к атрибуту референта после его сборки мусора. Дополнительную информацию о слабых ссылках см. в модуле [`weakref`](https://python-all.ru/3.16/library/weakref.html#module-weakref).

#### `exception RuntimeError`

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

#### `exception StopIteration`

Возникает при вызове встроенной функции [`next()`](https://python-all.ru/3.16/library/functions.html#next) и метода [`__next__()`](https://python-all.ru/3.16/library/stdtypes.html#iterator.__next__) [итератора](https://python-all.ru/3.16/glossary.html#term-iterator), чтобы сигнализировать, что итератор больше не выдаёт элементы.

#### `value`

Объект исключения имеет единственный атрибут `value`, который передаётся в качестве аргумента при создании исключения и по умолчанию равен [`None`](https://python-all.ru/3.16/library/constants.html#None).

Когда [генератор](https://python-all.ru/3.16/glossary.html#term-generator) или [корутина](https://python-all.ru/3.16/glossary.html#term-coroutine) возвращает, возбуждается новый экземпляр `StopIteration`, и возвращённое функцией значение используется как параметр [`value`](https://python-all.ru/3.16/library/exceptions.html#StopIteration.value) конструктора исключения.

Если код генератора прямо или косвенно вызывает `StopIteration`, он преобразуется в [`RuntimeError`](https://python-all.ru/3.16/library/exceptions.html#RuntimeError) (с сохранением `StopIteration` в качестве причины нового исключения).

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

Изменено в версии 3.5: Введено преобразование RuntimeError через `from __future__ import generator_stop`, см. [**PEP 479**](https://python-all.ru/3.16/library/exceptions.html).

Изменено в версии 3.7: Включён [**PEP 479**](https://python-all.ru/3.16/library/exceptions.html) для всего кода по умолчанию: ошибка `StopIteration`, возникшая в генераторе, преобразуется в [`RuntimeError`](https://python-all.ru/3.16/library/exceptions.html#RuntimeError).

#### `exception StopAsyncIteration`

Должно быть возбуждено методом [`__anext__()`](https://python-all.ru/3.16/reference/datamodel.html#object.__anext__) объекта [асинхронный итератор](https://python-all.ru/3.16/glossary.html#term-asynchronous-iterator), чтобы остановить итерацию.

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

#### `exception SyntaxError(message, details)`

Возбуждается, когда анализатор встречает синтаксическую ошибку. Это может произойти в операторе [`import`](https://python-all.ru/3.16/reference/simple_stmts.html#import), при вызове встроенных функций [`compile()`](https://python-all.ru/3.16/library/functions.html#compile), [`exec()`](https://python-all.ru/3.16/library/functions.html#exec), или [`eval()`](https://python-all.ru/3.16/library/functions.html#eval), или при чтении начального скрипта или стандартного ввода (также в интерактивном режиме).

Атрибут [`str()`](https://python-all.ru/3.16/library/stdtypes.html#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`](https://python-all.ru/3.16/library/exceptions.html#SyntaxError.end_lineno) и [`end_offset`](https://python-all.ru/3.16/library/exceptions.html#SyntaxError.end_offset).

#### `exception IndentationError`

Базовый класс для синтаксических ошибок, связанных с неверным отступом. Является подклассом [`SyntaxError`](https://python-all.ru/3.16/library/exceptions.html#SyntaxError).

#### `exception TabError`

Возбуждается, когда отступ содержит непоследовательное использование табуляции и пробелов. Является подклассом [`IndentationError`](https://python-all.ru/3.16/library/exceptions.html#IndentationError).

#### `exception SystemError`

Возбуждается, когда интерпретатор обнаруживает внутреннюю ошибку, но ситуация не настолько серьёзна, чтобы он отказался от всех надежд. Связанное значение – это строка с указанием того, что пошло не так (на низком уровне). В [CPython](https://python-all.ru/3.16/glossary.html#term-CPython) это может быть вызвано неправильным использованием C API Python, например, возвратом значения `NULL` без установленного исключения.

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

#### `exception SystemExit`

Это исключение возбуждается функцией [`sys.exit()`](https://python-all.ru/3.16/library/sys.html#sys.exit). Оно наследуется от [`BaseException`](https://python-all.ru/3.16/library/exceptions.html#BaseException), а не от [`Exception`](https://python-all.ru/3.16/library/exceptions.html#Exception), чтобы его случайно не перехватил код, который перехватывает `Exception`. Это позволяет исключению правильно всплыть и вызвать завершение интерпретатора. Если оно не обработано, интерпретатор Python завершается; стек вызовов не выводится. Конструктор принимает тот же необязательный аргумент, что и `sys.exit()`. Если значение – целое число, оно задаёт статус выхода системы (передаётся функции `exit()` в C); если это `None`, статус выхода равен нулю; если имеет другой тип (например, строку), значение объекта выводится, а статус выхода равен единице.

Вызов [`sys.exit()`](https://python-all.ru/3.16/library/sys.html#sys.exit) преобразуется в исключение, чтобы могли выполниться обработчики очистки (блоки [`finally`](https://python-all.ru/3.16/reference/compound_stmts.html#finally) операторов [`try`](https://python-all.ru/3.16/reference/compound_stmts.html#try)), а также чтобы отладчик мог выполнить скрипт без риска потерять управление. Функцию [`os._exit()`](https://python-all.ru/3.16/library/os.html#os._exit) можно использовать, если абсолютно необходимо выйти немедленно (например, в дочернем процессе после вызова [`os.fork()`](https://python-all.ru/3.16/library/os.html#os.fork)).

#### `code`

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

#### `exception TypeError`

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

Это исключение может вызываться пользовательским кодом, чтобы указать, что попытка выполнить операцию над объектом не поддерживается и не предполагается. Если объект должен поддерживать данную операцию, но ещё не имеет реализации, правильным исключением будет [`NotImplementedError`](https://python-all.ru/3.16/library/exceptions.html#NotImplementedError).

Передача аргументов неправильного типа (например, передача [`list`](https://python-all.ru/3.16/library/stdtypes.html#list), когда ожидается [`int`](https://python-all.ru/3.16/library/functions.html#int)) должна приводить к `TypeError`, а передача аргументов с неправильным значением (например, число вне допустимых границ) должна приводить к [`ValueError`](https://python-all.ru/3.16/library/exceptions.html#ValueError).

#### `exception UnboundLocalError`

Вызывается, когда осуществляется обращение к локальной переменной функции или метода, но этой переменной не присвоено значение. Является подклассом [`NameError`](https://python-all.ru/3.16/library/exceptions.html#NameError).

#### `exception UnicodeError`

Вызывается при ошибке кодирования или декодирования, связанной с Unicode. Является подклассом [`ValueError`](https://python-all.ru/3.16/library/exceptions.html#ValueError).

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

#### `encoding`

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

#### `reason`

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

#### `object`

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

#### `start`

Первый индекс недопустимых данных в [`object`](https://python-all.ru/3.16/library/functions.html#object).

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

#### `end`

Индекс, следующий за последними недопустимыми данными в [`object`](https://python-all.ru/3.16/library/functions.html#object).

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

#### `exception UnicodeEncodeError`

Вызывается при ошибке, связанной с Unicode, во время кодирования. Является подклассом [`UnicodeError`](https://python-all.ru/3.16/library/exceptions.html#UnicodeError).

#### `exception UnicodeDecodeError`

Вызывается при ошибке, связанной с Unicode, во время декодирования. Является подклассом [`UnicodeError`](https://python-all.ru/3.16/library/exceptions.html#UnicodeError).

#### `exception UnicodeTranslateError`

Вызывается при ошибке, связанной с Unicode, во время трансляции. Является подклассом [`UnicodeError`](https://python-all.ru/3.16/library/exceptions.html#UnicodeError).

#### `exception ValueError`

Вызывается, когда операция или функция получает аргумент правильного типа, но с неподходящим значением, и ситуация не описывается более точным исключением, например [`IndexError`](https://python-all.ru/3.16/library/exceptions.html#IndexError).

#### `exception ZeroDivisionError`

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

Следующие исключения сохранены для совместимости с предыдущими версиями; начиная с Python 3.3, они являются псевдонимами [`OSError`](https://python-all.ru/3.16/library/exceptions.html#OSError).

#### `exception EnvironmentError`

#### `exception IOError`

#### `exception WindowsError`

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

### Исключения ОС

Следующие исключения являются подклассами [`OSError`](https://python-all.ru/3.16/library/exceptions.html#OSError); они возбуждаются в зависимости от кода системной ошибки.

#### `exception BlockingIOError`

Возбуждается, когда операция заблокировалась бы на объекте (например, сокете), настроенном на неблокирующий режим. Соответствует `errno` [`EAGAIN`](https://python-all.ru/3.16/library/errno.html#errno.EAGAIN), [`EALREADY`](https://python-all.ru/3.16/library/errno.html#errno.EALREADY), [`EWOULDBLOCK`](https://python-all.ru/3.16/library/errno.html#errno.EWOULDBLOCK) и [`EINPROGRESS`](https://python-all.ru/3.16/library/errno.html#errno.EINPROGRESS).

В дополнение к атрибутам [`OSError`](https://python-all.ru/3.16/library/exceptions.html#OSError), `BlockingIOError` может иметь ещё один атрибут:

#### `characters_written`

Целое число, содержащее количество **байт**, записанных в поток данных до того, как он заблокировался. Этот атрибут доступен при использовании буферизованных классов ввода-вывода из модуля [`io`](https://python-all.ru/3.16/library/io.html#module-io).

#### `exception ChildProcessError`

Возбуждается, когда операция над дочерним процессом завершилась ошибкой. Соответствует `errno` [`ECHILD`](https://python-all.ru/3.16/library/errno.html#errno.ECHILD).

#### `exception ConnectionError`

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

Подклассами являются [`BrokenPipeError`](https://python-all.ru/3.16/library/exceptions.html#BrokenPipeError), [`ConnectionAbortedError`](https://python-all.ru/3.16/library/exceptions.html#ConnectionAbortedError), [`ConnectionRefusedError`](https://python-all.ru/3.16/library/exceptions.html#ConnectionRefusedError) и [`ConnectionResetError`](https://python-all.ru/3.16/library/exceptions.html#ConnectionResetError).

#### `exception BrokenPipeError`

Подкласс [`ConnectionError`](https://python-all.ru/3.16/library/exceptions.html#ConnectionError), возбуждается при попытке записи в канал, когда другой его конец закрыт, или при попытке записи в сокет, который был закрыт для записи. Соответствует `errno` [`EPIPE`](https://python-all.ru/3.16/library/errno.html#errno.EPIPE) и [`ESHUTDOWN`](https://python-all.ru/3.16/library/errno.html#errno.ESHUTDOWN).

#### `exception ConnectionAbortedError`

Подкласс [`ConnectionError`](https://python-all.ru/3.16/library/exceptions.html#ConnectionError), возбуждается, когда попытка соединения прервана удалённой стороной. Соответствует `errno` [`ECONNABORTED`](https://python-all.ru/3.16/library/errno.html#errno.ECONNABORTED).

#### `exception ConnectionRefusedError`

Подкласс [`ConnectionError`](https://python-all.ru/3.16/library/exceptions.html#ConnectionError), возбуждается, когда попытка соединения отклонена удалённой стороной. Соответствует `errno` [`ECONNREFUSED`](https://python-all.ru/3.16/library/errno.html#errno.ECONNREFUSED).

#### `exception ConnectionResetError`

Подкласс [`ConnectionError`](https://python-all.ru/3.16/library/exceptions.html#ConnectionError), возбуждается, когда соединение сброшено удалённой стороной. Соответствует `errno` [`ECONNRESET`](https://python-all.ru/3.16/library/errno.html#errno.ECONNRESET).

#### `exception FileExistsError`

Возбуждается при попытке создать файл или каталог, который уже существует. Соответствует `errno` [`EEXIST`](https://python-all.ru/3.16/library/errno.html#errno.EEXIST).

#### `exception FileNotFoundError`

Возбуждается, когда запрашивается файл или каталог, который не существует. Соответствует `errno` [`ENOENT`](https://python-all.ru/3.16/library/errno.html#errno.ENOENT).

#### `exception InterruptedError`

Возбуждается, когда системный вызов прерывается входящим сигналом. Соответствует `errno` [`EINTR`](https://python-all.ru/3.16/library/errno.html#errno.EINTR).

Изменено в версии 3.5: Теперь Python повторяет системные вызовы, когда системный вызов прерывается сигналом, за исключением случая, когда обработчик сигнала возбуждает исключение (см. [**PEP 475**](https://python-all.ru/3.16/library/exceptions.html) для обоснования), вместо возбуждения `InterruptedError`.

#### `exception IsADirectoryError`

Возбуждается, когда файловая операция (например, [`os.remove()`](https://python-all.ru/3.16/library/os.html#os.remove)) запрашивается для каталога. Соответствует `errno` [`EISDIR`](https://python-all.ru/3.16/library/errno.html#errno.EISDIR).

#### `exception NotADirectoryError`

Возбуждается, когда операция с каталогом (например, [`os.listdir()`](https://python-all.ru/3.16/library/os.html#os.listdir)) запрашивается для чего-то, что не является каталогом. На большинстве платформ POSIX также может возбуждаться, если операция пытается открыть или обойти файл, не являющийся каталогом, как если бы он был каталогом. Соответствует `errno` [`ENOTDIR`](https://python-all.ru/3.16/library/errno.html#errno.ENOTDIR).

#### `exception PermissionError`

Возбуждается при попытке выполнить операцию без соответствующих прав доступа – например, прав файловой системы. Соответствует `errno` [`EACCES`](https://python-all.ru/3.16/library/errno.html#errno.EACCES), [`EPERM`](https://python-all.ru/3.16/library/errno.html#errno.EPERM) и [`ENOTCAPABLE`](https://python-all.ru/3.16/library/errno.html#errno.ENOTCAPABLE).

Изменено в версии 3.11.1: WASI [`ENOTCAPABLE`](https://python-all.ru/3.16/library/errno.html#errno.ENOTCAPABLE) теперь отображается на `PermissionError`.

#### `exception ProcessLookupError`

Возбуждается, когда указанный процесс не существует. Соответствует `errno` [`ESRCH`](https://python-all.ru/3.16/library/errno.html#errno.ESRCH).

#### `exception TimeoutError`

Возбуждается, когда системная функция превысила время ожидания на уровне системы. Соответствует `errno` [`ETIMEDOUT`](https://python-all.ru/3.16/library/errno.html#errno.ETIMEDOUT).

Добавлено в версии 3.3: Все вышеперечисленные подклассы [`OSError`](https://python-all.ru/3.16/library/exceptions.html#OSError) были добавлены.

> **См. также**
>
> [**PEP 3151**](https://python-all.ru/3.16/library/exceptions.html) – Переработка иерархии исключений ОС и ввода-вывода

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

Следующие исключения используются как категории предупреждений; см. документацию [Категории предупреждений](https://python-all.ru/3.16/library/warnings.html#warning-categories) для получения дополнительных сведений.

#### `exception Warning`

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

#### `exception UserWarning`

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

#### `exception DeprecationWarning`

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

Игнорируется фильтрами предупреждений по умолчанию, за исключением модуля `__main__` ([**PEP 565**](https://python-all.ru/3.16/library/exceptions.html)). Включение [режима разработки Python](https://python-all.ru/3.16/library/devmode.html#devmode) показывает это предупреждение.

Политика устаревания описана в [**PEP 387**](https://python-all.ru/3.16/library/exceptions.html).

#### `exception PendingDeprecationWarning`

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

Этот класс используется редко, поскольку отправка предупреждения о возможном будущем устаревании необычна, и для уже активных устареваний предпочтительнее [`DeprecationWarning`](https://python-all.ru/3.16/library/exceptions.html#DeprecationWarning).

Игнорируется фильтрами предупреждений по умолчанию. Включение [режима разработки Python](https://python-all.ru/3.16/library/devmode.html#devmode) отображает это предупреждение.

Политика устаревания описана в [**PEP 387**](https://python-all.ru/3.16/library/exceptions.html).

#### `exception SyntaxWarning`

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

Это предупреждение обычно выдается при компиляции исходного кода Python и обычно не сообщается при выполнении уже скомпилированного кода.

#### `exception RuntimeWarning`

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

#### `exception FutureWarning`

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

#### `exception ImportWarning`

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

Игнорируется фильтрами предупреждений по умолчанию. Включение [режима разработки Python](https://python-all.ru/3.16/library/devmode.html#devmode) отображает это предупреждение.

#### `exception UnicodeWarning`

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

#### `exception EncodingWarning`

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

Подробнее см. [Opt-in EncodingWarning](https://python-all.ru/3.16/library/io.html#io-encoding-warning).

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

#### `exception BytesWarning`

Базовый класс для предупреждений, связанных с [`bytes`](https://python-all.ru/3.16/library/stdtypes.html#bytes) и [`bytearray`](https://python-all.ru/3.16/library/stdtypes.html#bytearray).

#### `exception ResourceWarning`

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

Игнорируется фильтрами предупреждений по умолчанию. Включение [режима разработки Python](https://python-all.ru/3.16/library/devmode.html#devmode) отображает это предупреждение.

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

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

Следующие классы используются, когда необходимо возбудить несколько несвязанных исключений. Они являются частью иерархии исключений, поэтому их можно обрабатывать с помощью [`except`](https://python-all.ru/3.16/reference/compound_stmts.html#except), как и любые другие исключения. Кроме того, они распознаются [`except*`](https://python-all.ru/3.16/reference/compound_stmts.html#except-star), который сопоставляет их подгруппы на основе типов содержащихся исключений.

#### `exception ExceptionGroup(msg, excs)`

#### `exception BaseExceptionGroup(msg, excs)`

Оба этих типа исключений оборачивают исключения из последовательности `excs`. Параметр `msg` должен быть строкой. Разница между двумя классами в том, что `BaseExceptionGroup` расширяет [`BaseException`](https://python-all.ru/3.16/library/exceptions.html#BaseException) и может оборачивать любые исключения, тогда как [`ExceptionGroup`](https://python-all.ru/3.16/library/exceptions.html#ExceptionGroup) расширяет [`Exception`](https://python-all.ru/3.16/library/exceptions.html#Exception) и может оборачивать только подклассы `Exception`. Такая конструкция нужна для того, чтобы `except Exception` перехватывал `ExceptionGroup`, но не `BaseExceptionGroup`.

Конструктор `BaseExceptionGroup` возвращает [`ExceptionGroup`](https://python-all.ru/3.16/library/exceptions.html#ExceptionGroup), а не `BaseExceptionGroup`, если все содержащиеся исключения являются экземплярами [`Exception`](https://python-all.ru/3.16/library/exceptions.html#Exception), что позволяет сделать выбор автоматически. Конструктор `ExceptionGroup`, с другой стороны, возбуждает [`TypeError`](https://python-all.ru/3.16/library/exceptions.html#TypeError), если хотя бы одно содержащееся исключение не является подклассом `Exception`.

Группы исключений являются [обобщёнными](https://python-all.ru/3.16/library/typing.html#generics) по типу содержащихся в них исключений.

**Особенность реализации CPython:** Параметр `excs` может быть любой последовательностью, но списки и кортежи обрабатываются здесь более эффективно. Для оптимальной производительности передавайте кортеж в качестве `excs`.

#### `message`

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

#### `exceptions`

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

#### `subgroup(condition)`

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

Условием может быть тип исключения или кортеж типов исключений; в таком случае каждое исключение проверяется на соответствие с помощью той же проверки, что используется в предложении `except`. Условием также может быть вызываемый объект (отличный от типа), который принимает исключение в качестве единственного аргумента и возвращает истину для исключений, которые должны быть в подгруппе.

Структура вложенности текущего исключения сохраняется в результате, как и значения его полей [`message`](https://python-all.ru/3.16/library/exceptions.html#BaseExceptionGroup.message), [`__traceback__`](https://python-all.ru/3.16/library/exceptions.html#BaseException.__traceback__), [`__cause__`](https://python-all.ru/3.16/library/exceptions.html#BaseException.__cause__), [`__context__`](https://python-all.ru/3.16/library/exceptions.html#BaseException.__context__) и [`__notes__`](https://python-all.ru/3.16/library/exceptions.html#BaseException.__notes__). Пустые вложенные группы опускаются в результате.

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

Добавлено в версии 3.13: `condition` может быть любой вызываемой сущностью, которая не является объектом типа.

#### `split(condition)`

Подобно [`subgroup()`](https://python-all.ru/3.16/library/exceptions.html#BaseExceptionGroup.subgroup), но возвращает пару `(match, rest)`, где `match` – это `subgroup(condition)`, а `rest` – оставшаяся несовпадающая часть.

#### `derive(excs)`

Возвращает группу исключений с тем же [`message`](https://python-all.ru/3.16/library/exceptions.html#BaseExceptionGroup.message), но которая оборачивает исключения в `excs`.

Этот метод используется [`subgroup()`](https://python-all.ru/3.16/library/exceptions.html#BaseExceptionGroup.subgroup) и [`split()`](https://python-all.ru/3.16/library/exceptions.html#BaseExceptionGroup.split), которые применяются в различных контекстах для разделения группы исключений. Подклассу необходимо переопределить его, чтобы `subgroup()` и `split()` возвращали экземпляры подкласса, а не [`ExceptionGroup`](https://python-all.ru/3.16/library/exceptions.html#ExceptionGroup).

[`subgroup()`](https://python-all.ru/3.16/library/exceptions.html#BaseExceptionGroup.subgroup) и [`split()`](https://python-all.ru/3.16/library/exceptions.html#BaseExceptionGroup.split) копируют поля [`__traceback__`](https://python-all.ru/3.16/library/exceptions.html#BaseException.__traceback__), [`__cause__`](https://python-all.ru/3.16/library/exceptions.html#BaseException.__cause__), [`__context__`](https://python-all.ru/3.16/library/exceptions.html#BaseException.__context__) и [`__notes__`](https://python-all.ru/3.16/library/exceptions.html#BaseException.__notes__) из исходной группы исключений в ту, которую возвращает `derive()`, поэтому этим полям не требуется обновления `derive()`.

```pycon
>>> 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__()`](https://python-all.ru/3.16/reference/datamodel.html#object.__new__), поэтому подклассам, которым нужна другая сигнатура конструктора, необходимо переопределять его, а не [`__init__()`](https://python-all.ru/3.16/reference/datamodel.html#object.__init__). Например, ниже определяется подкласс группы исключений, который принимает exit\_code и формирует из него сообщение группы.

```python
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`](https://python-all.ru/3.16/library/exceptions.html#ExceptionGroup), любой подкласс `BaseExceptionGroup`, который также является подклассом [`Exception`](https://python-all.ru/3.16/library/exceptions.html#Exception), может оборачивать только экземпляры `Exception`.

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

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

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

```text
BaseException
 ├── BaseExceptionGroup
 ├── GeneratorExit
 ├── KeyboardInterrupt
 ├── SystemExit
 └── Exception
      ├── ArithmeticError
      │    ├── FloatingPointError
      │    ├── OverflowError
      │    └── ZeroDivisionError
      ├── AssertionError
      ├── AttributeError
      ├── BufferError
      ├── EOFError
      ├── ExceptionGroup [BaseExceptionGroup]
      ├── ImportError
      │    └── ImportCycleError
      │    └── 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
      │    ├── PythonFinalizationError
      │    └── 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
```