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.
Start using pylease by just navigating to you package root (the directory containing setup.py) 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 setup.py. 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 setup.py.
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 setup.py 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