#[non_exhaustive]pub enum AcquisitionError {
InvalidInput(String),
Transport(String),
TooLarge {
limit: u64,
},
Timeout {
phase: &'static str,
},
Cancelled,
Io {
operation: &'static str,
source: Error,
},
Unavailable(String),
}Expand description
Hard acquisition failure. Never used for NotFound.
Only Debug is derived. The Io variant carries a std::io::Error,
which implements neither Clone nor PartialEq/Eq, so those derives are
deliberately absent. This mirrors eggup-core’s published Error, which
derives only Debug for the same reason. Match on the variant and its
fields instead of comparing whole errors.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
InvalidInput(String)
Caller input violates the seam contract.
Transport(String)
A transport-level failure (TLS, proxy, 5xx, malformed response, early disconnect). URL material is already redacted.
TooLarge
The response exceeded a caller byte bound.
Timeout
A connect or total deadline elapsed.
Cancelled
Cooperative cancellation was observed.
Io
A transaction-owned filesystem operation failed.
The variant is typed: operation names the filesystem operation
that failed and source preserves the underlying std::io::Error.
A consumer can therefore match on std::io::ErrorKind and walk the
std::error::Error::source chain instead of parsing a flattened
string. operation is a stable label and never carries URL material;
the rendered detail is bounded exactly like every other variant.
Fields
The adapter could not attempt the request (missing executable, failed discovery, spawn failure). URL material is already redacted.
Composition falls back to the next transport on Unavailable. Ordinary
Transport/Timeout failures fall back only under an explicit
opt-in policy. All other errors and NotFound are terminal.
Implementations§
Source§impl AcquisitionError
impl AcquisitionError
Returns true when the adapter was unavailable to attempt the request.
Trait Implementations§
Source§impl Debug for AcquisitionError
impl Debug for AcquisitionError
Source§impl Display for AcquisitionError
impl Display for AcquisitionError
Source§impl Error for AcquisitionError
impl Error for AcquisitionError
Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
Returns the underlying I/O error for the Io variant.
Every other variant is a seam-level category with no underlying cause,
so it reports None.
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()