Struct HeaderEscapeGuard 

pub struct HeaderEscapeGuard;

Typed guard for HTTP response header values.

The struct is zero-sized; it exists for the namespace and for future extensions (e.g., per-boundary length policies). Callers invoke the guard exclusively through associated functions.

use crate::server::header_escape_guard::{HeaderEscapeGuard, EscapeError};

let value = HeaderEscapeGuard::header_value("max-age=3600")?;
// value is now an `http::HeaderValue` safe to attach to a
// response. Attempting to splice a second header line is
// rejected at the type boundary:
assert!(matches!(
    HeaderEscapeGuard::header_value("evil\r\nX-Forged: 1"),
    Err(EscapeError::ContainsCrlf),
));

Implementations

impl HeaderEscapeGuard

pub fn header_value(s: &str) -> Result<HeaderValue, EscapeError>

Validate s and wrap it in a typed http::HeaderValue.

Returns the typed error (EscapeError) on the first byte that violates the contract. The order of checks is: oversize → CRLF → NUL → TAB → other non-printable. Callers must not assume the order — only that some violation triggered the rejection.