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!

Version upgrader in all spesific files like, package.json, bower.json etc.

Project Description

This is a utility to manage versions in all necessary files in one place.(see,update, etc.)

Sometimes there are too many files in the project which contains project version. For example you would be having files such as bower.json and on same version in your project. Whenever the version is wanted be to upgraded, all files were updated one by one; now all implemented files can be update simply at once. It will find your versioning files and update them one by one.

This is installed into your python environment and the commands below can be access from command-line directly.


  • Python 2.7 or pypy2


$ (sudo) pip install version-manager --upgrade

Supported Functionalities

Current Status

To see current version of files.

$ versionmanager --status

Set version

Any version can be set.

$ versionmanager --set 1.1.1

Bump Version

This is new functionality to upgrade version without knowing whole version string. It simply upgrade version as major, minor or patch as it is defined in SemVer.

$ versionmanager --bump major
$ versionmanager --bump minor
$ versionmanager --bump patch

Built-In Supported Files

  • bower.json
  • package.json
  • pom.xml
  • (sphinx documentation config)

Implement for Your Custom Files

Any file implementation can be added simply. version-manager reads extra config from .vmrc file under your current directory(project folder maybe) or your user home directory.

Here is a simple example of .vmrc

$ vi ~/.vmrc


$ vi /path/to/your_project/.vmrc
  files : [
                    'name': 'my_custom_file.txt',
                    'parser': 'regexp',
                          'regex': '(?P<match_left>version=")(?P<version>\d+)(?P<match_right>")'
                    'name': 'my_custom_file.xml',
                    'parser': 'xml',
                          'xpaths': ['./ns:path1/ns:version'],

Any famous file formats can be demanded as built-in by opening an issue. Feel free to demand it :-)

Change Logs


  • Improvement - current_version and update_version are merged as subcomment under versionmanager consolescript. versionmanager --status, versionmanager --set <version> and versionmanager --bump <level> are available instead of current_version and update_version <version> .
  • Improvement - SemVer support is added for bump versioning. versionmanager --bump <level> which level is one among (major,``minor``,``patch``)


  • Improvement - pypy support is added.
  • Bug - When there is multiple regex config for same file, one of them was being applied. It is fixed. (version and relase in Sphinx


  • Improvement - Sphinx support is added.
  • Improvement - README file is in rst format now.
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
version-manager-0.6.0.tar.gz (7.7 kB) Copy SHA256 Checksum SHA256 Source Sep 22, 2015

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