uv-configuration

crates/uv-configuration/ holds the small enums and structs that configure resolver, installer, and build behavior. It is intentionally dependency-light so that every other crate can reach for these types without dragging in heavyweight transitive deps.

Key abstractions

A non-exhaustive list of types defined here:

• BuildKind — Wheel / SourceDist / Editable.
• BuildOutput — Hidden / Stderr / Capture for build subprocess streaming.
• Concurrency — semaphores for downloads, installs, and builds (configurable via UV_CONCURRENT_* env vars).
• Reinstall / Upgrade / Upgrade::Package — behavior toggles for resolution and install.
• IndexStrategy — FirstIndex / UnsafeFirstMatch / UnsafeBestMatch.
• KeyringProviderType — disabled / subprocess / specific backend.
• ConfigSettings, LowerBound, PreviewMode, SourceStrategy, TargetTriple.
• TrustedHost, TrustedPublishing.

Why a separate crate

These types are referenced from CLI parsing, settings, the resolver, the installer, and docstring annotations. Keeping them in one place avoids cycles and gives the JSON schema generator (uv-options-metadata) a single source.

See also

• uv-settings for the wider configuration surface.