versionah
is a GPL v3 licensed module for maintaining version information
files for use in project management.
versionah
should run on Python v2.6 or newer [1], including Python v3.
The only external library versionah
currently depends on is jinja. If
versionah
doesn't work with the version of Python you have installed, file
an issue and I'll endeavour to fix it.
If you would like coloured terminal output, then you will need blessings.
[1] | If you still run older Python versions only small changes are required,
for to support Python 2.5 only the print syntax and from __future__
import print_function needs changing. |
The simplest way to show how versionah
works is by example:
$ ./versionah.py -s 2.4.3 example.txt 2.4.3 $ ./versionah.py example.txt 2.4.3 $ ./versionah.py -b minor example.txt 2.5.0 $ ./versionah.py -b major example.txt 3.0.0 $ rm example.txt <BLANKLINE>
API stability isn't guaranteed across versions, although frivolous changes won't be made.
When versionah
1.0.0 is released the API will be frozen, and any changes
which aren't backwards compatible will force a major version bump.
I'd like to thank the following people who have contributed to versionah
.
- Leal Hétu
- Matt Leighy
- Ryan Lewis
If I've forgotten to include your name I wholeheartedly apologise. Just drop me a mail and I'll update the list!
If you find any problems, bugs or just have a question about this package either file an issue or drop me a mail.
If you've found a bug please attempt to include a minimal testcase so I can reproduce the problem, or even better a patch!