NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #4063 most downloaded on PyPI
Version bump your Python project
Last release 1 months ago
06 Aug 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
92 releases · first in 2023
One column per quarter.
Fixed type annotation in config. 2988ede
Fixed type annotation in config. 2988ede
Fixed naming issue for docs. 2850aa7
Added how-to doc. 68643a9
[pre-commit.ci] pre-commit autoupdate. c495d3d
updates: - github.com/astral-sh/ruff-pre-commit: v0.2.1 → v0.2.2
Fix encoding when reading text. c03476a
[pre-commit.ci] pre-commit autoupdate. 491b4aa
updates: - github.com/astral-sh/ruff-pre-commit: v0.1.14 → v0.2.0
Refactored VersionComponentConfig to VersionComponentSpec. b538308
Refactored VersionComponentConfig to VersionComponentSpec. b538308
More consistent with VersionSpec
[pre-commit.ci] pre-commit autoupdate. a2a3fe6
updates: - github.com/astral-sh/ruff-pre-commit: v0.1.11 → v0.1.14
Refactored serialization. 0ac2cd8
Fixed some tests. 593a4ee
Refactored serialization. 0ac2cd8
Fixed extra capture group in PEP440 parser. 384fd99
Refactored verioning models. 88e7f71
depends_on version component configurationdepends_on is required for PEP440 versioningFixed None as value for a function. f8c4d05
Fixed bad imports. 5c86d51
Refactored versioning models and tests. 7d05414
Refactored version parsing. 5ed546b
Refactored versioning functions and version parts. be87721
Fixed timezone of a test. 0e01253
Fixed bad error checking with SCM. 10e5d7d
Fixed Py3.8 type annotation. c15b23b
Fixed Py3.8 type annotation. c15b23b
Fixed some output in visualizing. 406f97a
Fixed bad type annotation. 8f4bedf
Fixed bad test imports. a74342b
Refactored the create subcommand. f529d28
Added show-bump subcommand. 0bbd814
bump commandAdded sample-config feature. 3d0f67d
Fixed extra whitespace added when updating pyproject.toml. 839f17f
Fixed a bad import. 46c9c48
Fixed extra whitespace added when updating pyproject.toml. 839f17f
Removed dotted-notation from requirements. There is an issue on how dotted-notation sets values in the TOMLkit data structure.
Added get_nested_value and set_nested_value as replacements for dotted-notation.
[pre-commit.ci] pre-commit autoupdate. ee4d2f3
updates: - github.com/astral-sh/ruff-pre-commit: v0.1.9 → v0.1.11
Fixed empty string replacement bug. d9965ab
Fixed empty string replacement bug. d9965ab
Only a missing replacement value will trigger one of the fallback options.
Fixes #117
Add support for legacy multiline search options (refs #98). 278eae5
[pre-commit.ci] pre-commit autoupdate. 2e9a400
updates: - github.com/astral-sh/ruff-pre-commit: v0.1.7 → v0.1.9
Fix not being able to tag without also committing. 753c990
Fix miscast of current_version. b8ea252
Fix miscast of current_version. b8ea252
Fixes #99
Fixed regression in config update. 2bbbd74
Fixes workflow triggers. 690452e
Fixed requirements for github action. d96e07a
Fixed issue when adding files. 84556f8
Fixed issue when adding files. 84556f8
Fixed missing requirement in GH action. 42bab83
Fixed regression regarding multiple changes in one file. e7a7629
Changed the method of marking changes from a dict keyed by the file name to a list of FileChanges.
FileChanges encapsulate a single change to a file.
Refactored logging to provide indented output. 4e68214
Refactored FileConfig to FileChange. 249a999
This better describes what the class does: describe a file change.
Also moved get_search_pattern to the class, since it is specific to each instance
Refactored config file management. a4c90b2
Moved the INI format stuff into files_legacy.py
Fixes generate-requirements.sh to upgrade. 121ef69
Added caching to the resolved filemap. c96e0bd
Added custom GitHub action. 4ce17a9
Added indented logger to improve console output. d1d19e3
Fix dev versioning with PR number. 463082b
Fixed versioning. 8769671
Fix dev versioning with PR number. 463082b
Fix dev versioning. 1eed99b
Fix versioning of development versions. e89599f
Fixes workflows. 5ebb0d7
Fixed bug #65 where glob'd files weren't used. 357b9dc
Add -h for help option. fda71b0
Fixes #67
Drop Python3.7 as compatible version. 890edc8
Since this is no longer tested, it's safer to start at 3.8.
[pre-commit.ci] auto fixes from pre-commit.com hooks. fbcef03
for more information, see https://pre-commit.ci
Recommend calling 'bump-my-version' instead of 'bumpversion'. 9fb1a1d
[pre-commit.ci] pre-commit autoupdate. e2579d6
updates: - github.com/astral-sh/ruff-pre-commit: v0.0.290 → v0.0.292
[pre-commit.ci] pre-commit autoupdate. e21fdd9
updates: - github.com/astral-sh/ruff-pre-commit: v0.0.290 → v0.1.1
[pre-commit.ci] pre-commit autoupdate. 7e5d1bc
updates: - github.com/astral-sh/ruff-pre-commit: v0.0.290 → v0.1.3
Changed the default regex search to non-regex. 0034716
Fixes #59
[pre-commit.ci] pre-commit autoupdate. 4a3d046
[pre-commit.ci] pre-commit autoupdate. 4a3d046
updates: - github.com/astral-sh/ruff-pre-commit: v0.0.285 → v0.0.290
Refactored file resolution, inclusion, and exclusion. 646af54
Refactored file resolution, inclusion, and exclusion. 646af54
resolved_filemap propertyfiles_to_modify propertyFixed file configuration overrides. c1ef3b2
Fixed file configuration overrides. c1ef3b2
Fixes #55
The file config was ignoring falsey values when constructing the dict.
It now ignores None values.
Fixed documentation regarding regex config. cd71a1a
Fixed requirements for docs. 7856ee0
[pre-commit.ci] pre-commit autoupdate. 7c38c40
updates: - github.com/astral-sh/ruff-pre-commit: v0.0.284 → v0.0.285
[pre-commit.ci] pre-commit autoupdate. c30bd12
updates: - github.com/astral-sh/ruff-pre-commit: v0.0.282 → v0.0.284
[pre-commit.ci] pre-commit autoupdate. 95c89fb
updates: - github.com/astral-sh/ruff-pre-commit: v0.0.281 → v0.0.282
Fixed modified context when committing. 130bbe0
Fixed modified context when committing. 130bbe0
[pre-commit.ci] auto fixes from pre-commit.com hooks. 4b457d0
[pre-commit.ci] auto fixes from pre-commit.com hooks. 4b457d0
for more information, see https://pre-commit.ci
[pre-commit.ci] pre-commit autoupdate. adb7e4c
updates: - github.com/astral-sh/ruff-pre-commit: v0.0.277 → v0.0.281
Remove pygments_style from docsrc/conf.py. 32798a9
The theme defaults, subjectively, look better.
Added deprecation warning on .cfg files. a0481b7
Added documentation about regular expressions. 449b70a
Added configuration and command-line no_regex option. a295a32
no_regex--no-regex flag added for bump and replace sub-commandsAdds regular expression searching ability. 0210d74
Added deprecation warning on .cfg files. a0481b7
Added deprecation warnings. 733438b
Added documentation for ignore missing version. e0731c3
Added --ignore-missing-version flag to bump and replace. a5bd008
Added ignore-missing-version configuration. 45c85be
FalseAdded deprecation warnings. 733438b
--list option will go bye-bye in 1.0bumpversion without a subcomand will leave in 1.0Fix search and replace options for replace. 781e8d8
Fix search and replace options for replace. 781e8d8
--search and --replace options now completely override any other search and replace logic.Fixes #34
[pre-commit.ci] pre-commit autoupdate. 531738d
updates: - github.com/astral-sh/ruff-pre-commit: v0.0.276 → v0.0.277
[pre-commit.ci] pre-commit autoupdate. 61e6747
updates: - https://github.com/charliermarsh/ruff-pre-commit → https://github.com/astral-sh/ruff-pre-commit
Fixed wrong pydantic version pinning. d4b125e
Fixed test coverage. 3fe96f0
Fixed wrong pydantic version pinning. d4b125e
Fixed typing issue. bfe5306
ClassVar[List[str]]_TEST_USABLE_COMMAND, _COMMIT_COMMAND, and _ALL_TAGS_COMMAND affectedAdded tests for CLI replace command. a53cddc
Added and re-organized documentation. c62d65e
Added replace subcommand. 8722a0f
Works just like bump but
Can use bumpversion show new_version --increment <versionpart> to see what the new version would be
Adds short_branch_name to version rendering context. 7f7e50c
short_branch_name is the branch name, lower case, containing only a-z and 0-9, and truncated to 20 characters.Fixes #28
Check config before tagging. 3a6e3ee
Format version parts. ee43bdb
[pre-commit.ci] auto fixes from pre-commit.com hooks. 5e6f566
for more information, see https://pre-commit.ci
[pre-commit.ci] pre-commit autoupdate. f1acd35
updates: - github.com/charliermarsh/ruff-pre-commit: v0.0.272 → v0.0.275
Fixed --help and bump invocations. 9d965e5
Fixed --help and bump invocations. 9d965e5
--help works for individual sub-commands, but not for the commandbump now works and fixed testsFixed issue regarding TOML types. 8960d24
tomlkit.parse() returns a TOMLDocument.unwrap() converts it into a dictAdds branch_name to SCM information. 173be1a
Added documentation for the show command. d537274
Adds --increment option to show subcommand. b01fffc
new_version to the available output.Added show subcommand. 9bce887
--list optionChanges bump-my-version into subcommands. 31ffbcf
bump-my-version forwards command to bump-my-version bump subcommand--helpFixes reporting the wrong version missing in a file. efb04e9
Fixes reporting the wrong version missing in a file. efb04e9
current_version for each file being modified.[pre-commit.ci] auto fixes from pre-commit.com hooks. 5476cdf
for more information, see https://pre-commit.ci
[pre-commit.ci] pre-commit autoupdate. 6e500c2
updates: - github.com/charliermarsh/ruff-pre-commit: v0.0.270 → v0.0.272
Fixed ruff complaints about subprocess. c429c68
Fixed ruff complaints about subprocess. c429c68
Fixed issue with formatting. da7544f
There is an underlying edge case where the deriving previous environment variables with multple ways of formatting version numbers will fail.
Add test to reproduce issue #14. d78ff46
Added documentation for replacing strings in different files. 893ec03
Fixes #6
Made VERSION_PART optional. f236b7d
VERSION_PART is detected from the arguments based on the configurationOutputs the notes to a file instead of an environment variable.
Fixes release.yaml. 01870d5
Outputs the notes to a file instead of an environment variable.
[pre-commit.ci] auto fixes from pre-commit.com hooks. 266002f
for more information, see https://pre-commit.ci
[pre-commit.ci] pre-commit autoupdate. edc444f
updates: - github.com/charliermarsh/ruff-pre-commit: v0.0.261 → v0.0.270
Fixed pre-commit hook for dependency checking. 3d5c253
Fixed pre-commit hook for dependency checking. 3d5c253
Fixed installing test dependencies. c1034eb
Fixed dependency spec. 4782745
Fixed missing python in pypi test. e5ed27d
Fixed some CI issues. d4b03d7
Fixed vague commit and tagging info. 4fb5158
If commit is configured false, it will report that it will not commit
If commit is configured false, tagging is disabled and it reports that
If tagging is configured false, it will report it is not tagging
Fixes test package. 7c12072
Added tests for logging branches. f8f0278
Added path restrictions on release-hints. e1af658
Added test build to CI. 8738f3f
Added doc files to table of contents. 49858c0
Completely migrated setuptools to use pyproject.toml. f10f8b2
[pre-commit.ci] pre-commit autoupdate. d626f7d
updates: - https://github.com/python/black → https://github.com/psf/black
Fixed bug in SCMInfo setup. e8fddc9
Fixed bug in SCMInfo setup. e8fddc9
Fixed missing xml coverage report. 696503f
Fixed assertion in failing test. 7afe58c
Fixes issue when new version equals current version. 64b0de3
Fixes issue of duplicate tags. c025650
Fixed automation tooling. 19f13b7
Fixed configuration to allow_dirty in bumpversion. b042e31
Fixed configuration to allow_dirty in bumpversion. b042e31
Fixes issue with generate-changelog and git. 2a977af
Fixes the quoting in the bumpversion expressions. 9a55d6d
Fixed issue with windows testing. b8abc44
Fixes windows testing error. 556853b
Fixed type issue in Python 3.7, 3.8. ddfd3bf
Fixed configuration file detection. fbf85c2
Doesn't just stop when it finds one, it checks for the existence of the header.
Fixed logging output and output in general. 0aea9dc
Added additional option to manual runs: verbose. 81eb097
Added new workflows. a9cac5b
Added bumpversion.yaml to increase the version when a PR is closed
Added release.yaml to create a github release and upload things to PyPI
Added PYTHONUTF8 mode. 91a73e2
Added explicit environment variable declarations. 80fe7ef
Added a github CI workflow. 2b3b358
Added files for coverage to ignore. cfbba08
Added LICENSE. 34a9be5
Added tests for version parsing errors. 71a204b
Added utf8 test in files. 9cb8f60
Added more tests for scm. fe794dd
Added --list function. 88709fd
Removing testing for Python 3.7. 19eaeef
Moved configuration to pyproject.toml. d339007
Initial conversion. f5d1cab
Initial commit. d7dec79
Updated workflows. 857835d
Improved documentation. f3b7a0f
Renamed tox job to test. a9b6db3
Updated README and other documentation. e0cebb3
Improved Mercurial support. 560999d
Improved logging output. 6ccfa7d
Changed errors to subclass UsageError. a447651
Changed BaseVCS to SourceCodeManager. 11c5609
Just for consistency.
Modified the group command back to a single command. 6d4179b
Will eventually change to a group command, but later.
Your coding agent can read these notes before it upgrades. Set up the MCP server →