http_wire 0.7.0

Serialize HTTP requests and responses to wire format bytes
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

//! Error handling for HTTP wire operations.
//!
//! This module defines the [`WireError`] type, which encompasses all possible errors
//! that can occur during encoding or decoding.

/// Errors that can occur during HTTP wire format encoding or decoding.
#[derive(Debug, thiserror::Error)]
pub enum WireError {
    /// Body collection error during the encoding process.
    ///
    /// This occurs when the body future returns an error while being
    /// collected synchronously prior to serialization.
    #[error("body collection error: {0}")]
    Collection(#[source] Box<dyn std::error::Error + Send + Sync>),

    /// Unsupported HTTP version.
    ///
    /// Only HTTP/1.0 and HTTP/1.1 are supported. HTTP/2 and HTTP/3 use
    /// binary framing and compression which make wire format serialization
    /// impractical for single messages.
    #[error("unsupported HTTP version: only HTTP/1.0 and HTTP/1.1 are supported")]
    UnsupportedVersion,

    /// Error from the httparse library during header parsing.
    ///
    /// This wraps errors from the `httparse` crate when parsing HTTP headers fails.
    /// Common causes include malformed header lines, invalid characters, or
    /// header values that violate HTTP specifications.
    #[error("{0}")]
    HttparseError(#[from] httparse::Error),

    /// HTTP headers are incomplete.
    ///
    /// This error indicates that the received data does not contain a complete
    /// HTTP header section (missing the `\r\n\r\n` terminator).
    /// More data needs to be received before the message can be parsed.
    #[error("partial head")]
    PartialHead,

    /// HTTP body is incomplete.
    ///
    /// This error occurs when the `Content-Length` header indicates a body
    /// size larger than what was actually received. The argument specifies
    /// how many bytes are still missing.
    ///
    /// For chunked encoding, this error is not used; instead,
    /// [`WireError::InvalidChunkedBody`] is returned.
    #[error("partial body: {0} bytes missing")]
    IncompleteBody(usize),

    /// Invalid chunked transfer encoding.
    ///
    /// This error occurs when parsing a chunked body fails due to malformed
    /// chunk formatting, invalid chunk sizes, missing chunk terminators,
    /// or incomplete chunked data.
    #[error("invalid chunked body")]
    InvalidChunkedBody,
}