Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Access files inside zip archives using standard file functions

Project Description

Patches functions [modules]:file+open, and os.path:exists+isfile to enable accessing files inside zip archives using standard file functions.

Package:
http://pypi.python.org/pypi/zipaccess
Project:
https://github.com/iki/zipaccess
Issues:
https://github.com/iki/zipaccess/issues
Updates:
https://github.com/iki/zipaccess/commits/master.atom
Install via pip:
pip install zipaccess
Install via easy_install:
easy_install zipaccess
Sources via git:
git clone https://github.com/iki/zipaccess
Sources via hg-git:
hg clone git://github.com/iki/zipaccess

Usage

Use as a class. Do not instantiate it:

class AnyZipAccess(zipaccess.ZipAccess):
    any_zip = True  # custom modifications here

AnyZipAccess.enable()

Or use as a module:

zipaccess.enable()
zipaccess.addzip('data.zip')

Optionally, register zipaccess.ZipAccess as os.zipaccess:

zipaccess.enable(register=True)

so other modules can easily use:

try:
    os.zipaccess.enable(locals())
except AttributeError:
    pass

Note on Google App Engine (GAE)

On GAE, the __builtin__ module changes are not reflected, even in the local name space.

To use zip access in any GAE module, you need to enable it for that module locals:

try:
    import zipaccess
    zipaccess.enable(locals())
except ImportError:
    pass

Alternatively, only enable zip access locally, if it was already registered:

try:
    os.zipaccess.enable(locals())
except AttributeError:
    pass

Or enable it for target modules externally:

zipaccess.enable([
    'babel.core',
    'babel.localedata',
    'tipfy.template',
    'werkzeug.debug.tbtools',
    ])
# It imports all the modules though, which may be not what you want.
# If you know, how to hook on module import, let me kindly know.

Note, that os.path.isfile and os.path.exists are patched globally. Even on GAE, they apply for all modules of given instance. If some modules do support zip files, they usually first check if regular file exists, and if not, they split the path and check if the zipfile exists. With zip access enabled, the regular file check will succeed, which is ok as long as consequently used file() or open() functions are patched too.

Example:

The tipfy.debugger.get_loader() function checks if templates are located in a regular directory or in a zip file (lib/dist.zip usually). Then it returns tipfy.template.Loader or tipfy.template.ZipLoader accordingly. With zipaccess enabled, the standard tipfy.template.Loader will be used, and therefore zipaccess.enable('tipfy.template') is needed to make it work.

See https://github.com/moraes/tipfy/blob/master/tipfy/debugger/__init__.py#L26.

Release History

Release History

This version
History Node

0.1rc1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
zipaccess-0.1rc1.zip (9.6 kB) Copy SHA256 Checksum SHA256 Source Jun 20, 2011

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting