---
id: bumpver
version: "2026.1132"
license: MIT
license_treatment: permissive
maintenance: active
---

# bumpver — Bump version numbers in project files.

License: permissive · Maintenance: active · Downloads: 545.0K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 545.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

version bumping automation, semantic versioning tool, calendar versioning, version string replacement, project version management, semver calver, version pattern matching, version-management, build-automation, cli-tool

[View on SkillFed](https://skillfed.io/packages/bumpver) · [View on PyPI](https://pypi.org/project/bumpver/)