uv-dynamic-versioning

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

• microsoft/essex-toolkit: uses the version source plugin.
• modelcontextprotocol/python-sdk: uses the version source plugin.
• pydantic/pydantic-ai: uses the version source and the metadata hook plugins.

And more.

Alternatives

• hatch-vcs: Hatch plugin for versioning with your preferred VCS.
• versioningit: Versioning It with your Version In Git.