tarfile — Чтение и запись архивов tar

Объекты TarFile

Объект TarFile предоставляет интерфейс к архиву tar. Архив tar представляет собой последовательность блоков. Член архива (сохранённый файл) состоит из заголовочного блока, за которым следуют блоки данных. Файл может быть сохранён в архиве tar несколько раз. Каждый член архива представлен объектом TarInfo, см. Объекты TarInfo для подробностей.

Объект TarFile может использоваться как менеджер контекста в операторе with. Он будет автоматически закрыт по завершении блока. Обратите внимание, что в случае возникновения исключения открытый для записи архив не будет завершён; только внутренний используемый объект файла будет закрыт. См. раздел Примеры для примера использования.

class tarfile.TarFile(name=None, mode='r', fileobj=None, format=DEFAULT_FORMAT, tarinfo=TarInfo, dereference=False, ignore_zeros=False, encoding=ENCODING, errors='surrogateescape', pax_headers=None, debug=0, errorlevel=1)

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

name — путь к архиву. name может быть объектом, подобным пути. Его можно опустить, если указан fileobj. В этом случае используется атрибут name объекта файла, если он существует.

mode может быть 'r' для чтения из существующего архива, 'a' для добавления данных в существующий файл, 'w' для создания нового файла, перезаписывая существующий, или 'x' для создания нового файла только в случае его отсутствия.

Если указан fileobj, он используется для чтения или записи данных. Если это возможно, mode переопределяется режимом fileobj. fileobj будет использоваться с позиции 0.

Примечание

fileobj не закрывается, когда TarFile закрывается.

format управляет форматом архива для записи. Он должен быть одним из констант USTAR_FORMAT, GNU_FORMAT или PAX_FORMAT, определённых на уровне модуля. При чтении формат будет автоматически определён, даже если в одном архиве присутствуют разные форматы.

Аргумент tarinfo может использоваться для замены стандартного класса TarInfo другим классом.

Если dereference имеет значение False, символические и жёсткие ссылки добавляются в архив. Если True, в архив добавляется содержимое целевых файлов. Это не имеет эффекта на системах, не поддерживающих символические ссылки.

Если ignore_zeros имеет значение False, пустой блок рассматривается как конец архива. Если True, пустые (и некорректные) блоки пропускаются, и попытка получить как можно больше членов архива будет продолжена. Это полезно только для чтения конкатенированных или повреждённых архивов.

debug может быть установлен от 0 (без сообщений отладки) до 3 (все сообщения отладки). Сообщения записываются в sys.stderr.

errorlevel контролирует обработку ошибок извлечения, см. the corresponding attribute.

Аргументы encoding и errors определяют кодировку символов, используемую для чтения или записи архива, и то, как обрабатывать ошибки преобразования. Значения по умолчанию подойдут большинству пользователей. Подробная информация находится в разделе Проблемы с кодировкой Unicode.

Аргумент pax_headers — это необязательный словарь строк, который будет добавлен в глобальный заголовок pax, если format равен PAX_FORMAT.

Изменено в версии 3.2: Используется 'surrogateescape' в качестве значения по умолчанию для аргумента errors.

Изменено в версии 3.5: Добавлен режим 'x' (исключительное создание).

Изменено в версии 3.6: Параметр name принимает объект, подобный пути.

classmethod TarFile.open(...)

Альтернативный конструктор. Функция tarfile.open() на самом деле является сокращением для этого метода класса.

TarFile.getmember(name)

Возвращает объект TarInfo для члена name. Если name не найден в архиве, возникает KeyError.

Примечание

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

TarFile.getmembers()

Возвращает члены архива в виде списка объектов TarInfo. Список отсортирован по порядку членов в архиве.

TarFile.getnames()

Возвращает члены как список их имён. Список отсортирован по порядку, аналогичному порядку списка, возвращаемого методом getmembers().

TarFile.list(verbose=True, *, members=None)

Выводит таблицу содержимого в sys.stdout. Если verbose имеет значение False, выводятся только имена членов. Если True, вывод подобен выводу команды ls -l. Если задан необязательный параметр members, он должен быть подмножеством списка, возвращаемого методом getmembers().

Изменено в версии 3.5: Добавлен параметр members.

TarFile.next()

Возвращает следующего члена архива в виде объекта TarInfo, когда TarFile открыт для чтения. Возвращает None, если больше нет элементов.

TarFile.extractall(path='.', members=None, *, numeric_owner=False, filter=None)

Извлекает все члены из архива в текущий рабочий каталог или каталог path. Если задан необязательный параметр members, он должен быть подмножеством списка, возвращаемого методом getmembers(). Информация о каталоге, такая как владелец, время последнего изменения и права доступа, устанавливается после извлечения всех членов. Это сделано для решения двух проблем: время последнего изменения каталога сбрасывается каждый раз, когда в нём создаётся файл; и если права доступа к каталогу не позволяют записи, извлечение файлов в него завершится неудачей.

Если numeric_owner равен True, для установки владельца/группы извлечённых файлов используются номера uid и gid из файла tar. В противном случае используются именованные значения из файла tar.

Аргумент filter определяет, как members изменяются или отклоняются перед извлечением. Подробности см. в разделе Фильтры извлечения. Рекомендуется явно установить это значение в зависимости от необходимых функций tar.

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

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

Установите filter='data' для предотвращения наиболее опасных проблем безопасности и прочитайте раздел Фильтры извлечения для подробностей.

Изменено в версии 3.5: Добавлен параметр numeric_owner.

Изменено в версии 3.6: Параметр path принимает объект, подобный пути.

Изменено в версии 3.12: Добавлен параметр filter.

TarFile.extract(member, path='', set_attrs=True, *, numeric_owner=False, filter=None)

Извлечь член из архива в текущую рабочую директорию, используя его полное имя. Информация о файле извлекается максимально точно. member может быть именем файла или объектом TarInfo. Вы можете указать другую директорию с помощью path. path может быть объектом, подобным пути. Атрибуты файла (владелец, время изменения, режим) устанавливаются, если set_attrs не равно false.

Аргументы numeric_owner и filter аналогичны аргументам метода extractall().

Примечание

Метод extract() не обрабатывает несколько проблем с извлечением. В большинстве случаев следует использовать метод extractall().

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

См. предупреждение для метода extractall().

Установите filter='data' для предотвращения наиболее опасных проблем безопасности и ознакомьтесь с разделом Фильтры извлечения для получения подробной информации.

Изменено в версии 3.2: Добавлен параметр set_attrs.

Изменено в версии 3.5: Добавлен параметр numeric_owner.

Изменено в версии 3.6: Параметр path принимает объект, подобный пути.

Изменено в версии 3.12: Добавлен параметр filter.

TarFile.extractfile(member)

Извлечь член из архива как объект файла. member может быть именем файла или объектом TarInfo. Если member является обычным файлом или ссылкой, возвращается объект io.BufferedReader. Для всех других существующих членов возвращается None. Если member не встречается в архиве, возникает исключение KeyError.

Изменено в версии 3.3: Возвращается объект io.BufferedReader.

TarFile.errorlevel: int

Если errorlevel равно 0, ошибки игнорируются при использовании методов TarFile.extract() и TarFile.extractall(). Тем не менее, они отображаются в сообщениях об ошибках в отладочном выводе, когда debug больше 0. Если 1 (значение по умолчанию), все ошибки генерируют исключения OSError или FilterError. Если 2, все неошибки генерируют исключения TarError также.

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

Пользовательские фильтры извлечения должны генерировать исключение FilterError для ошибок и ExtractError для неошибок.

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

TarFile.extraction_filter

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

Фильтр извлечения, используемый по умолчанию для параметра filter методов extract() и extractall().

Атрибут может быть None или вызываемой функцией. Имена строк для этого атрибута не разрешены, в отличие от параметра filter метода extract().

Если extraction_filter равно None (значение по умолчанию), вызов метода извлечения без параметра filter приведет к исключению DeprecationWarning, и воспользуется фильтром fully_trusted, поведение которого соответствует предыдущим версиям Python.

В Python 3.14+ пропуск extraction_filter=None приведет к использованию фильтра data по умолчанию.

Атрибут можно установить для экземпляров или переопределить в подклассах. Также можно установить его для класса TarFile для установки глобального значения по умолчанию, хотя, так как это влияет на все использования tarfile, лучше всего использовать это только в приложениях верхнего уровня или site configuration. Для установки глобального значения по умолчанию таким образом, функция фильтра должна быть обернута в staticmethod() для предотвращения ввода self аргумента.

TarFile.add(name, arcname=None, recursive=True, *, filter=None)

Добавить файл name в архив. name может быть любым типом файла (каталог, FIFO, символическая ссылка и т.д.). Если задано, arcname указывает альтернативное имя файла в архиве. Каталоги добавляются рекурсивно по умолчанию. Это можно избежать, установив recursive в False. Рекурсия добавляет записи в отсортированном порядке. Если задан filter, он должен быть функцией, которая принимает объект TarInfo в качестве аргумента и возвращает измененный объект TarInfo. Если вместо этого он возвращает None, объект TarInfo будет исключён из архива. Пример см. в разделе Примеры.

Изменено в версии 3.2: Добавлен параметр filter.

Изменено в версии 3.7: Рекурсия добавляет записи в отсортированном порядке.

TarFile.addfile(tarinfo, fileobj=None)

Добавить объект TarInfo tarinfo в архив. Если задан fileobj, он должен быть бинарным файлом, и tarinfo.size байтов будут считаны из него и добавлены в архив. Вы можете создавать объекты TarInfo напрямую или с помощью метода gettarinfo().

TarFile.gettarinfo(name=None, arcname=None, fileobj=None)

Создайте объект TarInfo из результата вызова os.stat() или эквивалентной функции для существующего файла. Файл может быть указан именем name или как объект файла fileobj с дескриптором файла. name может быть объектом пути. Если задано, arcname указывает альтернативное имя файла в архиве, в противном случае имя берётся из атрибута name объекта fileobj или аргумента name. Имя должно быть строкой.

Вы можете изменить некоторые атрибуты объекта TarInfo перед добавлением его с помощью addfile(). Если объект файла не является обычным файловым объектом, расположенным в начале файла, возможно потребуется изменить атрибуты, такие как size. Это необходимо для объектов, таких как GzipFile. Атрибут name также может быть изменён, в этом случае arcname может быть строкой-заглушкой.

Изменено в версии 3.6: Параметр name принимает объект пути.

TarFile.close()

Закрыть TarFile. В режиме записи в архив добавляются два завершающих нулевых блока.

TarFile.pax_headers: dict

Словарь, содержащий пары ключ-значение глобальных заголовков pax.

Объекты TarInfo

Объект TarInfo представляет собой один член в TarFile. Помимо хранения всех необходимых атрибутов файла (например, тип файла, размер, время, разрешения, владелец и т.д.), он предоставляет некоторые полезные методы для определения его типа. Он не содержит сами данные файла.

Объекты TarInfo возвращаются методами TarFile getmember(), getmembers() и gettarinfo().

Изменение объектов, возвращаемых getmember() или getmembers(), повлияет на все последующие операции с архивом. В тех случаях, когда этого нежелательно, вы можете использовать copy.copy() или вызвать метод replace() для создания изменённой копии одним шагом.

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

• Методы extract() или extractall() проигнорируют соответствующие метаданные, оставив их установленным по умолчанию.
• addfile() завершится ошибкой.
• list() выведет строку-заполнитель.

class tarfile.TarInfo(name='')

Создать объект TarInfo.

classmethod TarInfo.frombuf(buf, encoding, errors)

Создать и вернуть объект TarInfo из строкового буфера buf.

Возбуждает HeaderError, если буфер некорректен.

classmethod TarInfo.fromtarfile(tarfile)

Прочитать следующий член из объекта TarFile tarfile и вернуть его как объект TarInfo.

TarInfo.tobuf(format=DEFAULT_FORMAT, encoding=ENCODING, errors='surrogateescape')

Создать строковый буфер из объекта TarInfo. Для получения информации об аргументах см. конструктор класса TarFile.

Изменено в версии 3.2: Используется 'surrogateescape' в качестве значения по умолчанию для аргумента errors.

Объект TarInfo имеет следующие публичные атрибуты данных:

TarInfo.name: str

Имя члена архива.

TarInfo.size: int

Размер в байтах.

TarInfo.mtime: int | float

Время последнего изменения в секундах с момента эпохи, как в os.stat_result.st_mtime.

Изменено в версии 3.12: Может быть установлено в None для extract() и extractall(), вызывая пропуск применения этого атрибута при извлечении.

TarInfo.mode: int

Биты разрешений, как в os.chmod().

Изменено в версии 3.12: Может быть установлено в None для extract() и extractall(), вызывая пропуск применения этого атрибута при извлечении.

TarInfo.type

Тип файла. type обычно является одним из этих констант: REGTYPE, AREGTYPE, LNKTYPE, SYMTYPE, DIRTYPE, FIFOTYPE, CONTTYPE, CHRTYPE, BLKTYPE, GNUTYPE_SPARSE. Для более удобного определения типа объекта TarInfo используйте методы is*() ниже.

TarInfo.linkname: str

Имя целевого файла, присутствующее только в объектах TarInfo типа LNKTYPE и SYMTYPE.

Для символических ссылок (SYMTYPE), linkname относительн к каталогу, содержащему ссылку. Для жёстких ссылок (LNKTYPE), linkname относительн к корню архива.

TarInfo.uid: int

Идентификатор пользователя, хранивший этот член.

Изменено в версии 3.12: Может быть установлено в None для extract() и extractall(), вызывая пропуск применения этого атрибута при извлечении.

TarInfo.gid: int

Идентификатор группы пользователя, хранивший этот член.

Изменено в версии 3.12: Может быть установлено в None для extract() и extractall(), вызывая пропуск применения этого атрибута при извлечении.

TarInfo.uname: str

Имя пользователя.

Изменено в версии 3.12: Может быть установлено в None для extract() и extractall(), вызывая пропуск применения этого атрибута при извлечении.

TarInfo.gname: str

Имя группы.

Изменено в версии 3.12: Может быть установлено в None для extract() и extractall(), вызывая пропуск применения этого атрибута при извлечении.

TarInfo.chksum: int

Контрольная сумма заголовка.

TarInfo.devmajor: int

Главный номер устройства.

TarInfo.devminor: int

Номер младшего устройства.

TarInfo.offset: int

Здесь начинается заголовок tar.

TarInfo.offset_data: int

Здесь начинается данные файла.

TarInfo.sparse

Информация о разряженном члене.

TarInfo.pax_headers: dict

Словарь, содержащий пары ключ-значение связанного расширенного заголовка pax.

TarInfo.replace(name=..., mtime=..., mode=..., linkname=..., uid=..., gid=..., uname=..., gname=..., deep=True)

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

Возвращает новую копию объекта TarInfo с изменёнными указанными атрибутами. Например, чтобы вернуть объект TarInfo с именем группы, установленным в 'staff', используйте:

new_tarinfo = old_tarinfo.replace(gname='staff')

По умолчанию создаётся глубокая копия. Если deep ложно, копия является неглубокой, т.е. pax_headers и любые пользовательские атрибуты совместно используются с исходным объектом TarInfo.

Объект TarInfo также предоставляет некоторые удобные методы запроса:

TarInfo.isfile()

Возвращает True, если объект TarInfo является обычным файлом.

TarInfo.isreg()

То же, что и isfile().

TarInfo.isdir()

Возвращает True, если это каталог.

TarInfo.issym()

Возвращает True, если это символическая ссылка.

TarInfo.islnk()

Возвращает True, если это жёсткая ссылка.

TarInfo.ischr()

Возвращает True, если это символьное устройство.

TarInfo.isblk()

Возвращает True, если это блочное устройство.

TarInfo.isfifo()

Возвращает True, если это FIFO.

TarInfo.isdev()

Возвращает True, если это символьное устройство, блочное устройство или FIFO.

Фильтры извлечения

Формат tar разработан для захвата всех деталей файловой системы, похожей на UNIX, что делает его очень мощным. К сожалению, функции позволяют создавать файлы tar, которые при извлечении имеют непреднамеренные — и, возможно, злонамеренные — последствия. Например, извлечение файла tar может перезаписать произвольные файлы различными способами (например, с помощью абсолютных путей, компонентов пути .. или символьных ссылок, влияющих на последующие члены).

В большинстве случаев полная функциональность не требуется. Поэтому tarfile поддерживает фильтры извлечения: механизм ограничения функциональности и, таким образом, смягчения некоторых проблем безопасности.

Аргумент filter для TarFile.extract() или extractall() может быть:

• строкой 'fully_trusted': учитывать все метаданные, как указано в архиве. Следует использовать, если пользователь полностью доверяет архиву или реализует собственную сложную проверку.
• строкой 'tar': учитывать большинство функций, специфичных для tar (то есть функций файловых систем, похожих на UNIX), но блокировать функции, которые, скорее всего, будут неожиданными или злонамеренными. Подробности см. в tar_filter().
• строкой 'data': игнорировать или блокировать большинство функций, специфичных для файловых систем, похожих на UNIX. Предназначен для извлечения кроссплатформенных архивов данных. Подробности см. в data_filter().

• None (по умолчанию): использовать TarFile.extraction_filter.

  Если это также None (по умолчанию), вызовите DeprecationWarning, и переключитесь на фильтр 'fully_trusted', поведение которого соответствует предыдущим версиям Python.

  В Python 3.14 фильтр 'data' станет по умолчанию. Можно переключиться раньше; см. TarFile.extraction_filter.

• Функцию, которая вызывается для каждого извлекаемого члена с объектом TarInfo, описывающим член, и целевым путем для извлечения архива (то есть один и тот же путь используется для всех членов):

  filter(member: TarInfo, path: str, /) -> TarInfo | None
  

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

  • вернуть объект TarInfo, который будет использоваться вместо метаданных в архиве, или
  • вернуть None, в этом случае член будет пропущен, или
  • вызвать исключение для прерывания операции или пропуска члена, в зависимости от errorlevel. Обратите внимание, что при прерывании извлечения extractall() может оставить архив частично извлеченным. Он не пытается выполнить очистку.

Интерфейс командной строки

Модуль tarfile предоставляет простой интерфейс командной строки для взаимодействия с архивами tar.

Если вы хотите создать новый архив tar, укажите его имя после опции -c, а затем перечислите имя(а) файла(ов), которые должны быть включены:

$ python -m tarfile -c monty.tar  spam.txt eggs.txt

Также допустимо передать каталог:

$ python -m tarfile -c monty.tar life-of-brian_1979/

Если вы хотите извлечь архив tar в текущий каталог, используйте опцию -e:

$ python -m tarfile -e monty.tar

Вы также можете извлечь архив tar в другой каталог, передав имя каталога:

$ python -m tarfile -e monty.tar  other-dir/

Для просмотра списка файлов в архиве tar используйте опцию -l:

$ python -m tarfile -l monty.tar

Примеры

Как извлечь весь архив tar в текущий рабочий каталог:

import tarfile
tar = tarfile.open("sample.tar.gz")
tar.extractall(filter='data')
tar.close()

Как извлечь подмножество архива tar с помощью TarFile.extractall(), используя функцию-генератор вместо списка:

import os
import tarfile

def py_files(members):
    for tarinfo in members:
        if os.path.splitext(tarinfo.name)[1] == ".py":
            yield tarinfo

tar = tarfile.open("sample.tar.gz")
tar.extractall(members=py_files(tar))
tar.close()

Как создать неархивированный архив tar из списка имен файлов:

import tarfile
tar = tarfile.open("sample.tar", "w")
for name in ["foo", "bar", "quux"]:
    tar.add(name)
tar.close()

Тот же пример с использованием инструкции with:

import tarfile
with tarfile.open("sample.tar", "w") as tar:
    for name in ["foo", "bar", "quux"]:
        tar.add(name)

Как прочитать сжатый gzip архив tar и отобразить некоторые сведения о члене:

import tarfile
tar = tarfile.open("sample.tar.gz", "r:gz")
for tarinfo in tar:
    print(tarinfo.name, "is", tarinfo.size, "bytes in size and is ", end="")
    if tarinfo.isreg():
        print("a regular file.")
    elif tarinfo.isdir():
        print("a directory.")
    else:
        print("something else.")
tar.close()

Как создать архив и сбросить информацию о пользователе, используя параметр filter в TarFile.add():

import tarfile
def reset(tarinfo):
    tarinfo.uid = tarinfo.gid = 0
    tarinfo.uname = tarinfo.gname = "root"
    return tarinfo
tar = tarfile.open("sample.tar.gz", "w:gz")
tar.add("foo", filter=reset)
tar.close()

Поддерживаемые форматы tar

Модуль tarfile может создавать три формата tar:

• Формат ustar POSIX.1-1988 (USTAR_FORMAT). Поддерживает имена файлов длиной до 256 символов и имена ссылок до 100 символов. Максимальный размер файла составляет 8 ГБ. Это старый и ограниченный, но широко поддерживаемый формат.
• Формат GNU tar (GNU_FORMAT). Поддерживает длинные имена файлов и ссылок, файлы размером более 8 ГБ и разреженные файлы. Это фактический стандарт на системах GNU/Linux. tarfile полностью поддерживает расширения GNU tar для длинных имен, поддержка разреженных файлов только для чтения.

• Формат pax POSIX.1-2001 (PAX_FORMAT). Это наиболее гибкий формат практически без ограничений. Поддерживает длинные имена файлов и ссылок, большие файлы и хранит имена путей в переносимом формате. Современные реализации tar, включая GNU tar, bsdtar/libarchive и star, полностью поддерживают расширенные возможности pax; некоторые старые или не поддерживаемые библиотеки могут не поддерживать, но должны обрабатывать архивы pax так, как будто они находятся в универсально поддерживаемом формате ustar. Это текущий формат по умолчанию для новых архивов.

  Он расширяет существующий формат ustar дополнительными заголовками для информации, которая не может быть сохранена иначе. Существуют два типа заголовков pax: расширенные заголовки влияют только на последующий заголовок файла, глобальные заголовки действительны для всего архива и влияют на все последующие файлы. Все данные в заголовке pax закодированы в UTF-8 по соображениям переносимости.

Существуют и другие варианты формата tar, которые могут быть прочитаны, но не созданы:

• Древний формат V7. Это первый формат tar из Unix Seventh Edition, хранящий только обычные файлы и каталоги. Имена не должны быть длиннее 100 символов, информация о пользователе/группе отсутствует. Некоторые архивы имеют неправильно рассчитанные контрольные суммы заголовков в случае полей с символами, отличными от ASCII.
• Расширенный формат tar SunOS. Этот формат является вариантом формата pax POSIX.1-2001, но несовместим.

Проблемы с кодировкой Unicode

Формат tar изначально был задуман для создания резервных копий на ленточных накопителях с основным фокусом на сохранении информации о файловой системе. В настоящее время архивы tar часто используются для распространения файлов и обмена архивами через сети. Одна из проблем исходного формата (который является основой всех других форматов) заключается в том, что он не поддерживает различные кодировки символов. Например, обычный архив tar, созданный на системе UTF-8, не может быть правильно прочитан на системе Latin-1, если он содержит символы, отличные от ASCII. Текстовые метаданные (например, имена файлов, имена ссылок, имена пользователей/групп) будут отображаться поврежденными. К сожалению, нет способа автоматически определить кодировку архива. Формат pax был разработан для решения этой проблемы. Он хранит метаданные, отличные от ASCII, с использованием универсальной кодировки символов UTF-8.

Подробности преобразования символов в tarfile контролируются ключевыми аргументами encoding и errors класса TarFile.

encoding определяет кодировку символов для использования для метаданных в архиве. Значение по умолчанию — sys.getfilesystemencoding() или 'ascii' в качестве резервного варианта. В зависимости от того, читается или записывается архив, метаданные должны быть либо декодированы, либо закодированы. Если encoding не задан должным образом, это преобразование может завершиться ошибкой.

Аргумент errors определяет, как обрабатываются символы, которые нельзя преобразовать. Возможные значения перечислены в разделе Обработчики ошибок. Схема по умолчанию — 'surrogateescape', которую Python также использует для вызовов файловой системы, см. Имена файлов, аргументы командной строки и переменные среды.

Для архивов PAX_FORMAT (по умолчанию) encoding обычно не нужен, потому что все метаданные хранятся с помощью UTF-8. encoding используется только в редких случаях, когда декодируются двоичные заголовки pax или когда хранятся строки с символами-заместителями.