Version bumping and git tagging for uv-managed Python projects.
A single justfile. Drop it in, run just bump-patch.

Sponsor

1. Copy the justfile from this repository into your Python project root.

2. Run any of the bump commands directly via uvx:

   uvx --from just-bin just bump-patch

No need to install just globally — uvx handles the binary on the fly.

A small justfile that automates the boring half of releasing a Python project: bumping the version in pyproject.toml, refreshing the lockfile, committing, and tagging. It's intentionally minimal: no changelog generation, no release notes, no CI integration. If you need any of those, see Other tools.

1. Verify the git repository is clean (no uncommitted changes).
2. Record the current version.
3. Bump the version in pyproject.toml.
4. Run uv sync to refresh the lockfile.
5. Commit the change and the lockfile in a single commit.
6. Create an annotated git tag.

uvx --from just-bin just bump-patch   # 0.1.0 -> 0.1.1
uvx --from just-bin just bump-minor   # 0.1.1 -> 0.2.0
uvx --from just-bin just bump-major   # 0.2.0 -> 1.0.0
uvx --from just-bin just version      # Print the current version
uvx --from just-bin just push-all     # Push the bump commit and tag

• uv ≥ 0.7.0.
• Git.
• A pyproject.toml that uses the [project] version field.

If you need changelog generation, release notes, or CI/CD integration, look at:

• python-semantic-release
• bump2version
• release-it

uv is tracking native task support. Once that lands, this justfile becomes redundant; this README will be updated with the migration path.

MIT

uv-version-bumper is an open source project built by David Poblador i Garcia through All Tuner Labs.

If this project was useful to you, consider supporting its development.

Built by David Poblador i Garcia with the support of All Tuner Labs.
Made with ❤️ in Poblenou, Barcelona.