[![PyPI Python Versions](https://img.shields.io/pypi/pyversions/flowtool-versioning.svg)](https://pypi.python.org/pypi/flowtool-versioning)
[![PyPI Latest Version](https://img.shields.io/pypi/v/flowtool-versioning.svg)](https://pypi.python.org/pypi/flowtool-versioning)
[![PyPI Distribution Format](https://img.shields.io/pypi/format/flowtool-versioning.svg)](https://pypi.python.org/pypi/flowtool-versioning)

# flowtool-versioning

Automatic versions from git tags.

This addon lets you deploy a small versioning framework into your python
project, that integrates well with setuptools and probably also distutils.

The framework itself has no dependencies but python.
It is verified-to-work with python 2.7 and 3.4 releases.

To test it out, run one of these commands:
```
flowtool versioning-init
flowtool versioning-update
```
in a folder that contains a file named `setup.py`.
You will then be asked where the versionfile (that contains the version
information) should be placed, and wether you want to include some default
snippets into `setup.cfg` and `__init__.py` to configure and use the version
in your project. It will also create a file named `versioning.py` next to your
`setup.py` before giving you some information on how to wire things up in
`setup.py` from there.

Once you have it wired into your `setup.py` (same process as
[python-versioneer](https://github.com/warner/python-versioneer)) and created a
tag with your chosen prefix (`setup.cfg`, prefix can be empty also) to
bootstrap automatic versioning, you should be able to run:
```
./versioning.py     # outputs the current version
./setup.py version  # get more detailed current version info
./setup.py bump     # create a new tag, with a minorly bumped version
./setup.py sdist release  # release is upload and git push + tags
```

Request more documentation!
