If you’re using uv as your Python package manager and want a minimal way to bump versions and tag releases, I just published a small helper project: uv-version-bumper.
What It Does
This tool automates a few common steps:
- Verifies your git repository is clean
- Bumps your project version (patch, minor, or major)
- Updates your
uvlock file - Commits the changes
- Creates a git tag
All of this is done via a simple justfile, which you can run using uvx—so there’s no need to install just manually.
How to Use It
- Copy the
justfileinto your project root. - Run commands like:
uvx --from just-bin just bump-patch
uvx --from just-bin just push-all
This will bump the version, update the lock file, commit the changes, and push the tag to your git remote.
Why
Until uv adds native support for task automation (issue #5903), this setup offers a lightweight workaround without leaving the uv ecosystem.
Try It
Repo is here: https://github.com/alltuner/uv-version-bumper
MIT licensed. Feedback welcome.