Skip to main content

Simple semantic-version bumper in python that works.

Project description

Current version: 1.1.4
Compatible with Python >=2.7 and >=3.5



Bumping the (semantic) version of your software every time a release is done can be a tedious task, if you:

  • Have the version written in various files, e.g. or a dedicated version file.
  • Manage versioning with tags in GIT.

This little script automates this process for you.

Say you're using git-flow and you've just merged a feature to your development branch. You can just checkout and pull it, and then do:

bumpytrack minor  # or major if you have breaking changes, or patch if it's a simple bugfix

It will:

  • Replace the version string in all relevant files (see config below).
  • Commit those changes to GIT, taking care not to commit anything else (can be omitted).
  • Create a GIT tag for this new version (can be omitted).

Now you're free to push, merge to master and deploy!

Unless you forgot something or bumped by mistake of course, in which case you can just undo the commit and tag created in Git by doing:

bumpytrack git-undo

For the above version string replacements we'll need some config. This example should be autoexplicative. Create a pyproject.toml or add your config to the one you already have in the root of your repository and you're good to go.


pip install bumpytrack

Then add a pyproject.toml to the root of your repository (if you don't already have it) and configure it like this.


The script is really simple, and has a decent on-line documentation. Just do:

bumpytrack --help

Some of the available options:

  --current-version CURRENT_VERSION
                        force current version instead using version in config
  --new-version NEW_VERSION
                        force new version instead using version in config file
  --git-commit          Git: Commit files with version replacements
  --git-tag             Git: Tag this reference with the new version
  --config-path CONFIG_PATH
                        path to config file. Defaults to pyproject.toml in
                        current directory

You can also just peek at the code. Not much of it... it just adds one to some little numbers ;p


Make sure you have the lastest pip and pipenv versions:

pip install --update pip pipenv

To start developing, start the environment by:

pipenv shell
pipenv install -d

This tool uses both pipenv for development and setuptools for packaging and distribution. To this date there is not a 100% community-accepted best practice so I've taken this approach. In summary:

To add an application dependency, add it in and leave it with a loose version definition. Then, just do pipenv install -e . to install the dependency. Pipenv locking mecanism will work as expected, since bumpytrack itself in in the [packages] section of Pipfile (check Pipfile.lock and you'll find the deps there).

To add a development dependency, add it to Pipfile via pipenv install -d <my-dependency>.

This way there's a single source of truth for package definition. No need to repeat the deps in and Pipfile*.


To test the project run pytest inside the pipenv. Once you have something running, run tox to check it's compatible with all python versions supported.

IMPORTANT: in order to make tox test with different python versions, those have to be installed. pyenv is reccomended for that purpose. tox-pyenv is installed so it should work out of the box.

Dev tasks automation and publishing to PyPI

This project uses pepython for automation. There you'll find tasks to build and publish the package to PyPI.

Check the project out and the file for more info.


This project is licensed under the MIT License - see the LICENSE file for details.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bumpytrack-1.1.4.tar.gz (6.8 kB view hashes)

Uploaded source

Built Distribution

bumpytrack-1.1.4-py2-none-any.whl (7.6 kB view hashes)

Uploaded py2

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page