Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A simple tool to bump version number of a Python package

Project Description
author:Lele Gaifax
license:GNU General Public License version 3 or later

This is a very simple tool that I use to automatize the management of the version.txt file I usually put in my Python packages. There are tons of equivalent tools around, but none of them fullfilled my needs.

It uses the package Versio to handle different versioning schemas, with an additional simple2 scheme for versions composed simply by major.minor numbers.


$ echo "0.0" > version.txt
$ bump_version --dry-run
Old version: 0.0
New version: 0.1

$ bump_version -n --field major
Old version: 0.0
New version: 1.0

$ echo "" > version.txt
$ bump_version -f minor --scheme simple4
$ cat version.txt

$ echo "0.9" > version.txt
$ bump_version -n -f release --index 1 -s pep440
Old version: 0.9
New version: 0.10

$ bump_version -f release -i 1 -s pep440
$ cat version.txt

$ bump_version -n -f pre -i 1 -s pep440
Old version: 0.10
New version: 0.10a1

$ bump_version -n -f post -i 1 -s pep440
Old version: 0.10
New version: 0.10.post1

$ bump_version -f post -i 1 -s pep440
$ bump_version -n -f dev -i 1 -s pep440
Old version: 0.10.post1
New version: 0.10.post1.dev1

The version scheme is by default automatically determined from current version (just simple versions though):

$ echo "1.0" > version.txt
$ bump_version -n
Old version: 1.0
New version: 1.1

$ echo "1.0.0" > version.txt
$ bump_version -n
Old version: 1.0.0
New version: 1.0.1

$ echo "" > version.txt
$ bump_version -n
Old version:
New version:

The current version may not exist yet, but obviously you must specify the right schema:

$ rm -f version.txt
$ bump_version -n -s simple2
Old version: 0.0
New version: 0.1

$ bump_version -s simple3
$ cat version.txt


1.3 (2017-03-22)

  • Minor adjustments to take off the dust

1.2 (2016-03-23)

  • New option to automatically select the versioning schema, when one exists
  • New simple test suite

1.1 (2015-09-09)

  • Properly include needed sources in the distribution

1.0 (2015-08-09)

  • Reimport from metapensiero.extjs.desktop
Release History

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
metapensiero.tool.bump_version-1.3.tar.gz (5.7 kB) Copy SHA256 Checksum SHA256 Source Mar 22, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting