eggup-acquisition
Transport-neutral acquisition seam for Eggup consumers.
The crate defines the smallest contract that can stream an artifact into Eggup-owned staging without selecting release, fallback, version, destination, or service policy:
AcquisitionRequest: an exact caller-selected URL (no discovery, no fallback).FetchLimits: caller-provided byte and time bounds.FetchOutcome::{Success, NotFound}vs hardAcquisitionError: 404-style absence is data; TLS/proxy/timeout/5xx/malformed responses are hard failures that never trigger fallback inside a transport.AcquisitionTransport::fetch_metadata(bounded small body) andfetch_artifact(streamed to a file).FixtureTransport: deterministic in-memory transport for correctness tests; real network policy lives ineggup-eggfetch(native) andeggup-curl(external process).AcquisitionError::Unavailable: typed adapter-unavailable condition (missing executable, discovery failure, spawn failure) for safe composition.ComposedTransport+CompositionPolicy: explicit caller-selected preferred/fallback composition over two transports.
Transports never execute downloaded content, never choose fallback, and redact credential-bearing URL material in diagnostics.
Transport fallback (curl <-> Eggfetch for the same exact URL) is never
release/source fallback. NotFound is terminal for the exact URL under every
policy. InvalidInput, Cancelled, TooLarge, and Io
(staging/promotion) failures are terminal under every policy. Default policy
(UnavailableOnly) falls back only when the preferred adapter is unavailable;
broader transport-error fallback (UnavailableOrTransport) requires an
explicit caller choice. Verification/candidate failures occur above this layer
and are never transport-fallback inputs.
Effective time bounds (M003 corrective):
effective connect timeout = min(request connect, adapter connect ceiling)
effective total timeout = min(request total, adapter total ceiling)
A stricter adapter may tighten a deadline but never extends one.
FetchLimits::new and FetchLimits::validate require a metadata bound in
1..=16 MiB, a positive finite artifact-byte cap, non-zero timeouts, and
connect <= total. Every transport revalidates direct struct literals at
entry before route lookup, filesystem mutation, or network I/O. Migration:
replace max_artifact_bytes: Some(n) with max_artifact_bytes: n; None is
no longer representable. The default remains a finite 128 MiB cap.
Both metadata and artifact operations use the same derivation; the total
covers headers plus body streaming. A caller deadline produces
AcquisitionError::Timeout, never NotFound/fallback.
Artifact staging (M003 corrective):
- Temporary siblings are exclusively created (
create_new, bounded retry, never follows symlinks), owner-private0600on Unix, in the exact destination parent (same filesystem). - Promotion requires
destto be absent and uses race-safe no-replace semantics (hard_linkfails withAlreadyExistswithout overwriting). An existing or raced-in destination fails explicitly and is preserved. - Successful hard-link creation is the promotion commit point. Removing the redundant owned temp link is best-effort cleanup; if it fails, the complete destination is still reported as success and the temp residue may remain.
- Cleanup removes only the owned temp; foreign files are preserved. No prefix-based scavenging.
Diagnostics (M003 corrective):
redact_urlstrips userinfo, query, and fragment.- Transport failures use structured category text plus the redacted URL. Raw upstream/proxy error display is never embedded, so URL credentials, query tokens, and proxy secrets cannot leak.