Python uv¶

Python packages managed with uv’s uv pip interface.

Installed and outdated packages are read with uv pip list (adding --outdated and --format=json), acting on whatever environment uv resolves, exactly as a bare uv pip call in the same shell would. The --outdated listing sets the >=0.5.0 version floor, the first uv release to ship it. The release-age cooldown rides on uv’s --exclude-newer resolver option, which every resolving subcommand honors, so one cutoff covers install, upgrade and outdated together.

Hint

Package specs are passed unquoted, working around uv parse failures on quoted specs.

Home page: https://docs.astral.sh/uv
Source: meta_package_manager/managers/uv.py
Version requirement: >=0.5.0

Platforms¶

🅱️ BSD
🐧 Linux
🍎 macOS
⨂ Unix
🪟 Windows

Operations¶

Operation	Supported	Notes
`installed`	✓
`outdated`	✓
`search`
`install`	✓
`upgrade`	✓
`upgrade_all`	✓	backfilled by `mpm`
`remove`	✓
`sync`
`cleanup`	✓

Ecosystem¶

Accepted purl types: pkg:pypi, pkg:uv

Usage¶

$ mpm --uv installed
$ mpm --uv upgrade --all
$ mpm install pkg:uv/hello
$ mpm --dry-run --uv upgrade --all

Every example above accepts --dry-run, which simulates the underlying manager calls without touching the system: the safe way to watch what mpm would do before trusting it.

Deselect the manager for a single run with --no-uv, disable it from your configuration, or tune its invocation attributes with per-manager overrides.

Command line¶

CLI names, in lookup order: uv
Arguments forced before each call: --color never --no-progress

The version is extracted from the output of uv --version with:

r"uv\s+(?P<version>\S+)"

Privilege escalation¶

mpm runs this manager as the current user and never prepends sudo by default. Flip the policy for its privileged operations with --sudo or the per-manager sudo override.

See privilege escalation for the full policy.

Cooldown¶

mpm natively enforces its release-age cooldown on Python uv, injecting the UV_EXCLUDE_NEWER environment variable on every call.

Status: ✅ Enforced
Mechanism: exclude-newer env UV_EXCLUDE_NEWER
Reference: uv docs

Reference traces¶

Raw native outputs captured in the manager source: the reference mpm’s parsers were written against. If you know Python uv well and a transcript below looks wrong, or a newer release changed its output format, report it.

$ uv --color never --no-progress pip list --format=json
[
  {
    "name": "markupsafe",
    "version": "2.1.5"
  },
  {
    "name": "meta-package-manager",
    "version": "5.17.0",
    "editable_project_location": "/Users/kde/meta-package-manager"
  },
  {
    "name": "myst-parser",
    "version": "3.0.1"
  }
]

$ uv --color never --no-progress pip list --outdated --format=json
[
  {
    "name": "lark-parser",
    "version": "0.7.8",
    "latest_version": "0.12.0",
    "latest_filetype": "wheel"
  },
  {
    "name": "types-setuptools",
    "version": "75.3.0.20241107",
    "latest_version": "75.3.0.20241112",
    "latest_filetype": "wheel"
  }
]