Python 3.9+tarfileисключение

tarfile.LinkFallbackError

исключения

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

Синтаксис

except tarfile.LinkFallbackError as e: e.__context__

Где ссылку создать нельзя (например, нет прав на symlink в Windows), tarfile подменяет её копией члена-цели. Если цель сама не проходит фильтр на новом месте, распаковка отказывает этим исключением, а исходная причина лежит в __context__. Появилось в исправлениях безопасности июня 2025 года сразу в нескольких ветках — 3.9.23, 3.10.18, 3.11.13, 3.12.11 и 3.13.4, а в 3.14 есть с первого выпуска; в более ранних выпусках этих веток его нет, поэтому опираться на него стоит, лишь проверив hasattr.

Примеры

import tarfile
print(issubclass(tarfile.LinkFallbackError, tarfile.FilterError))  # → True
err = tarfile.LinkFallbackError(tarfile.TarInfo('link'), 'out/link')
print(err.tarinfo.name)  # → link

См. также

Частые ошибки

Открыть в полном глоссарииdocs.python.orgСообщить о неточности