# Bump Anything
*Copyright 2019-2025 Caleb Evans*
*Released under the MIT license*
[](https://github.com/caleb531/bump-anything/actions/workflows/tests.yml)
[](https://coveralls.io/r/caleb531/bump-anything?branch=main)
Bump Anything is a command-line utility for incrementing the version It serves
as a more-flexible alternative to `npm version` and similar tools because
Bump Anything can handle any arbitrary text file and has built-in support for
different types of projects.
## Features
- Bump the version number in any arbitrary file
- Supports most project types (if no paths are supplied, automatically detects
`package.json` in Node, `setup.py` or `pyproject.toml` in Python, `style.css`
for WordPress themes, etc.)
## Installation
Bump Anything requires Python 3.9 or newer to run, so please ensure you have it
installed.
```sh
pip3 install bump-anything
```
## Usage
Bump Anything exposes to your shell a `bump-anything` command (also aliased to
`bump`). The only required argument is a keyword indicating how you want to
increment each version. It can be either `major`, `minor`, or `patch`.
```sh
bump major # 1.2.3 -> 2.0.0
```
```sh
bump minor # 1.2.3 -> 1.3.0
```
```sh
bump patch # 1.2.3 -> 1.2.4
```
```sh
bump prerelease # 1.2.3-beta.1 -> 1.2.3-beta.2
```
```sh
bump 2.3.4
```
```sh
bump v2.3.4 # same as `bump 2.3.4`
```
With this syntax, Bump Anything will do its best to find the relevant files to
bump. However, Bump Anything can also accept an optional list of one or more
file paths whose versions to bump. Only the first occurrence of the version
field in each file will be updated.
```sh
bump minor subdir/myfile1.json subdir/myfile2.toml
```
### Git Integration
The `bump` command will automatically create a tagged commit if the current
directory is a Git repository. Only the files that have been modified by `bump`
will be staged.
### Custom commit message
You can explicitly specify the commit message with `--commit-message` or `-m`.
The default is `Prepare v<new_version> release`. You can use the `{new_version}`
placeholder to represent the new version (without any prefix).
```sh
bump --commit-message 'Release v{new_version}' major
```
```sh
bump -m 'Release v{new_version}' major
```
### Custom tag name
You can explicitly specify the tag name with `--tag-name` or `-t` (default:
`v<new_version>`). You can use the `{new_version}` placeholder to represent the
new version (without any prefix).
```sh
bump --tag-name 'release/{new_version}' patch
```
```sh
bump -t 'release/{new_version}' patch
```
### Disabling committing and/or tagging
If you do not wish for `bump` to automatically create a commit and tag, you can
pass the `--no-commit` flag (alias: `-n`):
```sh
bump --no-commit minor
```
```sh
bump -n minor
```
### Disabling tagging only
If you wish to disable the automatic tag creation but still create a commit, you
can pass the `--no-tag` flag:
```sh
bump --no-tag patch
```
## Auto-Detected Files
- `package.json` (Node)
- `package-lock.json` (Node)
- `setup.py` (Python)
- `setup.cfg` (Python)
- `pyproject.toml` (Python)
- `style.css` (WordPress Theme)
- `Cargo.toml` (Rust package manifest)
- `<cwd name>.php` (WordPress Plugin)
Raw data
{
"_id": null,
"home_page": null,
"name": "bump-anything",
"maintainer": "Caleb Evans",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Caleb Evans <caleb@calebevans.me>",
"keywords": "semver, semantic, version, versioning, bump, increment",
"author": "Caleb Evans",
"author_email": "Caleb Evans <caleb@calebevans.me>",
"download_url": "https://files.pythonhosted.org/packages/f2/69/fff8fc751226f560f5bed5b7824d376099039498f462a4ce1778daf8cc33/bump_anything-2.3.0.tar.gz",
"platform": null,
"description": "# Bump Anything\n\n*Copyright 2019-2025 Caleb Evans* \n*Released under the MIT license*\n\n[](https://github.com/caleb531/bump-anything/actions/workflows/tests.yml)\n[](https://coveralls.io/r/caleb531/bump-anything?branch=main)\n\nBump Anything is a command-line utility for incrementing the version It serves\nas a more-flexible alternative to `npm version` and similar tools because\nBump Anything can handle any arbitrary text file and has built-in support for\ndifferent types of projects.\n\n## Features\n\n- Bump the version number in any arbitrary file\n- Supports most project types (if no paths are supplied, automatically detects\n `package.json` in Node, `setup.py` or `pyproject.toml` in Python, `style.css`\n for WordPress themes, etc.)\n\n## Installation\n\nBump Anything requires Python 3.9 or newer to run, so please ensure you have it\ninstalled.\n\n```sh\npip3 install bump-anything\n```\n\n## Usage\n\nBump Anything exposes to your shell a `bump-anything` command (also aliased to\n`bump`). The only required argument is a keyword indicating how you want to\nincrement each version. It can be either `major`, `minor`, or `patch`.\n\n\n```sh\nbump major # 1.2.3 -> 2.0.0\n```\n\n```sh\nbump minor # 1.2.3 -> 1.3.0\n```\n\n```sh\nbump patch # 1.2.3 -> 1.2.4\n```\n\n```sh\nbump prerelease # 1.2.3-beta.1 -> 1.2.3-beta.2\n```\n\n```sh\nbump 2.3.4\n```\n\n```sh\nbump v2.3.4 # same as `bump 2.3.4`\n```\n\nWith this syntax, Bump Anything will do its best to find the relevant files to\nbump. However, Bump Anything can also accept an optional list of one or more\nfile paths whose versions to bump. Only the first occurrence of the version\nfield in each file will be updated.\n\n```sh\nbump minor subdir/myfile1.json subdir/myfile2.toml\n```\n\n### Git Integration\n\nThe `bump` command will automatically create a tagged commit if the current\ndirectory is a Git repository. Only the files that have been modified by `bump`\nwill be staged.\n\n### Custom commit message\n\nYou can explicitly specify the commit message with `--commit-message` or `-m`.\nThe default is `Prepare v<new_version> release`. You can use the `{new_version}`\nplaceholder to represent the new version (without any prefix).\n\n```sh\nbump --commit-message 'Release v{new_version}' major\n```\n\n```sh\nbump -m 'Release v{new_version}' major\n```\n\n### Custom tag name\n\nYou can explicitly specify the tag name with `--tag-name` or `-t` (default:\n`v<new_version>`). You can use the `{new_version}` placeholder to represent the\nnew version (without any prefix).\n\n```sh\nbump --tag-name 'release/{new_version}' patch\n```\n\n```sh\nbump -t 'release/{new_version}' patch\n```\n\n### Disabling committing and/or tagging\n\nIf you do not wish for `bump` to automatically create a commit and tag, you can\npass the `--no-commit` flag (alias: `-n`):\n\n```sh\nbump --no-commit minor\n```\n\n```sh\nbump -n minor\n```\n\n### Disabling tagging only\n\nIf you wish to disable the automatic tag creation but still create a commit, you\ncan pass the `--no-tag` flag:\n\n```sh\nbump --no-tag patch\n```\n\n## Auto-Detected Files\n\n- `package.json` (Node)\n- `package-lock.json` (Node)\n- `setup.py` (Python)\n- `setup.cfg` (Python)\n- `pyproject.toml` (Python)\n- `style.css` (WordPress Theme)\n- `Cargo.toml` (Rust package manifest)\n- `<cwd name>.php` (WordPress Plugin)\n",
"bugtrack_url": null,
"license": null,
"summary": "A CLI utility for bumping the version of any file type",
"version": "2.3.0",
"project_urls": {
"changelog": "https://github.com/caleb531/bump-anything/releases",
"documentation": "https://github.com/caleb531/bump-anything#readme",
"homepage": "https://github.com/caleb531/bump-anything",
"repository": "https://github.com/caleb531/bump-anything"
},
"split_keywords": [
"semver",
" semantic",
" version",
" versioning",
" bump",
" increment"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "395532673018be31cdd9b5c6797f217e71422a738073619a70d3ba861d3d5e8d",
"md5": "81a87fcb271cb94141611c371d23f69f",
"sha256": "576e83e6805cb3aaffa4d9196bf6f31d37416080138da455211828463f9b1949"
},
"downloads": -1,
"filename": "bump_anything-2.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "81a87fcb271cb94141611c371d23f69f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6394,
"upload_time": "2025-08-30T00:03:52",
"upload_time_iso_8601": "2025-08-30T00:03:52.466006Z",
"url": "https://files.pythonhosted.org/packages/39/55/32673018be31cdd9b5c6797f217e71422a738073619a70d3ba861d3d5e8d/bump_anything-2.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f269fff8fc751226f560f5bed5b7824d376099039498f462a4ce1778daf8cc33",
"md5": "71d5e3c92e7cba0f19868cb8585c3924",
"sha256": "840d6eaebffbea01f037c52dc719837fb7758f4371a9f6e06deb21e8e8b8dd7b"
},
"downloads": -1,
"filename": "bump_anything-2.3.0.tar.gz",
"has_sig": false,
"md5_digest": "71d5e3c92e7cba0f19868cb8585c3924",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 5121,
"upload_time": "2025-08-30T00:03:53",
"upload_time_iso_8601": "2025-08-30T00:03:53.653663Z",
"url": "https://files.pythonhosted.org/packages/f2/69/fff8fc751226f560f5bed5b7824d376099039498f462a4ce1778daf8cc33/bump_anything-2.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-30 00:03:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "caleb531",
"github_project": "bump-anything",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "bump-anything"
}
JSON
