zipimport — Импорт модулей из ZIP-архивов

Исходный код: Lib/zipimport.py

Этот модуль добавляет возможность импортировать модули Python (*.py, *.pyc) и пакеты из архивов в формате ZIP. Обычно нет необходимости явно использовать модуль zipimport; он автоматически используется встроенным механизмом import для элементов sys.path, которые являются путями к ZIP-архивам.

Обычно sys.path — это список строк с именами каталогов. Этот модуль также позволяет использовать в качестве элемента sys.path строку с именем ZIP-архива. ZIP-архив может содержать структуру подкаталогов для поддержки импорта пакетов, а путь внутри архива можно указать так, чтобы импорт выполнялся только из подкаталога. Например, путь example.zip/lib/ будет выполнять импорт только из подкаталога lib/ внутри архива.

ZIP-архив может содержать любые файлы, но импортёры вызываются только для файлов .py и .pyc. Импорт динамических модулей из ZIP-архивов (.pyd, .so) запрещён. Обратите внимание: если архив содержит только файлы .py, Python не будет пытаться изменить архив, добавив соответствующий файл .pyc, а значит, если в ZIP-архиве нет файлов .pyc, импорт может выполняться довольно медленно.

Изменено в версии 3.13: Добавлена поддержка ZIP64

Изменено в версии 3.8: Ранее ZIP-архивы с комментарием не поддерживались.

См. также

Примечание к приложению PKZIP: Документация по формату ZIP, написанная Филом Кацем — создателем формата и используемых алгоритмов.
PEP 273 — Импорт модулей из Zip-архивов: Автор — Джеймс К. Алстром, который также предоставил реализацию. Python 2.3 соответствует спецификации из PEP 273, но использует реализацию Джаста ван Россума, основанную на хуках импорта, описанных в PEP 302.
importlib - The implementation of the import machinery: Пакет, предоставляющий соответствующие протоколы для реализации всеми импортёрами.

Этот модуль определяет исключение:

exception zipimport.ZipImportError: Исключение, вызываемое объектами zipimporter. Оно является подклассом ImportError, поэтому его также можно перехватить как ImportError.

Объекты zipimporter

zipimporter — это класс для импорта ZIP-файлов.

class zipimport.zipimporter(archivepath)

Создаёт новый экземпляр zipimporter. archivepath должен быть путём к ZIP-файлу или к определённому пути внутри ZIP-файла. Например, значение archivepath foo/bar.zip/lib указывает на поиск модулей в каталоге lib внутри ZIP-файла foo/bar.zip (если такой каталог существует).

Если archivepath не указывает на допустимый ZIP-архив, вызывается исключение ZipImportError.

Изменено в версии 3.12: Методы find_loader() и find_module(), объявленные устаревшими в версии 3.10, удалены. Вместо них используйте find_spec().

create_module(spec): Реализация importlib.abc.Loader.create_module(), возвращающая None для явного запроса семантики по умолчанию.

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

exec_module(module): Реализация importlib.abc.Loader.exec_module().

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

find_spec(fullname, target=None): Реализация importlib.abc.PathEntryFinder.find_spec().

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

get_code(fullname): Возвращает объект кода для указанного модуля. Если модуль не удалось импортировать, вызывает исключение ZipImportError.

get_data(pathname): Возвращает данные, связанные с pathname. Если файл не найден, вызывает исключение OSError.

Изменено в версии 3.3: Ранее вызывалось исключение IOError, теперь оно является псевдонимом OSError.

get_filename(fullname): Возвращает значение, которое было бы присвоено __file__ при импорте указанного модуля. Если модуль не удалось импортировать, вызывает исключение ZipImportError.

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

get_source(fullname): Возвращает исходный код указанного модуля. Если модуль не найден, вызывает исключение ZipImportError; если архив содержит модуль, но не содержит его исходный код, возвращает None.

is_package(fullname): Возвращает True, если модуль, указанный в fullname, является пакетом. Если модуль не найден, вызывает исключение ZipImportError.

load_module(fullname): Загружает модуль, указанный в fullname. fullname должно быть полным именем модуля (с точками). В случае успеха возвращает импортированный модуль, а в случае ошибки вызывает исключение ZipImportError.

Устарело начиная с версии 3.10: Вместо этого используйте exec_module().

invalidate_caches(): Очищает внутренний кеш сведений о файлах, найденных в ZIP-архиве.

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

archive: Имя файла связанного с импортёром ZIP-файла без возможного подкаталога.

prefix: Подкаталог внутри ZIP-файла, в котором выполняется поиск модулей. Для объектов zipimporter, указывающих на корень ZIP-файла, это пустая строка.

При объединении атрибутов archive и prefix через косую черту получается исходный аргумент archivepath, переданный конструктору zipimporter.

Примеры

Ниже приведён пример импорта модуля из ZIP-архива. Обратите внимание, что модуль zipimport явно не используется.

$ unzip -l example_archive.zip
Archive:  example_archive.zip
  Length     Date   Time    Name
 --------    ----   ----    ----
     8467  01-01-00 12:30   example.py
 --------                   -------
     8467                   1 file

>>> import sys
>>> # Add the archive to the front of the module search path
>>> sys.path.insert(0, 'example_archive.zip')
>>> import example
>>> example.__file__
'example_archive.zip/example.py'

© 2001–2025 Python Software Foundation
Licensed under the PSF License.
https://docs.python.org/3.13/library/zipimport.html