Skip to main content

Generate version strings based on semantic versioning rules.

Project description

Travis CI Code Health

Helper tool to generate version strings based on semantic versioning rules. It provides a shell command which you can use in bash scripts and comes with Python classes which you can integrate in your code.

Installation

pip install versionbump

Usage

usage: versionbump [-h] -c CURRENT [-q] [-i]
               {major,minor,patch,pre} [file [file ...]]

Arguments

  • -c / --current: Assume current version. (required)
  • -l / --label: Pre-release label.
  • -h / --help: Print help text and exit.
  • -q / --quiet: Don’t write anything to stdout.
  • -i / --ignore: Ignore invalid files

Increase version

$ versionbump -c 0.1.2 patch
0.1.3

Replace version in file(s)

$ cat version.txt
Current version: 0.1.2
$ versionbump -c 0.1.2 minor version.txt
0.1.3
$ cat version.txt
Current version: 0.1.3

If you want to replace the version string in more than one file, just pass them to versionbump aswell. Example:

$ versionbump -c 0.1.2 major file1.txt file2.txt file3.txt

Python library

VersionBump

from versionbump import VersionBump
vb = VersionBump('2.0.1')
vb.bump()              ## default value: 'patch'
print vb.get()         ## 2.0.2
print vb.get('patch')  ## 2

FileBump

from versionbump import FileBump
fo = open('version.txt', 'r+')
fb = FileBump(fo, '2.0.1')
fb.bump()              ## default value: 'patch', writes to file
print fb.get()         ## 2.0.2
print fb.get('patch')  ## 2

Alternatives

  • bumpversion by Filip Noetzel. Provides much more functionality like VCS integration.
  • grunt-bump by Vojta Jina. Integrates with the task runner grunt.

Project details


Download files

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

Files for versionbump, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size versionbump-1.1.1.tar.gz (4.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page