uv-update-check 0.3.0

Check for dependency updates in pyproject.toml, like ncu for uv projects

uuc — uv update check

A minimalist npm-check-updates equivalent for uv projects. Check your pyproject.toml dependencies against PyPI and see what's outdated — in the exact same output style as ncu.

$ uuc
Checking /path/to/pyproject.toml
[====================] 9/9 100%

 httpx           >=0.27 → >=0.28.1
 rich              >=13 → >=14.3.3
 typer           >=0.12 → >=0.24.1
 pytest             >=8 → >=9.0.2
 pytest-asyncio  >=0.24 → >=1.3.0

Run uuc -u to upgrade pyproject.toml

Updates are color-coded by severity: red for major, cyan for minor, green for patch — with partial version coloring just like ncu.

Install

uv tool install uv-update-check

Or run directly without installing:

uvx uv-update-check

Usage

# Show outdated dependencies (read-only, default)
uuc

# Update pyproject.toml with latest versions
uuc -u

# Only show minor/patch updates (no breaking changes)
uuc -t minor

# Only show patch updates
uuc -t patch

# Exclude specific packages
uuc -x httpx,rich

# Check a specific project
uuc --path /path/to/pyproject.toml

# Include pre-release versions
uuc --pre

# Combine flags
uuc -t minor -x httpx -u

Options

Flag	Description
-u, --update	Rewrite pyproject.toml with new versions
-t, --target	Target version level: latest (default), minor, patch
-x, --reject	Exclude packages (comma-delimited)
-p, --path	Path to pyproject.toml (default: search from cwd)
--pre	Include pre-release versions
-V, --version	Show version

What it checks

uuc discovers dependencies from all standard pyproject.toml sections:

• [project.dependencies]
• [project.optional-dependencies.*]
• [dependency-groups.*] (PEP 735)

It supports all common version specifiers: >=, ~=, ==, ^, >, <, !=.

What it skips

• URL, git, and path dependencies
• Dependencies with no version specifier
• {include-group = "..."} entries in dependency groups

How it works

1. Finds and parses pyproject.toml using tomlkit (preserves formatting and comments)
2. Extracts all dependencies from the sections above
3. Fetches latest versions from the PyPI JSON API concurrently using httpx + anyio
4. Compares versions using packaging with semver-aware classification
5. Displays results in ncu-style output with Rich
6. With -u, rewrites pyproject.toml in-place preserving all formatting, comments, and ordering

Differences from similar tools

Tool	What it does	How uuc differs
uv lock --upgrade	Upgrades within existing constraints	uuc shows what's available beyond your constraints
uv pip list --outdated	Shows outdated installed packages	uuc checks pyproject.toml constraints, not installed versions
pip-check-updates	Similar concept	uuc is uv-native with dependency-groups support

Requirements

• Python >= 3.14

License

MIT