bumpver

What it is and what it does

BumpVer is a version-bumping CLI tool that automates finding and updating version strings in your project files. You define a version pattern (supporting SemVer like MAJOR.MINOR.PATCH, CalVer like YYYY.MM, or custom schemes) and file patterns to search, then BumpVer handles the search-and-replace across your codebase. It normalizes versions according to PEP440 and can optionally integrate with Git or Mercurial for VCS-aware bumping.

The tool works with plaintext files, so it's not limited to Python projects—you can use it with any language or project type. It supports dry-run mode to preview changes before applying them, and provides a test command to validate your version patterns before committing them to configuration.

Use it for:

• Automate version bumping in CI/CD pipelines for multi-file projects using SemVer or CalVer schemes.
• Test and validate version patterns before configuring them in your project's version configuration.
• Update version strings across setup.py, __init__.py, and other project files in a single command.
• Manage CalVer versioning with automatic date-based increments and optional patch numbers for multiple releases per period.
• Preview version changes with dry-run mode before committing them to version control.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

BumpVer is a CLI tool that searches for and updates version strings across your project files using configurable patterns, supporting SemVer, CalVer, and custom versioning schemes.

Yes. BumpVer is actively maintained, has no known vulnerabilities, low install friction, and a permissive MIT license. It solves a real problem—automating version updates across multiple files—with flexible pattern support for SemVer, CalVer, and custom schemes. The tool is well-suited for both Python and non-Python projects. Install it if you manage versions across multiple files and want to automate the bumping process.

Install

bumpver on PyPI

pip install bumpver

uv add bumpver

poetry add bumpver

Installing bumpver

Before you install

Low install friction with a pure-Python wheel. Active maintenance with a release 84 days ago and 246 repository stars. Supports Python 2.7 and modern Python versions across CPython and PyPy.

License in practice

MIT license (permissive) means you can use, modify, and distribute BumpVer with minimal restrictions in commercial and open-source projects.

Quickstart

pip install bumpver

# In pyproject.toml or .bumpver.toml:
# [bumpver]
# current_version = "1.5.2"
# version_pattern = "MAJOR.MINOR.PATCH"

bumpver test '1.5.2' 'MAJOR.MINOR.PATCH' --patch
bumpver update --patch --dry

Verify before relying

• Whether Git/Mercurial integration is automatic or requires additional setup beyond the CLI.
• Performance characteristics when scanning large projects or many files.
• Whether the tool can be used programmatically as a library or only via CLI.

Package facts

Evidence: bumpver-2026.1132-py2.py3-none-any.whl

Keywords: version, bumpver, calver, semver, versioning, bumpversion, pep440

Tags

More Libraries packages