Struct HttpResponse 

pub struct HttpResponse {
    pub status: u16,
    pub headers: Vec<(String, String)>,
    pub body: String,
}

An HTTP response.

Fields

status: u16

The status code.

headers: Vec<(String, String)>

The response headers, in the order the venue sent them.

Carried because the body is not the whole answer: a venue that rate-limits says how long to wait in Retry-After, and a response without headers throws that away before anything can read it — which is why Error::RateLimited used to be raised with retry_after: None at every one of its construction sites.

body: String

The response body.

Implementations

impl HttpResponse

pub fn new(status: u16, body: impl Into<String>) -> HttpResponse

Build a response with no headers.

pub fn with_header( self, name: impl Into<String>, value: impl Into<String>, ) -> HttpResponse

Add a header.

pub fn header(&self, name: &str) -> Option<&str>

The first value of name, matched case-insensitively.

Header names are case-insensitive per RFC 9110, and venues are not consistent about it: the same field arrives as Retry-After from one and retry-after from another behind HTTP/2, which lower-cases them.

pub fn retry_after(&self) -> Option<Duration>

The venue’s advised wait from Retry-After, if it sent one.

Only the delta-seconds form is read. The HTTP-date form is legal but no venue in this repository’s error taxonomy uses it, and parsing dates would mean a date library and a clock in a function that must stay pure — an unread None is the better failure here than a wrong duration. Fractional seconds are accepted because some venues send them, though the RFC specifies an integer.

pub fn is_success(&self) -> bool

Whether the status is in the 2xx range.

Trait Implementations

impl Clone for HttpResponse

fn clone(&self) -> HttpResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpResponse

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

Formats the value using the given formatter.

impl Eq for HttpResponse

impl PartialEq for HttpResponse

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for HttpResponse