Struct Status 

pub struct Status(/* private fields */);

A response status code (RFC 9110 §15).

Three decimal digits and nothing more: :status carries the code alone (RFC 9114 §4.3.2), and the reason phrase that followed it in HTTP/1.1 has no HTTP/3 representation at all. The digits are what is stored, because they are what goes on the wire.

Only the codes this server sends have names. A code with no constant here is one no path reaches, and adding one is how a new answer gets named rather than spelled as a literal at the place it is sent from.

Implementations

impl Status

pub const OK: Self

200 OK: the tunnel is open (RFC 9114 §4.4).

pub const BAD_REQUEST: Self

400 Bad Request: the request is not one this proxy can act on.

pub const FORBIDDEN: Self

403 Forbidden: refused by this proxy’s own policy (decision D11).

pub const PROXY_AUTHENTICATION_REQUIRED: Self

407 Proxy Authentication Required (RFC 9110 §15.5.8).

pub const REQUEST_HEADER_FIELDS_TOO_LARGE: Self

431 Request Header Fields Too Large (RFC 6585 §5, RFC 9114 §4.2.2).

pub const INTERNAL_SERVER_ERROR: Self

500 Internal Server Error: a fault on this side of the tunnel.

pub const NOT_IMPLEMENTED: Self

501 Not Implemented: a method or :protocol this proxy does not serve.

pub const BAD_GATEWAY: Self

502 Bad Gateway: the target refused the connection or could not be looked up (RFC 9209 §2.3.2).

pub const SERVICE_UNAVAILABLE: Self

503 Service Unavailable: the target could not be reached at all, or this proxy is at a limit (RFC 9209 §2.3.2).

pub const GATEWAY_TIMEOUT: Self

504 Gateway Timeout: the target never answered (RFC 9209 §2.3.2).

pub fn parse(bytes: &[u8]) -> Option<Self>

Reads a :status value.

None for anything that is not three digits with a non-zero first one, which is the shape of every code RFC 9110 §15 defines.

A server reads no responses, so this exists for the suite’s client. It is here rather than there because a status is a status at both ends of the wire.

pub fn as_str(&self) -> &str

The three digits, as :status carries them.

Panics

Never in practice: every constant here is an ASCII literal and Self::parse accepts nothing else, so the digits cannot be anything a str will not hold. The check is kept rather than made unchecked because it costs three comparisons on a path that writes a response.

Trait Implementations

impl Clone for Status

fn clone(&self) -> Status

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Status

impl Debug for Status

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Status

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Status

impl Hash for Status

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Status

fn eq(&self, other: &Status) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Status