> **Источник:** https://python-all.ru/3.7/library/zipimport.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # [`zipimport`](https://python-all.ru/3.7/library/zipimport.html#module-zipimport) – Импорт модулей из Zip-архивов --- Этот модуль добавляет возможность импортировать модули Python (`*.py`, `*.pyc`) и пакеты из архивов формата ZIP. Обычно нет необходимости использовать модуль [`zipimport`](https://python-all.ru/3.7/library/zipimport.html#module-zipimport) явно; он автоматически используется встроенным механизмом [`import`](https://python-all.ru/3.7/reference/simple_stmts.html#import) для элементов [`sys.path`](https://python-all.ru/3.7/library/sys.html#sys.path), являющихся путями к ZIP-архивам. Обычно [`sys.path`](https://python-all.ru/3.7/library/sys.html#sys.path) – это список имён каталогов в виде строк. Этот модуль также позволяет элементу [`sys.path`](https://python-all.ru/3.7/library/sys.html#sys.path) быть строкой, именующей ZIP-архив. ZIP-архив может содержать структуру подкаталогов для поддержки импорта пакетов, и можно указать путь внутри архива для импорта только из подкаталога. Например, путь `example.zip/lib/` будет импортировать только из подкаталога `lib/` внутри архива. В ZIP-архиве могут присутствовать любые файлы, но для импорта доступны только файлы `.py` и `.pyc`. Импорт динамических модулей (`.pyd`, `.so`) из ZIP-архивов запрещён. Обратите внимание: если архив содержит только `.py` файлов, Python не будет пытаться изменить архив, добавляя соответствующий файл `.pyc`; это означает, что если в ZIP-архиве нет файлов `.pyc`, импорт может быть довольно медленным. ZIP-архивы с комментарием архива в настоящее время не поддерживаются. > **См. также** > > **[Примечание по применению PKZIP](https://python-all.ru/3.7/library/zipimport.html)** > > Документация по формату ZIP-файлов от Фила Каца, создателя формата и используемых алгоритмов. > > **[**PEP 273**](https://python-all.ru/3.7/library/zipimport.html) – Импорт модулей из Zip-архивов** > > Написан Джеймсом С. Альстромом, который также предоставил реализацию. Python 2.3 соответствует спецификации PEP 273, но использует реализацию, написанную Юстом ван Россумом, которая использует хуки импорта, описанные в PEP 302. > > **[**PEP 302**](https://python-all.ru/3.7/library/zipimport.html) – новые хуки импорта** > > PEP, добавляющий хуки импорта, которые помогают этому модулю работать. Этот модуль определяет исключение: #### `exception zipimport.ZipImportError` Исключение, вызываемое объектами zipimporter. Оно является подклассом [`ImportError`](https://python-all.ru/3.7/library/exceptions.html#ImportError), поэтому его можно перехватывать также как [`ImportError`](https://python-all.ru/3.7/library/exceptions.html#ImportError). ## Объекты zipimporter [`zipimporter`](https://python-all.ru/3.7/library/zipimport.html#zipimport.zipimporter) – это класс для импорта ZIP-файлов. #### `class zipimport.zipimporter(archivepath)` Создаёт новый экземпляр zipimporter. *archivepath* должен быть путём к ZIP-файлу или к конкретному пути внутри ZIP-файла. Например, *archivepath* со значением `foo/bar.zip/lib` будет искать модули в каталоге `lib` внутри ZIP-файла `foo/bar.zip` (при условии, что он существует). [`ZipImportError`](https://python-all.ru/3.7/library/zipimport.html#zipimport.ZipImportError) возбуждается, если *archivepath* не указывает на валидный ZIP-архив. #### `find_module(fullname[, path])` Ищет модуль, заданный параметром *fullname*. *fullname* должно быть полностью квалифицированным (точечным) именем модуля. Возвращает сам экземпляр zipimporter, если модуль найден, или [`None`](https://python-all.ru/3.7/library/constants.html#None) в противном случае. Необязательный аргумент *path* игнорируется – он предусмотрен для совместимости с протоколом импортера. #### `get_code(fullname)` Возвращает объект кода для указанного модуля. Возбуждает [`ZipImportError`](https://python-all.ru/3.7/library/zipimport.html#zipimport.ZipImportError), если модуль не найден. #### `get_data(pathname)` Возвращает данные, связанные с *pathname*. Возбуждает [`OSError`](https://python-all.ru/3.7/library/exceptions.html#OSError), если файл не найден. Изменено в версии 3.3: [`IOError`](https://python-all.ru/3.7/library/exceptions.html#IOError) раньше вызывалось вместо [`OSError`](https://python-all.ru/3.7/library/exceptions.html#OSError). #### `get_filename(fullname)` Возвращает значение, которое `__file__` получило бы, если бы указанный модуль был импортирован. Возбуждает [`ZipImportError`](https://python-all.ru/3.7/library/zipimport.html#zipimport.ZipImportError), если модуль не найден. Новое в версии 3.1. #### `get_source(fullname)` Возвращает исходный код указанного модуля. Вызывает [`ZipImportError`](https://python-all.ru/3.7/library/zipimport.html#zipimport.ZipImportError), если модуль не найден, возвращает [`None`](https://python-all.ru/3.7/library/constants.html#None), если архив содержит модуль, но без исходного кода. #### `is_package(fullname)` Возвращает `True`, если модуль, указанный в *fullname*, является пакетом. Вызывает [`ZipImportError`](https://python-all.ru/3.7/library/zipimport.html#zipimport.ZipImportError), если модуль не найден. #### `load_module(fullname)` Загружает модуль, указанный в *fullname*. *fullname* должно быть полностью определённым (с точками) именем модуля. Возвращает импортированный модуль или возбуждает [`ZipImportError`](https://python-all.ru/3.7/library/zipimport.html#zipimport.ZipImportError), если он не найден. #### `archive` Имя файла ZIP-архива, связанного с импортёром, без возможного подпути. #### `prefix` Подпуть внутри ZIP-файла, где ищутся модули. Для объектов zipimporter, указывающих на корень ZIP-файла, это пустая строка. Атрибуты [`archive`](https://python-all.ru/3.7/library/zipimport.html#zipimport.zipimporter.archive) и [`prefix`](https://python-all.ru/3.7/library/zipimport.html#zipimport.zipimporter.prefix), если их объединить через косую черту, равны исходному аргументу *archivepath*, переданному конструктору [`zipimporter`](https://python-all.ru/3.7/library/zipimport.html#zipimport.zipimporter). ## Примеры Вот пример импорта модуля из ZIP-архива – обратите внимание, что модуль [`zipimport`](https://python-all.ru/3.7/library/zipimport.html#module-zipimport) явно не используется. ```console $ unzip -l example.zip Archive: example.zip Length Date Time Name -------- ---- ---- ---- 8467 11-26-02 22:30 jwzthreading.py -------- ------- 8467 1 file $ ./python Python 2.3 (#1, Aug 1 2003, 19:54:32) >>> import sys >>> sys.path.insert(0, 'example.zip') # Add .zip file to front of path >>> import jwzthreading >>> jwzthreading.__file__ 'example.zip/jwzthreading.py' ```