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, добавленный в Python 3.11.4, указывает, как members изменяются или отбрасываются перед извлечением. См. Фильтры извлечения для подробностей. Рекомендуется явно установить это значение в зависимости от того, какие возможности tar вам необходимо поддерживать.

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

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

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

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

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

Изменено в версии 3.11.4: Добавлен параметр 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.11.4: Добавлен параметр 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 (по умолчанию), все fatal ошибки генерируются как исключения OSError или FilterError. Если 2, все некритические ошибки генерируются как исключения TarError тоже.

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

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

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

TarFile.extraction_filter

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

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

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

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

В Python 3.12+ оставление extraction_filter=None выведет DeprecationWarning.

В 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

Словарь, содержащий пары ключ-значение глобальных заголовков 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.11.4: Может быть установлено в None для extract() и extractall(), что заставит извлечение пропустить применение этого атрибута.

TarInfo.mode: int

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

Изменено в версии 3.11.4: Может быть установлено в 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.11.4: Может быть установлено в None для extract() и extractall(), что заставит извлечение пропустить применение этого атрибута.

TarInfo.gid: int

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

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

TarInfo.uname: str

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

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

TarInfo.gname: str

Имя группы.

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

TarInfo.pax_headers: dict

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

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

Новое в версии 3.11.4.

Возвращает новую копию объекта 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 (по умолчанию), будет использован фильтр 'fully_trusted' (для совместимости со старыми версиями Python).

  В Python 3.12 значение по умолчанию будет выводить DeprecationWarning.

  В 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()
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 или хранятся строки с замещающими символами.