uv-dynamic-versioning
February 28, 2026 ยท View on GitHub
poetry-dynamic-versioning influenced dynamic versioning tool for uv/hatch, powered by dunamai.
Note
This plugin doesn't work with the uv build backend right now. (ref. astral-sh/uv#14561)
Installation
Update or add build-system to use uv-dynamic-versioning.
[build-system]
requires = ["hatchling", "uv-dynamic-versioning"]
build-backend = "hatchling.build"
Plugins
This project offers two plugins:
- Version source plugin: is for setting a version based on VCS.
- Metadata hook plugin: is for setting dependencies and optional-dependencies dynamically based on VCS version. This plugin is useful for monorepo.
See Version Source and Metadata Hook for more details.
Tips
See Tips.
Examples
See Examples.
Projects Using uv-dynamic-versioning
- Version Source:
- Metadata Hook:
And more.
Alternatives
- hatch-vcs: Hatch plugin for versioning with your preferred VCS.
- versioningit: Versioning It with your Version In Git.