---
name: "bumpversion"
section: "1"
platform: "linux"
package: "bumpversion"
version: "1.0.1-1.2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/bumpversion"
---

# bumpversion(1)

Version-bump your software

## NAME

bumpversion - Version-bump your software

## DESCRIPTION

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)

### positional arguments:

- part

  Part of the version to be bumped.

- file

  Files to change (default: \[\])

### options:

- **-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: )

## SEE ALSO

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.