Open-Source Wikis

/

uv

/

Reference

/

Data models

astral-sh/uv

Data models

A quick map of the most central types in uv and where they live.

Versions and requirements

Type Crate Used for
Version uv-pep440 Any PEP 440 version.
VersionSpecifier uv-pep440 A single specifier (>=1.0).
VersionSpecifiers uv-pep440 Conjunction of specifiers.
VersionRanges uv-pep440 Range arithmetic for the resolver.
Requirement uv-pep508 PEP 508 requirement.
Requirement (uv flavor) uv-distribution-types Internal extension with sources.
MarkerTree uv-pep508 Boolean tree of marker expressions.
MarkerEnvironment uv-pep508 Runtime values for markers.

Distributions

Type Crate Used for
Dist uv-distribution-types Top-level enum: built or source.
BuiltDist uv-distribution-types A wheel from a registry / URL / path.
SourceDist uv-distribution-types An sdist / git / path.
BuildableSource uv-distribution-types Sources that need building.
InstalledDist uv-distribution-types An installed package.
CachedDist uv-distribution-types A wheel in the cache.
ResolvedDist uv-distribution-types A resolution-graph node.
WheelFilename, SourceDistFilename uv-distribution-filename Parsed filenames.

Identifiers

Type Crate Used for
PackageName uv-normalize Normalized package name.
ExtraName uv-normalize Normalized extra name.
GroupName uv-normalize Dependency-group name.

Indexes and configuration

Type Crate
IndexUrl, IndexLocations, Index uv-distribution-types
Options uv-settings
BuildContext uv-types
Concurrency, BuildIsolation, Reinstall uv-configuration

Cache

Type Crate
Cache, CacheBucket, CacheShard, CacheEntry, Refresh uv-cache
Timestamp uv-cache-info

Built by Factory AutoWiki from public repository content. It is a generated preview for codebase exploration, not source-maintained documentation.

Data models – uv wiki | Factory