Struct Header 

pub struct Header { /* private fields */ }

A single HTTP header field.

Header name matching in this crate is ASCII case-insensitive.

Implementations

impl Header

pub fn new( name: impl Into<String>, value: impl Into<String>, ) -> Result<Self, NanoGetError>

Creates a new header, validating the header name and value.

Examples found in repository

examples/custom-auth-handler/main.rs (lines 25-28)

    fn respond(
        &self,
        _target: AuthTarget,
        _url: &Url,
        challenges: &[Challenge],
        _request: &Request,
        _response: &Response,
    ) -> Result<AuthDecision, nano_get::NanoGetError> {
        let supports_token = challenges
            .iter()
            .any(|challenge| challenge.scheme.eq_ignore_ascii_case("token"));

        if supports_token {
            return Ok(AuthDecision::UseHeaders(vec![Header::new(
                "Authorization",
                "Token example-secret",
            )?]));
        }

        Ok(AuthDecision::NoMatch)
    }

pub fn name(&self) -> &str

Returns the header field-name as provided.

pub fn value(&self) -> &str

Returns the header field-value as provided.

Examples found in repository

examples/head-request/main.rs (line 17)

fn main() -> Result<(), Box<dyn Error>> {
    let url = "http://example.com";
    let response = nano_get::head(url)?;

    println!("HEAD {url}");
    println!(
        "status: {} {}",
        response.status_code, response.reason_phrase
    );
    println!("content-type: {:?}", response.header("content-type"));
    println!("content-length: {:?}", response.header("content-length"));

    let server_headers = response
        .headers_named("server")
        .map(|header| header.value().to_string())
        .collect::<Vec<_>>();
    println!("server headers: {server_headers:?}");
    println!("body length after HEAD: {}", response.body.len());

    Ok(())
}

pub fn matches_name(&self, needle: &str) -> bool

Returns true when needle matches this header name (case-insensitive).

Trait Implementations

impl Clone for Header

fn clone(&self) -> Header

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Header

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

Formats the value using the given formatter.

impl PartialEq for Header

fn eq(&self, other: &Header) -> 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 Eq for Header

impl StructuralPartialEq for Header