eggfetch-cli 0.2.2

Command-line HTTP client powered by the eggfetch-core engine
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

//! Private CLI error classification and exit-code policy.

/// Exit codes.
pub(crate) const EXIT_SUCCESS: u8 = 0;
pub(crate) const EXIT_USAGE: u8 = 2;
pub(crate) const EXIT_CONNECT: u8 = 3;
pub(crate) const EXIT_TIMEOUT: u8 = 4;
pub(crate) const EXIT_PROTOCOL: u8 = 5;
pub(crate) const EXIT_STATUS: u8 = 6;
pub(crate) const EXIT_IO: u8 = 7;

#[derive(Debug)]
pub(crate) struct StatusError(pub(crate) u16);

impl std::fmt::Display for StatusError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "HTTP status {}", self.0)
    }
}

impl std::error::Error for StatusError {}

pub(crate) fn map_error_to_exit_code(err: &eggfetch_core::Error) -> u8 {
    use eggfetch_core::Error;
    match err {
        // Usage / configuration errors
        Error::InvalidUrl(_)
        | Error::InvalidMethod(_)
        | Error::InvalidHeaderName(_)
        | Error::InvalidHeaderValue(_)
        | Error::RequestBuild(_)
        | Error::InvalidResolvedTarget(_)
        | Error::ConflictingAuth(_)
        | Error::InvalidProxyUrl(_)
        | Error::TlsConfig(_)
        | Error::CaBundle(_)
        | Error::ClientCert(_)
        | Error::PrivateKey(_)
        | Error::CertificateVerification(_)
        | Error::HostnameVerification(_) => EXIT_USAGE,

        // Timeout errors
        Error::Timeout { .. } | Error::TransportIoTimeout { .. } => EXIT_TIMEOUT,

        // Protocol / decompression errors
        Error::Protocol(_)
        | Error::Decompression(_)
        | Error::UnsupportedContentEncoding(_)
        | Error::DecodedBodyTooLarge
        | Error::DecompressionRatioExceeded
        | Error::Body(_)
        | Error::Unsupported(_)
        | Error::InvalidRedirectLocation(_)
        | Error::InvalidAuthHeader(_)
        | Error::BodyNotReplayableForRedirect
        | Error::TooManyRedirects { .. }
        | Error::BodyNotReplayableForRetry
        | Error::RetryBudgetExhausted { .. }
        | Error::RetryNotConfigured
        | Error::ResolvedTargetRedirect
        | Error::JsonSerialize(_)
        | Error::JsonDeserialize(_)
        | Error::Http2GoAway { .. }
        | Error::Http2StreamReset { .. }
        | Error::Http2FlowControl(_)
        | Error::Http2Protocol(_)
        | Error::H3Connect(_)
        | Error::H3ConnectionClosed(_)
        | Error::H3Stream(_)
        | Error::H3Protocol(_)
        | Error::TraceCallbackAborted => EXIT_PROTOCOL,

        // Connect / TLS / proxy errors
        Error::Connect(_)
        | Error::CustomTransport(_)
        | Error::Tls(_)
        | Error::Pool(_)
        | Error::ProxyConnect(_)
        | Error::ProxyAuthRequired
        | Error::ProxyConnectRejected { .. }
        | Error::MalformedProxyResponse(_) => EXIT_CONNECT,

        // I/O errors
        Error::Hyper(_) | Error::HyperClient(_) | Error::Io(_) => EXIT_IO,
    }
}

/// Exit code for errors that are neither [`eggfetch_core::Error`] nor
/// [`std::io::Error`] (e.g. [`StatusError`], `anyhow` usage errors, file
/// output failures wrapped with context).
///
/// Uses typed downcasts only — never message-substring heuristics — so an
/// unrelated error mentioning "status" or "parse" cannot mis-map. (The
/// SIGINT fallback in `main` uses the same typed chain scan for
/// `ErrorKind::Interrupted`.)
pub(crate) fn map_unknown_error_to_exit_code(err: &anyhow::Error) -> u8 {
    if err.downcast_ref::<StatusError>().is_some() {
        return EXIT_STATUS;
    }
    if err
        .chain()
        .any(|cause| cause.downcast_ref::<std::io::Error>().is_some())
    {
        return EXIT_IO;
    }
    EXIT_USAGE
}