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!

A Python utility for packaging up multi-file Python scripts into a single file, dependencies and all.

Project Description

Super Zippy takes a Python package and its pure Python dependencies and transforms them all into a single executable file.

This is similar to cx_Freeze except that it does not attempt to deal with non-pure Python dependencies and thus is much lighter weight and easier to use.

Examples

Let’s say we want to user Super Zippy on itself to create a single file containing all of Super Zippy’s dependencies and code.

$ superzippy superzippy superzippy.packaging:run
$ ./superzippy
Usage: superzippy [options] [PACKAGE1 PACKAGE2 ...] [ENTRY POINT]

superzippy: error: 1 or more arguments must be supplied.

We can send this single file (called superzippy above) to anyone and as long as they already have Python installed they can just run the file.

How it Works

It installs the Python package you specify into a virtualenv using pip (so anything you can tell pip to install can be given to superzippy), then grabs the site-packages directory out of the virtual environment and sticks it into a zip file along with some super bootstrapping code. Then it just makes the zip file executable by adding a proper shebang to it and flipping its executable bit.

Motivation

I created this for a tool called the Galah API Client which is a simple tool that has only pure Python dependencies. It is basically a script but since it is a little complex I didn’t want everything to be in a single file as that gets tedious fast… But I still wanted a good way to distribute it to my users who are not Python developers, may not have root access, and don’t want to deal with virtualenv and pip.

Installing

To install Super Zippy, just run

$ pip install superzippy

You can also install from the setup.py script yourself of course, or you can even create a super zipped up version of Super Zippy using Super Zippy. pip is probably the easiest way to go though if you’re already familiar with Python packages.

Are you using this tool?

If you’re using this tool on your project, let me know and I’ll link to you here. I’d also like to hear your feedback.

Authors

John Sullivan

License

Apache License v2.0 (see LICENSE)

Release History

Release History

History Node

1.0-rc.1

This version
History Node

0.0.9

History Node

0.0.8-

History Node

0.0.7-

History Node

0.0.5-

History Node

0.0.4-

History Node

0.0.3-

History Node

0.0.2-

History Node

0.0.1-

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
superzippy-0.0.9.tar.gz (11.8 kB) Copy SHA256 Checksum SHA256 Source Jun 23, 2013

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