Module execution 

Shared execution helpers for publish workflows.

Absorbed from the former shipper-execution-core microcrate. These items are pub (rather than pub(crate)) because an external fuzz target in fuzz/ exercises them directly; they will be tightened to pub(crate) once the fuzz surface is rationalized in a later pass.

Structs

RegistryProfile

Registry-specific publish constraints that affect retry pacing and operator estimates.

Enums

RegistryAmbiguityModel

How Shipper should treat ambiguous cargo publish output for this registry.

RegistryPropagationModel

How Shipper expects a registry to propagate newly published packages.

Constants

CRATES_IO_NEW_CRATE_WINDOW

crates.io’s documented rate-limit window for new-crate publishes: 10 min. After the 5-crate account burst is consumed, new crates are admitted at most once per CRATES_IO_NEW_CRATE_WINDOW. Source: https://crates.io/docs/rate-limits.

Functions

append_attempt_detail

Append an attempt detail to an in-memory state and refresh its timestamp.

backoff_delay

Calculate the delay for a retry attempt.

classify_cargo_failure

Classify a cargo failure output into retry semantics for publish decisioning.

looks_like_rate_limit

Return true if an error message looks like a rate-limit signal (HTTP 429 / “too many requests” / “rate limit” phrasings that appear in cargo publish stderr or common registry error bodies). Used to gate the crates.io-aware backoff adjustment: we only extend the delay when we believe we’re actually being rate-limited.

pkg_key

Create a stable key for a package version.

record_attempt_detail

Append an attempt detail and persist the execution state.

registry_aware_backoff

Registry-aware backoff. Layered on top of the generic backoff_delay: if we’re publishing a brand-new crate and the retry is caused by a rate-limit signal, floor the delay at CRATES_IO_NEW_CRATE_WINDOW so we stop burning retries during the 10-minute window crates.io has already told us to wait through. Everything else uses the generic delay.

registry_profile_aware_backoff

Registry-profile-aware backoff.

resolve_state_dir

Resolve the effective state directory from a workspace root and user option.

retry_after_delay

Parse a Retry-After header value from cargo/registry output.

retry_next_attempt_at

Calculate the wall-clock time for a scheduled retry.

short_state

Short, human-readable label for a package state.

update_state

Update a package state and persist the entire execution state to disk.

update_state_locked

Update a package state inside an in-memory execution state.