Scroll to navigation



bumpversion - Version-bump your software


usage: bumpversion [-h] [--config-file FILE] [--verbose] [--list]
[--allow-dirty] [--parse REGEX] [--serialize FORMAT] [--search SEARCH] [--replace REPLACE] [--current-version VERSION] [--dry-run] --new-version VERSION [--commit | --no-commit] [--tag | --no-tag] [--sign-tags | --no-sign-tags] [--tag-name TAG_NAME] [--tag-message TAG_MESSAGE] [--message COMMIT_MSG] [--commit-args COMMIT_ARGS] part [file [file ...]]

bumpversion: v1.0.0 (using Python v3.7.6)

positional arguments:

Part of the version to be bumped.
Files to change (default: [])

optional arguments:

-h, --help
show this help message and exit
--config-file FILE
Config file to read most of the variables from (default: .bumpversion.cfg)
Print verbose logging to stderr (default: 0)
List machine readable information (default: False)
Don't abort if working directory is dirty (default: False)
--parse REGEX
Regex parsing the version string (default: (?P<major>\ d+)\.(?P<minor>\d+)\.(?P<patch>\d+)(\-(?P<release>[a-z ]+))?)
--serialize FORMAT
How to format what is parsed back to a version (default: ['{major}.{minor}.{patch}-{release}', '{major}.{minor}.{patch}'])
--search SEARCH
Template for complete string to search (default: {current_version})
--replace REPLACE
Template for complete string to replace (default: {new_version})
--current-version VERSION
Version that needs to be updated (default: 1.0.0)
--dry-run, -n
Don't write any files, just pretend. (default: False)
--new-version VERSION
New version that should be in the files (default: None)
Commit to version control (default: True)
Do not commit to version control
Create a tag in version control (default: True)
Do not create a tag in version control
Sign tags if created (default: False)
Do not sign tags if created
--tag-name TAG_NAME
Tag name (only works with --tag) (default: v{new_version})
--tag-message TAG_MESSAGE
Tag message (default: Bump version: {current_version} ??? {new_version})
Commit message (default: Bump version: {current_version} ??? {new_version})
--commit-args COMMIT_ARGS
Extra arguments to commit command (default: )


The full documentation for bumpversion is maintained as a Texinfo manual. If the info and bumpversion programs are properly installed at your site, the command
info bumpversion

should give you access to the complete manual.

February 2020 bumpversion 1.0.0