bump

library1.4.0pypypi✓ verified 81d ago

A lightweight tool to bump package version numbers in Python projects. Version 1.4.0 supports various versioning schemes (semver, calver, etc.) and integrates with Git tags. Regular releases, actively maintained.

devops

pip install bump

github ↗homepage ↗

INSTALL

IMPORT

SIG · BUMP

bump

devopspythonv1.4.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Config

✓ from bump import Config

✗ from bump import Bump

SemVer

✓ from bump import SemVer

canonicalize_version

✓ from bump import canonicalize_version

Reads version from a file (pyproject.toml, setup.cfg, etc.) and bumps it.

from bump import Bump bump = Bump() # Read current version from pyproject.toml current = bump.read('pyproject.toml') # Bump patch version new_version = bump.bump('patch', current) print(f'{current} -> {new_version}')

Debug

Known issues

breakingIn bump 1.x, the API changed from function-based (bump.version) to class-based (Bump). Old code using `from bump import version` will break.

fix

Use `from bump import Bump` and instantiate `Bump()`

affects: >=1.0.0

deprecatedSupport for setup.py version files is deprecated and will be removed in 2.0. Use pyproject.toml or setup.cfg.

fix

Migrate to pyproject.toml with `[project] version = "..."`

affects: >=1.3.0

gotchaThe `bump` command-line tool does not automatically commit or tag; you must use `--commit` and `--tag` flags explicitly.

fix

Run `bump --commit --tag minor` to bump, commit, and tag.

affects: all

gotchaWhen bumping, the version file must be in a recognized format (pyproject.toml, setup.cfg, VERSION file). Unrecognized formats cause a silent failure.

fix

Ensure your project has a standard version file. Use `bump --dry-run` to test first.

affects: all

Upgrade

Version history

1.4.0latest on PyPI · released Jan 21, 2026

Audit

Dependencies

gitpythonoptionalUsed for Git integration when tagging versions

Agent activity

12 hits · last 30 days

node

Resources

githubhttps://github.com/di/bump ↗

homepagehttps://github.com/di/bump ↗