This project follows the python form of Semantic Versioning as detailed in PEP 440.
For git tags we use the version as describe in Versioning
Schema preceded by a v.
A release on git is just a tagged commit on the master branch.
Here we detail the process of creating a new Github release.
- Create and merge a pull request that:
- increases the version number in
xain_fl/__version__.pyaccording the versioning schema. - updates the
CHANGELOG.mdwith all notable changes for the release. - possibly update the
Development Statusclassifiers in thesetup.py. You can check supported classifiers in the pypi website.
- increases the version number in
- Got to the Github Releases tab
and create a new release:
- for the tag version use the version defined in 1. preceded by a
v, e.g. v0.3.2, and target master. - for the release title use the same as the tag version.
- for the release description, copy the section from the
CHANGELOG.mdrelated to this version. - possibly check the
This is a pre-releasecheck box. - Publish the release.
- for the tag version use the version defined in 1. preceded by a
Here we detail the process of building and pushing a python package to PyPi. You can check more information in the Python Packaging User Guide.
- Checkout the current git tag e.g.
$ git checkout v0.3.2
- Generate the distribution archives:
$ python setup.py sdist bdist_wheel
- Upload the distribution archives using the correct PyPi credentials:
$ python -m twine upload dist/*