Expand description
Versioned distribution contract schema for release-time tooling.
A DistributionContract describes one product’s release layout once:
target triples, platform aliases, asset file names, checksum sidecar
names, archive members, and install names. It does not fetch releases,
order versions, verify checksums, extract archives, generate installers,
or become a runtime dependency of ordinary consumers.
Structs§
- Archive
Member - One archive member: a literal relative source path plus its install name.
- Archive
Member Inventory - Bounded, validated archive member paths supplied by a listing tool or fixture.
- Bundle
Entry - One bundle entry: a single asset file plus its install name.
- Checksum
Spec - Checksum sidecar naming. Integrity metadata only; never authenticity.
- Conformance
Finding - One deterministic conformance finding with bounded expected/observed values.
- Conformance
Report - Deterministic, bounded result of a conformance check.
- Distribution
Contract - A versioned distribution contract (schema v1).
- Expanded
Archive - Expanded archive asset.
- Expanded
Archive Member - One expanded archive member.
- Expanded
Bundle - Expanded multi-asset bundle.
- Expanded
Direct - One expanded direct asset (file, install name, and sidecar).
- Expanded
Target - A resolved and expanded target.
- Expected
Release File - One required flat release file and its stable diagnostic label.
- Observed
Archive Mapping - One observed archive-member-to-install-name mapping.
- Observed
Direct Mapping - One observed direct asset mapping reported by consumer-owned runtime/bootstrap tests.
- Observed
Target Mapping - Machine-readable mapping facts extracted by consumer-owned tests or tooling.
- Product
Identity - Opaque product identity. Version semantics remain caller-owned.
- Release
Inventory - Bounded, validated list of flat names supplied by a release client or fixture.
- Target
Entry - One supported target entry.
Enums§
- Asset
Form - Asset layout for one target. A small tagged enum, not a generic package language.
- Dist
Error - Typed distribution errors. Parsing never guesses or falls back.
- Expanded
Assets - Expanded asset forms.
- Extras
Policy - Caller policy for observed names that the contract does not require.
- Finding
Kind - Stable kind for one conformance finding.
- Name
Namespace - Namespace in which an expanded filename collision occurred.
- Observed
Target Assets - Consumer-observed release layout for one target.
Constants§
- MAX_
OBSERVED_ ENTRIES - Maximum entries accepted in caller-supplied inventories and observations.
- SCHEMA_
V1 - Schema version 1. The only version understood by this crate.
Functions§
- expected_
release_ files - Derive the required release file names for a concrete target and version.
- validate_
archive_ member_ inventory - Validate required archive members for an expanded archive target.
- validate_
observed_ mapping - Compare consumer-observed target facts against one contract expansion.
- validate_
release_ inventory - Validate release completeness for an expanded target.