drb-driver-zip 1.4.0

DRB driver Zip

ZipNode Driver

This drb-driver-zip module implements access to zip containers with DRB data model. It is able to navigates among the zip contents.

Zip Factory and Zip Node

The module implements the basic factory model defined in DRB in its node resolver. Based on the python entry point mechanism, this module can be dynamically imported into applications.

The entry point group reference is drb.drivers.
The implementation name is zip.
The factory class is encoded into drb.drivers.zip.

The zip factory creates a ZipNode from an existing zip content. It uses a base node to access the content data using a streamed implementation from the base node.

The base node can be a DrbFileNode, DrbHttpNode, DrbTarNode or any other nodes able to provide streamed (BufferedIOBase, RawIOBase, IO) zip content.

GDAL locator (gdal-vsi)

A member node exposes a GDAL /vsizip locator through get_impl(str, 'gdal-vsi'), e.g. /vsizip{<archive>}/inner/file.jp2. The archive segment reuses the container's own gdal-vsi locator when it has one (e.g. an S3 object exposing /vsis3/...), so it composes for nested sources: /vsizip{/vsis3/bucket/key.zip}/inner.jp2. This lets a consumer such as drb-driver-image hand the member to GDAL for native range reads instead of extracting the whole member.

limitations

The current version does not manage child modification and insertion. ZipNode is currently read only.

Using this module

To include this module into your project, the drb-driver-zip module shall be referenced into requirements.txt file, or the following pip line can be run:

pip install drb-driver-zip