snippetbashTip

uv version — Read or update a project's version. More information: <https://docs.astral.sh/uv/reference/cli/#uv-v

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandupdateuv versionreadclimoreversionproject

Problem

How to use the uv version command: Read or update a project's version. More information: <https://docs.astral.sh/uv/reference/cli/#uv-version>.

Solution

uv version — Read or update a project's version. More information: <https://docs.astral.sh/uv/reference/cli/#uv-version>.

Display the current project version:

uv version

Set the project version to a specific value:

uv version {{1.2.3}}

Bump the project version using semantic versioning:

uv version --bump {{major|minor|patch}}

Preview version changes without writing to pyproject.toml:

uv version --bump {{patch}} --dry-run

Update version for a specific package in a workspace:

uv version --package {{package_name}} {{1.2.3}}

Display version in JSON format:

uv version --output-format json

Code Snippets

Display the current project version

uv version

Set the project version to a specific value

uv version {{1.2.3}}

Bump the project version using semantic versioning

uv version --bump {{major|minor|patch}}

Preview version changes without writing to `pyproject.toml`

uv version --bump {{patch}} --dry-run

Update version for a specific package in a workspace

uv version --package {{package_name}} {{1.2.3}}

Context

tldr-pages: common/uv version

Revisions (0)

No revisions yet.