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] [--no-configured-files]
[--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 ...]
bumpversion: v1.0.1 (using Python v3.13.2)
- part
- Part of the version to be bumped.
- file
- Files to change (default: [])
- -h, --help
- show this help message and exit
- --config-file
FILE
- Config file to read most of the variables from (default:
.bumpversion.cfg)
- --verbose
- Print verbose logging to stderr (default: 0)
- --list
- List machine readable information (default: False)
- --allow-dirty
- 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>[az]+))?)
- --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.1)
- --no-configured-files
- Only replace the version in files specified on the command line, ignoring
the files from the configuration file. (default: False)
- --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
- Commit to version control (default: True)
- --no-commit
- Do not commit to version control
- --tag
- Create a tag in version control (default: True)
- --no-tag
- Do not create a tag in version control
- --sign-tags
- Sign tags if created (default: False)
- --no-sign-tags
- 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})
- --message,
-m COMMIT_MSG
- 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.