Zipbundler 🗜️

Bundle your packages into a runnable, importable zip.
Because installation is optional.

Zipbundler creates zipapp-compatible .pyz files that are both runnable and importable. Unlike shiv or pex, zipbundler produces standard zipapp files compatible with Python’s built-in zipimport module.

Quick Start

Install Zipbundler:

# Using poetry
poetry add zipbundler

# Using pip
pip install zipbundler

zipapp-style CLI (100% compatible with python -m zipapp):

# All zipapp options supported
zipbundler src/myapp -o app.pyz -p "/usr/bin/env python3" -m "myapp:main" -c
zipbundler app.pyz --info  # Display interpreter from archive

Or use configuration:

zipbundler init
zipbundler build

Key Features

• zipapp Compatible — Produces standard .pyz files compatible with Python’s zipapp module
• Importable — Files can be imported using zipimport or importlib
• Flat Structure — Preserves original package paths without transformations
• zipapp-style CLI — Compatible with python -m zipapp command-line interface
• Configurable — Flexible configuration via .zipbundler.jsonc or pyproject.toml
• Entry Points — Support for executable zip files with custom entry points
• Watch Mode — Automatically rebuild on file changes

Documentation

• Getting Started — Installation and quick start guide
• Configuration Reference — Complete configuration file documentation
• CLI Reference — All command-line options and usage
• API Reference — Programmatic API for Python integration
• Examples — Real-world usage examples and patterns

License

MIT-a-NOAI License

You’re free to use, copy, and modify the library under the standard MIT terms.
The additional rider simply requests that this project not be used to train or fine-tune AI/ML systems until the author deems fair compensation frameworks exist.
Normal use, packaging, and redistribution for human developers are unaffected.

_{😐 Apathetic Tools © MIT-a-NOAI}