eggup-curl 0.1.2

External curl acquisition adapter for Eggup (bounded, no release policy)
Documentation
  • Coverage
  • 100%
    27 out of 27 items documented0 out of 14 items with examples
  • Size
  • Source code size: 71.0 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 358.1 kB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 2s Average build duration of successful builds.
  • all releases: 2s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Homepage
  • eggstack/eggup
    0 0 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • dbowm91

eggup-curl

External-curl acquisition adapter for Eggup.

Implements eggup-acquisition::AcquisitionTransport without an embedded HTTP/TLS stack. A caller supplies an explicit curl executable path (or opts in to PATH discovery), and the adapter invokes it directly with no shell, no sudo, and no release/version/mirror policy.

  • Exact caller-selected URLs only; no discovery, no fallback inside the adapter.
  • Explicit connect/total ceilings (min(request, adapter)), serialized as locale-independent decimal-second --connect-timeout / --max-time plus an independent parent wall deadline. Sub-second caller deadlines are honored truthfully (truncated to whole microseconds); sub-microsecond positive durations are rejected at validation rather than widened.
  • Timeout classification labels the connect phase using only the parent scheduling tolerance (POLL_INTERVAL + 5 ms); there is no whole-second truthfulness allowance.
  • Cancellation and timeout kill and reap the owned child before return.
  • HTTP status is captured from the same transfer (-w "%{stderr}%{http_code}"); no second probe. Exact 404 becomes FetchOutcome::NotFound and never triggers fallback inside the transport.
  • Missing executable / discovery failure / spawn failure becomes typed AcquisitionError::Unavailable for safe composition. TLS/5xx/timeout are ordinary hard failures.
  • Response bodies stream from curl stdout into Eggup's retained exclusive output handle; status is drained separately from stderr. The pathname is never handed back to curl for reopening. Artifacts use a private temp sibling (0600 Unix) and race-safe no-clobber promotion; partial output cleans only the owned temp.
  • Redirect, protocol, and proxy policy are explicit. ~/.curlrc is ignored via --disable. Disabled proxy uses a cleared environment plus --noproxy "*".
  • Diagnostics use category text plus the redacted URL; raw curl output, command lines, and proxy credentials are never embedded.

Transport fallback (curl <-> Eggfetch for the same exact URL) lives in eggup-acquisition::ComposedTransport and is never release/source fallback.