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.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
deps
doc
pylease
static/media
tests
.gitignore
.landscape.yml
.travis.yml
LICENSE
MANIFEST.in
README.rst
setup.cfg
setup.py

README.rst

Pylease

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 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.

Extensions

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

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

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.