> **Источник:** https://python-all.ru/2.7/library/zipfile.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # 12.4. [`zipfile`](https://python-all.ru/2.7/library/zipfile.html#module-zipfile) – Работа с ZIP-архивами Новое в версии 1.6. **Исходный код:** [Lib/zipfile.py](https://python-all.ru/src/2.7/Lib/zipfile.py) --- Формат ZIP – распространённый стандарт архивации и сжатия. Этот модуль предоставляет инструменты для создания, чтения, записи, добавления и просмотра содержимого ZIP-файлов. Любое продвинутое использование модуля требует понимания формата, описанного в [PKZIP Application Note](https://python-all.ru/2.7/library/zipfile.html). Этот модуль в настоящее время не поддерживает многодисковые ZIP-файлы. Он может обрабатывать ZIP-файлы, использующие расширения ZIP64 (то есть ZIP-файлы размером более 4 Гбайт). Он поддерживает дешифрование зашифрованных файлов в ZIP-архивах, но в настоящее время не может создать зашифрованный файл. Дешифрование выполняется крайне медленно, так как реализовано на чистом Python, а не на C. Модуль определяет следующие элементы: #### `exception zipfile.BadZipfile` Исключение, возникающее при повреждённых ZIP-файлах (старое название: `zipfile.error`). #### `exception zipfile.LargeZipFile` Исключение, возникающее, когда ZIP-файлу требуется функциональность ZIP64, но она не включена. #### `class zipfile.ZipFile` Класс для чтения и записи ZIP-файлов. Подробнее о конструкторе см. раздел [Объекты ZipFile](https://python-all.ru/2.7/library/zipfile.html#zipfile-objects). #### `class zipfile.PyZipFile` Класс для создания ZIP-архивов, содержащих библиотеки Python. #### `class zipfile.ZipInfo([filename[, date_time]])` Класс для представления информации об элементе архива. Экземпляры этого класса возвращаются методами [`getinfo()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.getinfo) и [`infolist()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.infolist) объектов [`ZipFile`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile). Большинству пользователей модуля [`zipfile`](https://python-all.ru/2.7/library/zipfile.html#module-zipfile) не потребуется создавать их самостоятельно – достаточно использовать те, что созданы этим модулем. *filename* должен содержать полное имя элемента архива, а *date\_time* – кортеж из шести полей, описывающих время последнего изменения файла. Описание полей приведено в разделе [Объекты ZipInfo](https://python-all.ru/2.7/library/zipfile.html#zipinfo-objects). #### `zipfile.is_zipfile(filename)` Возвращает `True`, если *filename* является корректным ZIP-файлом (проверка по магическому числу), иначе возвращает `False`. *filename* может быть файлом или файлоподобным объектом. Изменено в версии 2.7: Поддержка файлов и файлоподобных объектов. #### `zipfile.ZIP_STORED` Числовая константа для несжатого элемента архива. #### `zipfile.ZIP_DEFLATED` Числовая константа для обычного метода сжатия ZIP. Для этого требуется модуль [`zlib`](https://python-all.ru/2.7/library/zlib.html#module-zlib). Другие методы сжатия в настоящее время не поддерживаются. > **См. также** > > **[Примечание по применению PKZIP](https://python-all.ru/2.7/library/zipfile.html)** > > Документация по формату ZIP-файлов от Фила Каца, создателя формата и используемых алгоритмов. > > **[Домашняя страница Info-ZIP](https://python-all.ru/2.7/library/zipfile.html)** > > Информация о программах для работы с ZIP-архивами и библиотеках для разработки проекта Info-ZIP. ## 12.4.1. Объекты ZipFile #### `class zipfile.ZipFile(file[, mode[, compression[, allowZip64]]])` Открывает ZIP-файл, где *file* может быть либо путём к файлу (строка), либо файлоподобным объектом. Параметр *mode* должен быть `'r'` для чтения существующего файла, `'w'` для усечения и записи нового файла, или `'a'` для добавления к существующему файлу. Если *mode* равен `'a'` и *file* ссылается на существующий ZIP-файл, то в него добавляются новые файлы. Если *file* не ссылается на ZIP-файл, то к файлу добавляется новый ZIP-архив. Это предназначено для добавления ZIP-архива в другой файл (такой как `python.exe`). Изменено в версии 2.6: Если *mode* равен `a` и файл вообще не существует, он создаётся. *compression* – метод сжатия ZIP, используемый при записи архива, и должен быть [`ZIP_STORED`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZIP_STORED) или [`ZIP_DEFLATED`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZIP_DEFLATED); нераспознанные значения вызовут [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). Если указан [`ZIP_DEFLATED`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZIP_DEFLATED), но модуль [`zlib`](https://python-all.ru/2.7/library/zlib.html#module-zlib) недоступен, также возникает [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). По умолчанию используется [`ZIP_STORED`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZIP_STORED). Если *allowZip64* равен `True`, zipfile будет создавать ZIP-файлы с расширениями ZIP64, когда размер zip-файла превышает 2 ГБ. Если значение false (по умолчанию), [`zipfile`](https://python-all.ru/2.7/library/zipfile.html#module-zipfile) вызовет исключение, когда ZIP-файл потребует расширений ZIP64. Расширения ZIP64 отключены по умолчанию, потому что стандартные команды **zip** и **unzip** в Unix (утилиты InfoZIP) не поддерживают эти расширения. Изменено в версии 2.7.1: Если файл создан с режимом `'a'` или `'w'`, а затем вызван [`closed`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.close) без добавления каких-либо файлов в архив, в файл будут записаны соответствующие структуры ZIP для пустого архива. ZipFile также является контекстным менеджером и поэтому поддерживает оператор [`with`](https://python-all.ru/2.7/reference/compound_stmts.html#with). В примере *myzip* закрывается после завершения блока оператора [`with`](https://python-all.ru/2.7/reference/compound_stmts.html#with) – даже если возникло исключение: ```python with ZipFile('spam.zip', 'w') as myzip: myzip.write('eggs.txt') ``` Новое в версии 2.7: Добавлена возможность использовать [`ZipFile`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile) в качестве менеджера контекста. #### `ZipFile.close()` Закрывает файл архива. Перед выходом из программы необходимо вызвать [`close()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.close), иначе важные записи не будут записаны. #### `ZipFile.getinfo(name)` Возвращает объект [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo) с информацией об элементе архива *name*. Вызов [`getinfo()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.getinfo) для имени, отсутствующего в архиве, приведёт к возникновению исключения [`KeyError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.KeyError). #### `ZipFile.infolist()` Возвращает список, содержащий объект [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo) для каждого элемента архива. Объекты расположены в том же порядке, что и их записи в реальном ZIP-файле на диске, если был открыт существующий архив. #### `ZipFile.namelist()` Возвращает список элементов архива по именам. #### `ZipFile.open(name[, mode[, pwd]])` Извлекает элемент из архива в виде файлоподобного объекта (ZipExtFile). *name* – это имя файла в архиве или объект [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo). Параметр *mode*, если указан, должен быть одним из следующих: `'r'` (по умолчанию), `'U'` или `'rU'`. Выбор `'U'` или `'rU'` включает поддержку [универсальных символов новой строки](https://python-all.ru/2.7/glossary.html#term-universal-newlines) в объекте только для чтения. *pwd* – пароль, используемый для зашифрованных файлов. Вызов [`open()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.open) на закрытом ZipFile вызовет [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). > **Примечание** > > Объект, подобный файлу, доступен только для чтения и предоставляет следующие методы: [`read()`](https://python-all.ru/2.7/library/stdtypes.html#file.read), [`readline()`](https://python-all.ru/2.7/library/stdtypes.html#file.readline), [`readlines()`](https://python-all.ru/2.7/library/stdtypes.html#file.readlines), [`__iter__()`](https://python-all.ru/2.7/reference/datamodel.html#object.__iter__), `next()`. > **Примечание** > > Если ZipFile был создан передачей файлоподобного объекта в качестве первого аргумента конструктора, то объект, возвращаемый [`open()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.open), разделяет файловый указатель ZipFile. В таких условиях объект, возвращаемый [`open()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.open), не должен использоваться после выполнения любых дополнительных операций над объектом ZipFile. Если ZipFile был создан передачей строки (имени файла) в качестве первого аргумента конструктора, то [`open()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.open) создаст новый файловый объект, который будет удерживаться ZipExtFile, что позволяет ему работать независимо от ZipFile. > **Примечание** > > Методы [`open()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.open), [`read()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.read) и [`extract()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.extract) могут принимать имя файла или объект [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo). Это пригодится при попытке чтения ZIP-файла, содержащего элементы с повторяющимися именами. Новое в версии 2.6. #### `ZipFile.extract(member[, path[, pwd]])` Извлекает элемент из архива в текущий рабочий каталог; *member* должно быть его полным именем или объектом [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo)). Информация о файле извлекается максимально точно. *path* указывает другой каталог для извлечения. *member* может быть именем файла или объектом [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo). *pwd* – пароль, используемый для зашифрованных файлов. Возвращает нормализованный путь (каталог или новый файл). Новое в версии 2.6. > **Примечание** > > Если имя файла элемента является абсолютным путём, диск/UNC-точка и начальные (обратные) слеши будут удалены, например: `///foo/bar` становится `foo/bar` на Unix, а `C:\foo\bar` становится `foo\bar` на Windows. Все компоненты `".."` в имени файла элемента будут удалены, например: `../../foo../../ba..r` становится `foo../ba..r`. На Windows недопустимые символы (`:`, `<`, `>`, `|`, `"`, `?` и `*`) заменяются подчёркиванием (`_`). #### `ZipFile.extractall([path[, members[, pwd]]])` Извлекает все элементы из архива в текущую рабочую директорию. *path* задаёт другую директорию для извлечения. *members* – необязательный параметр, должен быть подмножеством списка, возвращаемого [`namelist()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.namelist). *pwd* – пароль для зашифрованных файлов. > **Предупреждение** > > Никогда не извлекайте архивы из ненадёжных источников без предварительной проверки. Возможно создание файлов за пределами *path*, например, элементов с абсолютными именами, начинающимися с `"/"`, или с именами, содержащими две точки `".."`. Изменено в версии 2.7.4: Модуль zipfile пытается предотвратить это. См. примечание [`extract()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.extract). Новое в версии 2.6. #### `ZipFile.printdir()` Выводит оглавление архива в `sys.stdout`. #### `ZipFile.setpassword(pwd)` Устанавливает *pwd* в качестве пароля по умолчанию для извлечения зашифрованных файлов. Новое в версии 2.6. #### `ZipFile.read(name[, pwd])` Возвращает байты файла *name* из архива. *name* – имя файла в архиве или объект [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo). Архив должен быть открыт для чтения или добавления. *pwd* – пароль, используемый для зашифрованных файлов; если указан, он переопределяет пароль по умолчанию, заданный с помощью [`setpassword()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.setpassword). Вызов [`read()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.read) на закрытом ZipFile вызовет [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). Изменено в версии 2.6: Добавлен параметр *pwd*, и *name* теперь может быть объектом [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo). #### `ZipFile.testzip()` Читает все файлы в архиве и проверяет их CRC и заголовки файлов. Возвращает имя первого повреждённого файла или `None`. Вызов [`testzip()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.testzip) для закрытого ZipFile возбудит [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). #### `ZipFile.write(filename[, arcname[, compress_type]])` Записывает файл с именем *filename* в архив, присваивая ему архивное имя *arcname* (по умолчанию оно будет таким же, как *filename*, но без буквы диска и с удалёнными начальными разделителями пути). Если указан, *compress\_type* переопределяет значение параметра *compression*, переданное конструктору для новой записи. Архив должен быть открыт в режиме `'w'` или `'a'` – вызов [`write()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.write) для ZipFile, созданного в режиме `'r'`, вызовет [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). Вызов [`write()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.write) на закрытом ZipFile вызовет [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). > **Примечание** > > Для ZIP-файлов не существует официальной кодировки имён файлов. Если у вас есть имена файлов в Юникоде, вы должны преобразовать их в байтовые строки в нужной кодировке перед передачей в [`write()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.write). WinZip интерпретирует все имена файлов как закодированные в CP437, также известной как DOS Latin. > **Примечание** > > Архивные имена должны быть относительными по отношению к корню архива, то есть не должны начинаться с разделителя пути. > **Примечание** > > Если `arcname` (или `filename`, если `arcname` не указан) содержит нулевой байт, имя файла в архиве будет обрезано по этому байту. #### `ZipFile.writestr(zinfo_or_arcname, bytes[, compress_type])` Записывает строку *bytes* в архив; *zinfo\_or\_arcname* – это либо имя файла, которое будет присвоено в архиве, либо экземпляр [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo). Если это экземпляр, должны быть указаны как минимум имя файла, дата и время. Если это имя, дата и время устанавливаются в текущие дату и время. Архив должен быть открыт в режиме `'w'` или `'a'` – вызов [`writestr()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.writestr) для ZipFile, созданного в режиме `'r'`, вызовет [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). Вызов [`writestr()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.writestr) на закрытом ZipFile вызовет [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). Если указан, *compress\_type* переопределяет значение, заданное для параметра *compression* в конструкторе для новой записи, или в *zinfo\_or\_arcname* (если это экземпляр [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo)). > **Примечание** > > При передаче экземпляра [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo) в качестве параметра *zinfo\_or\_arcname* используемый метод сжатия будет тем, который указан в элементе *compress\_type* данного экземпляра [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo). По умолчанию конструктор [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo) устанавливает этот элемент в [`ZIP_STORED`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZIP_STORED). Изменено в версии 2.7: Аргумент *compress\_type*. Также доступны следующие атрибуты данных: #### `ZipFile.debug` Уровень отладочного вывода. Может быть установлен от `0` (по умолчанию, без вывода) до `3` (максимальный вывод). Отладочная информация записывается в `sys.stdout`. #### `ZipFile.comment` Текст комментария, связанный с ZIP-файлом. При назначении комментария экземпляру [`ZipFile`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile), созданному в режиме 'a' или 'w', это должна быть строка длиной не более 65535 байт. Комментарии длиннее этого будут усечены в записанном архиве при вызове [`close()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.close). ## 12.4.2. Объекты PyZipFile Конструктор [`PyZipFile`](https://python-all.ru/2.7/library/zipfile.html#zipfile.PyZipFile) принимает те же параметры, что и конструктор [`ZipFile`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile). Экземпляры имеют один дополнительный метод по сравнению с объектами [`ZipFile`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile). #### `PyZipFile.writepy(pathname[, basename])` Ищет файлы `*.py` и добавляет соответствующий файл в архив. Соответствующий файл – это файл `*.pyo`, если он доступен, иначе файл `*.pyc`, при необходимости компилируя. Если путь является файлом, имя файла должно заканчиваться на `.py`, и только (соответствующий) файл `*.py[co]` добавляется на верхний уровень (без информации о пути). Если путь является файлом, не заканчивающимся на `.py`, будет возбуждено [`RuntimeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.RuntimeError). Если это каталог, и каталог не является каталогом пакета, то все файлы `*.py[co]` добавляются на верхний уровень. Если каталог является каталогом пакета, то все `*.py[co]` добавляются под именем пакета как путь к файлу, и если какие-либо подкаталоги являются каталогами пакетов, все они добавляются рекурсивно. *basename* предназначен только для внутреннего использования. Метод [`writepy()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.PyZipFile.writepy) создаёт архивы с именами файлов, такими как: ```python string.pyc # Имя верхнего уровня test/__init__.pyc # Каталог пакета test/test_support.pyc # Модуль test.test_support test/bogus/__init__.pyc # Каталог подпакета test/bogus/myfile.pyc # Подмодуль test.bogus.myfile ``` ## 12.4.3. Объекты ZipInfo Экземпляры класса [`ZipInfo`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipInfo) возвращаются методами [`getinfo()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.getinfo) и [`infolist()`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile.infolist) объектов [`ZipFile`](https://python-all.ru/2.7/library/zipfile.html#zipfile.ZipFile). Каждый объект хранит информацию об одном элементе ZIP-архива. Экземпляры имеют следующие атрибуты: #### `ZipInfo.filename` Имя файла в архиве. #### `ZipInfo.date_time` Время и дата последнего изменения элемента архива. Это кортеж из шести значений: | Индекс | Значение | | --- | --- | | `0` | Год (\>= 1980) | | `1` | Месяц (начиная с 1) | | `2` | День месяца (начиная с 1) | | `3` | Часы (начиная с 0) | | `4` | Минуты (начиная с 0) | | `5` | Секунды (начиная с 0) | > **Примечание** > > Формат ZIP-файлов не поддерживает метки времени до 1980 года. #### `ZipInfo.compress_type` Тип сжатия для элемента архива. #### `ZipInfo.comment` Комментарий для отдельного элемента архива. #### `ZipInfo.extra` Данные поля расширения. В [Примечании к приложению PKZIP](https://python-all.ru/2.7/library/zipfile.html) содержатся комментарии о внутренней структуре данных, содержащихся в этой строке. #### `ZipInfo.create_system` Система, создавшая ZIP-архив. #### `ZipInfo.create_version` Версия PKZIP, создавшая ZIP-архив. #### `ZipInfo.extract_version` Версия PKZIP, необходимая для извлечения архива. #### `ZipInfo.reserved` Должно быть равно нулю. #### `ZipInfo.flag_bits` Биты флагов ZIP. #### `ZipInfo.volume` Номер тома заголовка файла. #### `ZipInfo.internal_attr` Внутренние атрибуты. #### `ZipInfo.external_attr` Внешние атрибуты файла. #### `ZipInfo.header_offset` Смещение в байтах до заголовка файла. #### `ZipInfo.CRC` CRC-32 несжатого файла. #### `ZipInfo.compress_size` Размер сжатых данных. #### `ZipInfo.file_size` Размер несжатого файла. ## 12.4.4. Интерфейс командной строки Модуль [`zipfile`](https://python-all.ru/2.7/library/zipfile.html#module-zipfile) предоставляет простой интерфейс командной строки для работы с ZIP-архивами. Чтобы создать новый ZIP-архив, укажите его имя после параметра [`-c`](https://python-all.ru/2.7/library/zipfile.html#cmdoption-zipfile-c) и перечислите имена файлов, которые нужно включить: ```console $ python -m zipfile -c monty.zip spam.txt eggs.txt ``` Можно также передать каталог: ```console $ python -m zipfile -c monty.zip life-of-brian_1979/ ``` Чтобы извлечь ZIP-архив в указанный каталог, используйте параметр [`-e`](https://python-all.ru/2.7/library/zipfile.html#cmdoption-zipfile-e): ```console $ python -m zipfile -e monty.zip target-dir/ ``` Для получения списка файлов в ZIP-архиве используйте параметр [`-l`](https://python-all.ru/2.7/library/zipfile.html#cmdoption-zipfile-l): ```console $ python -m zipfile -l monty.zip ``` ### 12.4.4.1. Параметры командной строки #### `-l ` Выводит список файлов в ZIP-архиве. #### `-c ... ` Создать zip-файл из исходных файлов. #### `-e ` Извлечь zip-файл в целевой каталог. #### `-t ` Проверить, корректен ли zip-файл.