Skip to content
Easy package versioning and release management
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Build Status Code Health Code Coverage License

Pylease is a simple package that tends to ease the release process of a regular Python package. The aim of Pylease is to make it as simple as possible by requiring as little as possible. For more details on using Pylease please see the documentation.

Basic Usage

Start using pylease by just navigating to you package root (the directory containing and simply use the command-line:

$ pylease status

Now you will see basic information about your package, like name and version. Then take a try and do:

$ pylease make --dev

This will release the package with version '1.0.dev1', i.e. update the version in The release levels include major, minor, patch and dev.

If you want to initiate a branch new project, perform this:

$ pylease init my_project

This will prepare and create all needed files and directories for your project skeleton.


Pylease also comes with extensions mechanisms. It includes some useful extensions that might be used in combination as well as anyone can write extensions for Pylease to enhance it.


Git extension provides functionality to automatically create a tag on the git repository associated with the version, and commit the changes made to the

This may be achieved by simply adding --git-tag argument while calling pylease:

$ pylease make --minor --git-tag

After making the release, you will additionally have a new commit containing the update as well as a new tag pointing to that commit.


PyPI extension provides an ability to automatically upload you package distribution to PyPi after releasing your project. To enable this feature use the --pypi command line option:

$ pylease make --major --pypi
You can’t perform that action at this time.