Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Simple version number mangler
Python C Perl
Pull request Compare This branch is 186 commits behind JNRowe:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
doc
extra
tests
versionah
.gitignore
.travis.yml
COPYING
MANIFEST.in
NEWS.rst
README.rst
nose2.cfg
setup.cfg
setup.py
tox.ini
versionah.py

README.rst

versionah - Simple version specification management

https://secure.travis-ci.org/JNRowe/versionah.png?branch=master

Introduction

versionah is a GPL v3 licensed module for maintaining version information files for use in project management.

Requirements

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.

Example

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

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.

Contributors

I'd like to thank the following people who have contributed to versionah.

Bug reports

  • Leal Hétu
  • Matt Leighy

Ideas

  • Ryan Lewis

If I've forgotten to include your name I wholeheartedly apologise. Just drop me a mail and I'll update the list!

Bugs

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!

Something went wrong with that request. Please try again.