poetry-bumpversion

The poetry version command only updates version in pyproject.toml file. This plugin updates version in other files when poetry version <version> command is executed.

Getting Started

Prerequisites

python = ^3.10
poetry = ^2.0

Install

Install the plugin by poetry plugin command.

poetry self add poetry-bumpversion

Configure version replacements

Say you have __version__ variable set at your_package/__init__.py file

__version__ = "0.1.0" # It MUST match the version in pyproject.toml file

Add the following to your pyproject.toml file.

[tool.poetry_bumpversion.file."your_package/__init__.py"]
# Duplicate the line above to add more files

Now run poetry version patch --dry-run, if your output looks somewhat like below you are all set (dry-run does not update any file).

Bumping version from 0.5.0 to 0.5.1
poetry-bumpversion: processed file: your_package/__init__.py

If dry-run output looks fine you can run version update command without dry-run flag to check if version in both pyproject.toml and your_package/__init__.py file has been updated.

Advanced Usage

You can define search and replace terms to be more precise

[tool.poetry_bumpversion.file."your_package/__init__.py"]
search = '__version__ = "{current_version}"'
replace = '__version__ = "{new_version}"'

You can define replacements if you have same search/replace patterns across multiple files.

[[tool.poetry_bumpversion.replacements]]
files = ["your_package/__init__.py", "your_package/version.py"]
search = '__version__ = "{current_version}"'
replace = '__version__ = "{new_version}"'

[[tool.poetry_bumpversion.replacements]]
files = ["README.md"]
search = 'version: {current_version}'
replace = 'version: {new_version}'

Usage with Github Workflow

This plugin can be used to bump version automatically during publishing to PyPI using a GitHub workflow. When a release tag is created the workflow will use that tag name e.g 2.0.1 to update versions in every files, build the package and publish to PyPI. This is how this plugin is deployed to PyPI.

To get started you can copy the deploy workflow code from this repo to your repo and set it up.

License

This project is licensed under MIT License - see the LICENSE file for details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

poetry_bumpversion-0.4.0.tar.gz (5.3 kB view details)

Uploaded Sep 2, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

poetry_bumpversion-0.4.0-py3-none-any.whl (6.3 kB view details)

Uploaded Sep 2, 2026 Python 3

File details

Details for the file poetry_bumpversion-0.4.0.tar.gz.

File metadata

Download URL: poetry_bumpversion-0.4.0.tar.gz
Upload date: Sep 2, 2026
Size: 5.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for poetry_bumpversion-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`a34e2cc97c549af6cdc3a7584e3ffab3b778afad01458ad37da4e7a91a1286e4`
MD5	`e161fb1e9b009abffa4e5b83335cfa7c`
BLAKE2b-256	`6972a1b3c0c29ed8c64d95ac384ba24df89a2db6e6fcc8620a68f27139cbd79f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for poetry_bumpversion-0.4.0.tar.gz:

Publisher: deploy.yml on monim67/poetry-bumpversion

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: poetry_bumpversion-0.4.0.tar.gz
- Subject digest: a34e2cc97c549af6cdc3a7584e3ffab3b778afad01458ad37da4e7a91a1286e4
- Sigstore transparency entry: 2688253048
- Sigstore integration time: Sep 2, 2026
Source repository:
- Permalink: monim67/poetry-bumpversion@3a7c58de91a5db9a78edac57adec74ce123b3b58
- Branch / Tag: refs/tags/0.4.0
- Owner: https://github.com/monim67
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: deploy.yml@3a7c58de91a5db9a78edac57adec74ce123b3b58
- Trigger Event: release