Skip to content
Like Python's ZipFile module, except it works as a generator that provides the file in many small chunks.
Branch: master
Clone or download
Latest commit 347350f Apr 8, 2013
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore initial commit Apr 7, 2013
LICENSE move gpl-3.0.txt to LICENSE Apr 7, 2013
README.markdown initial commit Apr 7, 2013 initial commit Apr 7, 2013 initial commit Apr 7, 2013


ZipStream is a zip archive generator based on It was created to generate a zip file on-the-fly for download in a ( application. This is beneficial for when you want to provide a downloadable archive of a large collection of regular files, which would be infeasible to generate the archive prior to downloading.

The archive is generated as an iterator of strings, which, when joined, form the zip archive. For example, the following code snippet would write a zip archive containing files from 'path' to a normal file:

zf = open('', 'wb')
for data in ZipStream(path):

Since recent versions of support returning iterators of strings to be sent to the browser, to download a dynamically generated archive, you could use something like this snippet:

def GET(self):
    path = '/path/to/dir/of/files'
    zip_filename = ''
    web.header('Content-type' , 'application/zip')
    web.header('Content-Disposition', 'attachment; filename="%s"' % (
    return ZipStream(path)

If the zlib module is available, ZipStream can generate compressed zip archives.


  • Python >=2.6


This library was created by SpiderOak, Inc. and is released under the GPLv3. Copyright 2008-2013 SpiderOak Inc.

You can’t perform that action at this time.