check-updates

Check Python dependency versions on PyPI. Run the command in the directory that contains pyproject.toml.

pip install check-updates

# List available updates without changing files.
check-updates

# Apply updates to pyproject.toml.
check-updates -u

# List updates for the uv workspace root and members.
check-updates -w

# Apply updates across the uv workspace.
check-updates -u -w

# Select updates, preview changes, and confirm.
check-updates -i

# Select updates across the uv workspace.
check-updates -i -w

Example output:

Dependency updates

pyproject.toml:
╭─────────────────────┬────────┬────────┬──────────────────────╮
│ Current requirement │ Target │ Change │ Section              │
├─────────────────────┼────────┼────────┼──────────────────────┤
│ typer>=0.27.1       │ 0.27.3 │ patch  │ project.dependencies │
╰─────────────────────┴────────┴────────┴──────────────────────╯

1 dependency with updates in 1 file.
Change labels compare requirement versions, not installed versions or compatibility.
No files changed. Use -u to apply all updates or -i to select updates.

Tables group updates by project file and show the original requirement, target version, change label, and dependency section. Long requirements wrap instead of being truncated. Terminal output uses colors; redirected output has no ANSI color codes. Workspace hints include -w.

--upgrade, --workspace, and --interactive are the long forms of -u, -w, and -i.

Interactive Updates

Interactive mode requires terminal input and output. -i cannot be combined with -u. Invalid combinations or non-terminal input or output return exit code 2 before file reads or PyPI lookups. Listing commands and -u remain non-interactive.

The command completes reads and lookups before showing a selector. Entries start unchecked and are grouped by project file. Each entry shows its dependency section, original requirement, target version, and version-change label. Repeated dependencies can be selected separately.

• Arrow keys move between entries and project actions.
• Space toggles an entry. On a project action, Space selects all updates if any are unchecked; otherwise it clears the project.
• Enter reviews the selection. An empty selection exits without writing.
• Escape cancels without writing. Ctrl+C exits with code 130. Closed prompt input also cancels without writing.

Labels major, minor, and patch compare numeric release components against the requirement's version, not an installed version. unbounded means no version was specified. Epoch changes and other PEP 440 forms use other. Labels do not prove compatibility, including for packages below version 1.0.

After selection, the command shows unified diffs and dependency and file counts. Apply these changes? defaults to No. Enter keeps the default; arrows or Space change the choice. Press y to apply or n to cancel. Escape cancels here too. Only selected updates are written, using the exact content prepared for the preview. Diff display normalizes CRLF to LF and escapes other control characters; written bytes are unchanged by display formatting.

Before writing, the command checks every affected file against its original bytes. If a file was edited, deleted, or became unreadable during review, it returns exit code 1 without writing any files. This check does not prevent concurrent edits after the check. Comments, quotes, extras, markers, and line endings are preserved.

Workspace writes are sequential, not transactional. A write failure returns exit code 1 and reports the failing path; earlier successful updates remain listed in output. Review those files and use the displayed diff or version control to restore requirements if needed. The command does not reset user edits.

Workspaces

With -w, the command finds the nearest pyproject.toml with [tool.uv.workspace] in the current directory or its parents. It checks the root and each declared member, using the members and exclude glob patterns. Run it from the workspace root, a member, or a member subdirectory.

[tool.uv.workspace]
members = ["packages/*"]
exclude = ["packages/seeds"]

Workspace output identifies each project file. PyPI results are shared across projects. Dependencies marked with workspace = true or an external workspace path in [tool.uv.sources] are skipped. Root source definitions apply to members unless overridden by a member. External workspaces are not traversed.

If the workspace is missing, a selected member has no pyproject.toml, or a file or lookup fails, the command returns exit code 1. All files are read and all lookups finish before any updates are written. File-write failures can leave earlier files updated; multi-file writes are not transactional.

Without -w, only the current directory's pyproject.toml is checked.

Workspace discovery follows uv workspace configuration. It does not run uv.

Behavior

• Checks [project].dependencies, [project.optional-dependencies], and [dependency-groups].
• Selects the highest stable PyPI release with a non-yanked distribution file. Ignores prereleases and development releases.
• Updates single >=, ==, and ~= version constraints. Adds >=VERSION to requirements without a version constraint. Does not lower existing versions.
• Preserves extras, environment markers, comments, and TOML formatting. Checks marked dependencies regardless of the current environment.
• Reports and skips URL dependencies, wildcard pins, multiple constraints, exclusions, upper bounds, and strict > bounds. Dependency-group include entries remain unchanged.
• Returns exit code 1 for file, parsing, or network errors. Completes all lookups before applying updates, so lookup failures do not cause partial edits.

The command does not resolve dependencies or check Python-version compatibility. Review updates before installing them. It reads uv workspace configuration only with -w. It does not install packages, change lock files, or run uv lock or uv sync.

Development

After installing the project and development dependencies, run checks without updating the environment or lock file:

uv run --frozen --no-sync pytest
uv run --frozen --no-sync ruff check .
uv run --frozen --no-sync ty check .