Built-in Plugins¶
As you will see in the Extensing Pylease section, you can customize and extend Pylease the way you like. Fortunately, Pylease comes batteries included, with built-in plugins for most common tasks. Now let us take a look at each plugin separatelly.
Git¶
Pylease supports integration with git. You can enable this plugin with the --git-tag
option of the make
command. Consider the
following situation:
$ pylease status
Project Name: example
Current Version: 0.3
$ git tag -l
v0.1
v0.1.1
v0.2
v0.3
As you can see the example project has four releases - 0.1
, 0.1.1
, 0.2
, 0.3
, and current version is 0.3
. So
imagine you want to make a patch
release and create appropriate tag in your git repository:
$ pylease make --patch --git-tag
$ pylease status
Project Name: example
Current Version: 0.3.1
$ git tag -l
v0.1
v0.1.1
v0.2
v0.3
v0.3.1
PyPI¶
The Pylease PyPI plugin enables to automatically upload your package egg to PyPI. The only prerequisite for this action is that the package name must be already registered, as well as you must be responsible for the authentication over the .pypirc file.
To enable this feature during the release process you should just use the --pypi
option like this:
$ pylease make --major --pypi
This --pypi
part of this command simply does the same as the python setup.py sdist upload
.