Skip to main content

Creates release commits directly in git, unleashes them on PyPI and pushes tags to github.

Project description

unleash handles the boring details of cutting from your Python package a release and publishing it. It assists you by updating version numbers, making sure the documentation builds, reminding you that you still need to include a LICENSE file and other things.

Once a release is made, it gets tagged in your git repository. unleash features a publish action to push the new tag to and/or upload your package to PyPI

Unleash always works with commits instead of files in your working copy to ensure all your release are fully committed. It creates temporary checkouts or verifies directly from the commit’s tree. Never again will you have a bad release because you forgot to check-in that crucial file.


$ unleash --dry-run release
Updating and package version (0.6.0)
Updating documentation version (now 0.6.0)
Marking release as released by unleash
Checking documentation builds cleanly
Verifying release can generate source distribution
Verifying release can install into a virtualenv
Running tox tests
Updating and package version (0.6.1.dev1)
Updating documentation version (now 0.6.1.dev1)
Not saving created commits. Dry-run successful.

Note the --dry-run option which means that no alterations will be made to your repository. Otherwise, unleash will prompt you to confirm to create a new tag 0.6.0 for the release and will offer to advance your current branch to the next commit, in which all version numbers have been increase.

$ unleash --dry-run publish

To be written.

Other features

unleash uses a plugin-based architecture for all of its operations, this means it is fairly easy to add custom checks and steps for releases or publications if you desire so.

See the documentation at for details.

Project details

Download files

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

Source Distribution

unleash-0.7.1.tar.gz (17.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page