#header #http-header #http #content-negotiation

accept-header

A simple library for parsing HTTP Accept headers for content negotiation

4 releases

0.2.3 Feb 14, 2023
0.2.2 Jan 11, 2023
0.2.1 Nov 27, 2022
0.1.2 Nov 14, 2022

#2289 in Web programming

Download history 24/week @ 2024-01-08 7/week @ 2024-01-15 15/week @ 2024-01-22 42/week @ 2024-01-29 22/week @ 2024-02-05 17/week @ 2024-02-12 61/week @ 2024-02-19 39/week @ 2024-02-26 32/week @ 2024-03-04 47/week @ 2024-03-11 54/week @ 2024-03-18 55/week @ 2024-03-25 51/week @ 2024-04-01 42/week @ 2024-04-08 59/week @ 2024-04-15 69/week @ 2024-04-22

225 downloads per month
Used in favicon-rover

MIT license

14KB
309 lines

HTTP accept header

A very basic & naive implementation of the HTTP Accept header. It uses http crate and mime crate to parse the accept header. Basic data structure:

#[derive(Debug, Clone, PartialEq)]
pub struct Accept {
    pub wildcard: Option<MediaType>,
    pub types: Vec<MediaType>,
}

#[derive(Debug, Clone, PartialEq)]
pub struct MediaType {
    pub mime: Mime,
    pub weight: Option<f32>,
}

Usage:

// parse accept header
let accept: Accept = "application/json, text/html;q=0.9, text/plain;q=0.8, */*;q=0.7"
    .parse()
    .unwrap();

// prepare a list of supported media types
let available = vec![
    Mime::from_str("text/html").unwrap(),
    Mime::from_str("application/json").unwrap(),
];

// content negotiation
let negotiated = accept.negotiate(&available).unwrap();

// "application/json" shall be chosen since it is available and has the highest weight
assert_eq!(negotiated, Mime::from_str("application/json").unwrap());

Dependencies

~2.5MB
~55K SLoC