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

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

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

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__ равно false.

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

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

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

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

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

exception BaseException¶

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

args¶

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

with_traceback(tb)¶

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

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

__traceback__¶

Доступное для записи поле, содержащее traceback object, связанное с этим исключением. Смотрите также: Оператор raise.

add_note(note)¶

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

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

__notes__¶

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

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

exception Exception¶

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

exception ArithmeticError¶

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

exception BufferError¶

Вызывается, когда не удается выполнить операцию, связанную с buffer.

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 или coroutine; см. generator.close() и coroutine.close(). Он напрямую наследуется от BaseException вместо Exception, поскольку технически это не ошибка.

exception ImportError¶

Вызывается, когда у оператора import возникают проблемы при попытке загрузить модуль. Также вызывается, когда «из списка» в 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¶

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

exception NameError¶

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

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

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

exception NotImplementedError¶

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

Примечание

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

Примечание

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

exception OSError([arg])¶

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

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

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

Конструктор часто фактически возвращает подкласс OSError, как описано в разделе OS exceptions ниже. Конкретный подкласс зависит от конечного значения 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 теперь является исходным именем файла, передаваемым функции, а не именем, закодированным в filesystem encoding and error handler. Кроме того, были добавлены аргумент и атрибут конструктора filename2.

exception OverflowError¶

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

exception RecursionError¶

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

Добавлено в версии 3.5: Ранее был поднят простой RuntimeError.

exception ReferenceError¶

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

exception RuntimeError¶

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

exception StopIteration¶

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

value¶

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

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

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

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

Изменено в версии 3.5: Введено преобразование ошибок во время выполнения с помощью from __future__ import generator_stop, смотрите PEP 479.

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

exception StopAsyncIteration¶

Должен быть вызван методом __anext__() объекта asynchronous iterator, чтобы остановить итерацию.

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

exception SyntaxError(message, details)¶

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

str() экземпляра exception возвращает только сообщение об ошибке. Details - это кортеж, члены которого также доступны в виде отдельных атрибутов.

filename¶

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

lineno¶

В каком номере строки файла произошла ошибка. Эта строка имеет индекс 1: первая строка в файле имеет значение lineno, равное 1.

offset¶

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

text¶

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

end_lineno¶

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

end_offset¶

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

Для ошибок в полях f-string сообщение имеет префикс «f-string: «, а смещения - это смещения в тексте, построенном на основе заменяющего выражения. Например, компиляция f’Bad {a b} field“ приводит к такому атрибуту args: („f-строка: …“, (», 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¶

Вызывается, когда при переводе возникает ошибка, связанная с Юникодом. Это подкласс 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 Development Mode отображается это предупреждение.

Политика амортизации описана в разделе PEP 387.

exception PendingDeprecationWarning¶

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

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

Игнорируется фильтрами предупреждений по умолчанию. При включении параметра Python Development Mode отображается это предупреждение.

Политика амортизации описана в разделе PEP 387.

exception SyntaxWarning¶

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

exception RuntimeWarning¶

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

exception FutureWarning¶

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

exception ImportWarning¶

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

Игнорируется фильтрами предупреждений по умолчанию. При включении параметра Python Development Mode отображается это предупреждение.

exception UnicodeWarning¶

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

exception EncodingWarning¶

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

Более подробную информацию смотрите в разделе Предупреждение о включенном кодировании.

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

exception BytesWarning¶

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

exception ResourceWarning¶

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

Игнорируется фильтрами предупреждений по умолчанию. При включении параметра Python Development Mode отображается это предупреждение.

Добавлено в версии 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)¶

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

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

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

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

split(condition)¶

Как subgroup(), но возвращает пару (match, rest), где match - это subgroup(condition), а 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__(). Например, в приведенном ниже примере определяется подкласс exception group, который принимает код 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.

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

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