mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

#1326: document and test zipimporter.archive and zipimporter.prefix.

Browse source
This commit is contained in:
Georg Brandl 2008-05-11 15:05:13 +00:00
parent ae98f50eca
commit 6a57c08dc8
3 changed files with 55 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

25
Doc/library/zipimport.rst
View file

@ -65,17 +65,14 @@ zipimporter Objects
.. class:: zipimporter(archivepath)
Create a new zipimporter instance. *archivepath* must be a path to a ZIP file.
Create a new zipimporter instance. *archivepath* must be a path to a ZIP
file, or to a specific path within a ZIP file. For example, an *archivepath*
of :file:`foo/bar.zip/lib` will look for modules in the :file:`lib` directory
inside the ZIP file :file:`foo/bar.zip` (provided that it exists).
:exc:`ZipImportError` is raised if *archivepath* doesn't point to a valid ZIP
archive.
*archivepath* can also contain a path within the ZIP file -- the importer
object will then look under that path instead of the ZIP file root. For
example, an *archivepath* of :file:`foo/bar.zip/lib` will look for modules
in the :file:`lib` directory inside the ZIP file :file:`foo/bar.zip`
(provided that it exists).
.. method:: find_module(fullname[, path])
Search for a module specified by *fullname*. *fullname* must be the fully
@ -120,13 +117,19 @@ zipimporter Objects
.. attribute:: archive
The file name of the importer's associated ZIP file.
The file name of the importer's associated ZIP file, without a possible
subpath.
.. attribute:: prefix
The path within the ZIP file where modules are searched; see
:class:`zipimporter` for details.
The subpath within the ZIP file where modules are searched. This is the
empty string for zipimporter objects which point to the root of the ZIP
file.
The :attr:`archive` and :attr:`prefix` attributes, when combined with a
slash, equal the original *archivepath* argument given to the
:class:`zipimporter` constructor.
.. _zipimport-examples: