Skip to main content

Crate eggpack_contract

Crate eggpack_contract 

Source
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§

ArchiveMember
One archive member: a literal relative source path plus its install name.
ArchiveMemberInventory
Bounded, validated archive member paths supplied by a listing tool or fixture.
BundleEntry
One bundle entry: a single asset file plus its install name.
ChecksumSpec
Checksum sidecar naming. Integrity metadata only; never authenticity.
ConformanceFinding
One deterministic conformance finding with bounded expected/observed values.
ConformanceReport
Deterministic, bounded result of a conformance check.
DistributionContract
A versioned distribution contract (schema v1).
ExpandedArchive
Expanded archive asset.
ExpandedArchiveMember
One expanded archive member.
ExpandedBundle
Expanded multi-asset bundle.
ExpandedDirect
One expanded direct asset (file, install name, and sidecar).
ExpandedTarget
A resolved and expanded target.
ExpectedReleaseFile
One required flat release file and its stable diagnostic label.
ObservedArchiveMapping
One observed archive-member-to-install-name mapping.
ObservedDirectMapping
One observed direct asset mapping reported by consumer-owned runtime/bootstrap tests.
ObservedTargetMapping
Machine-readable mapping facts extracted by consumer-owned tests or tooling.
ProductIdentity
Opaque product identity. Version semantics remain caller-owned.
ReleaseInventory
Bounded, validated list of flat names supplied by a release client or fixture.
TargetEntry
One supported target entry.

Enums§

AssetForm
Asset layout for one target. A small tagged enum, not a generic package language.
DistError
Typed distribution errors. Parsing never guesses or falls back.
ExpandedAssets
Expanded asset forms.
ExtrasPolicy
Caller policy for observed names that the contract does not require.
FindingKind
Stable kind for one conformance finding.
NameNamespace
Namespace in which an expanded filename collision occurred.
ObservedTargetAssets
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.