native-svc 0.1.2

An HTTP adapter that implements the embedded-svc interface using hyper as the backend
Documentation 
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

//! Error types for the Hyper HTTP connection implementation.
//!
//! Defines a unified `HyperError` enum wrapping IO, HTTP, and `hyper` library errors,
//! as well as connector-specific conditions like missing requests/responses and unsupported methods.

use embedded_svc::io::{Error as SvcError, ErrorKind as SvcErrorKind};
use hyper::http;
use std::io;
use hyper::header::{InvalidHeaderName, InvalidHeaderValue};
use thiserror::Error;

/// A comprehensive error type for the Hyper-based HTTP client.
///
/// Wraps errors from various layers:
///
/// - `io::Error` for general I/O failures.
/// - `http::Error` for request building mistakes.
/// - `hyper::Error` for runtime or protocol-level failures.
/// - `hyper_util::client::legacy::Error` for client connector issues.
///
/// Also includes variants for unsupported HTTP methods, missing requests or responses,
/// and invalid header names or values.
#[derive(Error, Debug)]
pub enum HyperError {
    /// Underlying I/O error.
    #[error("io error: {0:?}")]
    Io(#[from] io::Error),

    /// Error constructing or parsing an HTTP message.
    #[error("http error: {0:?}")]
    Http(#[from] http::Error),

    /// Error returned by the Hyper library during request/response processing.
    #[error("hyper error: {0:?}")]
    Hyper(#[from] hyper::Error),

    /// Error originating from the Hyper legacy client connector.
    #[error("client error: {0:?}")]
    Client(#[from] hyper_util::client::legacy::Error),

    /// Failed to initialize the Tokio runtime.
    #[error("tokio runtime initialization error: {0:?}")]
    RuntimeCreation(io::Error),

    /// The connector did not support an HTTP method.
    #[error("unsupported http method: {0}")]
    UnsupportedMethod(String),

    /// No HTTP response has been received when expected.
    #[error("no response initialized")]
    NoResponse,

    /// No HTTP request has been initiated when expected.
    #[error("no request initialized")]
    NoRequest,

    /// A header name provided was invalid, according to HTTP specifications.
    #[error("invalid header name: {0:?}")]
    InvalidHeaderName(#[from] InvalidHeaderName),

    /// A header value provided was invalid according to HTTP value rules.
    #[error("invalid header value: {0:?}")]
    InvalidHeaderValue(#[from] InvalidHeaderValue),
}

impl SvcError for HyperError {
    /// Maps all `HyperError` variants to `ErrorKind::Other` for embedded-svc.
    fn kind(&self) -> SvcErrorKind {
        SvcErrorKind::Other
    }
}