# `zipimport` — Import modules from Zip archives

Вихідний код: 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.15.0a0 (unreleased): Zstandard (zstd) compressed zip file entries are supported.

Змінено в версії 3.13: ZIP64 is supported

Змінено в версії 3.8: Раніше ZIP-архіви з архівним коментарем не підтримувалися.

Дивись також

Примітка до програми PKZIP

  Документація щодо формату файлу ZIP від Філа Каца, творця формату та використаних алгоритмів.

PEP 273 - імпортувати модулі з Zip-архівів

  Написав Джеймс К. Алстром, який також забезпечив реалізацію. Python 2.3 відповідає специфікації в PEP 273, але використовує реалізацію, написану Джастом ван Россумом, яка використовує хуки імпорту, описані в PEP 302.

`importlib` - Реалізація механізму імпорту

  Пакет із відповідними протоколами для впровадження всім імпортерам.

Цей модуль визначає виняток:

exception zipimport.ZipImportError

  Виняток викликано об’єктами zipimporter. Це підклас `ImportError`, тому його також можна перехопити як `ImportError`.

## Об’єкти zipimporter

`zipimporter` — це клас для імпорту ZIP-файлів.

class zipimport.zipimporter(archivepath)

  Створіть новий екземпляр zipimporter. архівний шлях має бути шляхом до ZIP-файлу або до певного шляху в ZIP-файлі. Наприклад, архівний шлях `foo/bar.zip/lib` шукатиме модулі в каталозі `lib` всередині ZIP-файлу `foo/bar.zip` (за умови, що воно існує).

  `ZipImportError` виникає, якщо архівний шлях не вказує на дійсний архів ZIP.

  Змінено в версії 3.12: Methods `find_loader()` and `find_module()`, deprecated in 3.10 are now removed. Use `find_spec()` instead.

  create_module(spec)

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

    Added in version 3.10.

  exec_module(module)

    Реалізація `importlib.abc.Loader.exec_module()`.

    Added in version 3.10.

  find_spec(fullname, target=None)

    Реалізація `importlib.abc.PathEntryFinder.find_spec()`.

    Added in version 3.10.

  get_code(fullname)

    Повертає об’єкт коду для зазначеного модуля. Викликати `ZipImportError`, якщо модуль не вдалося імпортувати.

  get_data(pathname)

    Повертає дані, пов’язані з шляхом. Викликати `OSError`, якщо файл не знайдено.

    Змінено в версії 3.3: `IOError` раніше викликався, тепер це псевдонім `OSError`.

  get_filename(fullname)

    Повернути значення `__file__` було б встановлено, якби вказаний модуль було імпортовано. Викликати `ZipImportError`, якщо модуль не вдалося імпортувати.

    Added in version 3.1.

  get_source(fullname)

    Повернути вихідний код для вказаного модуля. Викликати `ZipImportError`, якщо модуль не вдалося знайти, повернути `None`, якщо архів містить модуль, але не має джерела для нього.

  is_package(fullname)

    Повертає `True`, якщо модуль, визначений повним ім’ям, є пакетом. Викликати `ZipImportError`, якщо модуль не вдалося знайти.

  invalidate_caches()

    Очистіть внутрішній кеш інформації про файли, знайдені в архіві ZIP.

    Added in version 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'