toac 0.1.0

Tower-compatible OpenAPI client runtime. Types and traits that generated code from `toac-build` links against.
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

/// Erased error used across the runtime surface.
///
/// The `Send + Sync` bounds match the convention of `tower::BoxError`
/// and `hyper::Error`, so transport layers can forward their native
/// errors into [`crate::body::Body`] and [`crate::DecodeError::Codec`]
/// without extra boxing.
pub type BoxError = Box<dyn std::error::Error + Send + Sync>;

/// Concrete `std::error::Error` wrapper around a [`BoxError`].
///
/// Generated [`MakeRequest`][crate::MakeRequest] impls need an `Error`
/// type when they combine multiple failure surfaces (e.g. parameter
/// encoding and body codec), and `BoxError` itself is not an `Error`
/// because `dyn Error` is unsized. This newtype gives codegen a single
/// `Error + Send + Sync + 'static` value that any `Into<BoxError>` source
/// can be folded into.
#[derive(Debug, thiserror::Error)]
#[error(transparent)]
pub struct EncodeRequestError(#[from] BoxError);

impl EncodeRequestError {
    /// Wraps any `Into<BoxError>` source. Equivalent to `From::from`,
    /// kept as an explicit name for codegen readability.
    pub fn new<E: Into<BoxError>>(error: E) -> Self {
        Self(error.into())
    }

    /// Returns the inner [`BoxError`]. Useful when the caller wants to
    /// downcast to a concrete codec error for diagnostics.
    pub fn into_inner(self) -> BoxError {
        self.0
    }
}