zipimport — Importer des modules à partir d'archives Zip

Code source : Lib/zipimport.py


Ce module ajoute la possibilité d'importer des modules Python (*.py, *.pyc) et des paquets depuis des archives au format ZIP. Il n'est généralement pas nécessaire d'utiliser explicitement le module zipimport ; il est automatiquement utilisé par le mécanisme intégré de import pour les éléments de sys.path qui sont des chemins vers des archives ZIP.

En général, sys.path est une liste de noms de répertoires sous forme de chaînes. Ce module permet également à un élément de sys.path d'être une chaîne nommant une archive de fichier ZIP. L'archive peut contenir une arborescence de répertoires pour prendre en charge les importations de paquets, et un chemin dans l'archive peut être donné pour importer uniquement à partir d'un sous-répertoire. Par exemple, le chemin d'accès example.zip/lib/ importerait uniquement depuis le sous-répertoire lib/ dans l'archive.

Any files may be present in the ZIP archive, but importers are only invoked for .py and .pyc files. ZIP import of dynamic modules (.pyd, .so) is disallowed. Note that if an archive only contains .py files, Python will not attempt to modify the archive by adding the corresponding .pyc file, meaning that if a ZIP archive doesn't contain .pyc files, importing may be rather slow.

Modifié dans la version 3.8: auparavant, les archives ZIP avec un commentaire n'étaient pas prises en charge.

Voir aussi

PKZIP Application Note

Documentation sur le format de fichier ZIP par Phil Katz, créateur du format et des algorithmes utilisés.

PEP 273 — Importation de modules depuis des archives ZIP

Écrit par James C. Ahlstrom, qui a également fourni une mise en œuvre. Python 2.3 suit les spécifications de PEP 273, mais utilise une implémentation écrite par Just van Rossum qui utilise les crochets d'importation décrits dans PEP 302.

importlib — Implémentation du système d'importation

Paquet qui définit les protocoles que doivent implémenter tous les objets importateurs.

Ce module définit une exception :

exception zipimport.ZipImportError

Exception levée par les objets zipimporter. C'est une sous-classe de ImportError, donc elle peut être aussi interceptée comme une ImportError.

Objets zimporter

zipimporter est la classe pour importer des fichiers ZIP.

class zipimport.zipimporter(archivepath)

Classe d'objets qui importent depuis les archives. Dans le constructeur, archivepath doit être un chemin vers un fichier ZIP, éventuellement augmenté d'un chemin à l'intérieur de l'archive. Par exemple, un archivepath de foo/bar.zip/lib cherchera les modules dans le répertoire lib du fichier ZIP foo/bar.zip (à supposer que ce répertoire existe).

ZipImportError est levée si archivepath ne pointe pas vers une archive ZIP valide.

create_module(spec)

Implémentation de importlib.abc.Loader.create_module(). Elle renvoie toujours None, ce qui déclenche le mécanisme standard.

Nouveau dans la version 3.10.

exec_module(module)

Implémentation de importlib.abc.Loader.exec_module().

Nouveau dans la version 3.10.

find_loader(fullname, path=None)

Implémentation de importlib.abc.PathEntryFinder.find_loader().

Obsolète depuis la version 3.10: utilisez plutôt find_spec().

find_module(fullname, path=None)

Recherche un module spécifié par fullname, qui doit être le nom du module entièrement qualifié (avec des points). La valeur renvoyée est l'instance de zipimporter elle-même si le module a été trouvé, ou None si ce n'est pas le cas. L'argument optionnel path est ignoré ; il est là pour la compatibilité avec le protocole de l'importateur.

Obsolète depuis la version 3.10: utilisez plutôt find_spec().

find_spec(fullname, target=None)

Implémentation de importlib.abc.PathEntryFinder.find_spec().

Nouveau dans la version 3.10.

get_code(fullname)

Renvoie l'objet de code pour le module spécifié. Lève ZipImportError si l'importation a échoué.

get_data(pathname)

Renvoie les données associées à pathname. Lève OSError si le fichier n'a pas été trouvé.

Modifié dans la version 3.3: précédemment, c'était l'exception IOError qui était levée, au lieu de OSError.

get_filename(fullname)

Renvoie la valeur __file____ qui serait définie si le module spécifié était importé. Lève ZipImportError si l'importation a échoué.

Nouveau dans la version 3.1.

get_source(fullname)

Renvoie le code source du module spécifié. Lève ZipImportError si le module n'a pas pu être trouvé, renvoie None si l'archive contient le module, mais n'en a pas la source.

is_package(fullname)

Renvoie True si le module spécifié par fullname est un paquet. Lève ZipImportError si le module n'a pas pu être trouvé.

load_module(fullname)

Charge et renvoie le module spécifié par fullname, qui doit être le nom du module entièrement qualifié (avec des points). Lève ZipImportError si l'importation a échoué.

Obsolète depuis la version 3.10: utilisez plutôt exec_module().

invalidate_caches()

Efface le cache interne des informations sur les fichiers à l'intérieur de l'archive ZIP.

Nouveau dans la version 3.10.

archive

Le nom de fichier de l'archive ZIP associé à l'importateur, sans sous-chemin à l'intérieur.

prefix

Le sous-chemin du fichier ZIP où les modules sont recherchés. C'est la chaîne vide pour les objets zipimporter qui pointent vers la racine du fichier ZIP.

On a schématiquement archive + '/' + prefix == archivepath, où archivepath est l'argument donné au constructeur zipimporter.

Exemples

Voici un exemple qui importe un module d'une archive ZIP — notez que le module zipimport n'est pas explicitement utilisé.

$ 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'