#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

#61 in #http-header

Download history 6/week @ 2023-12-20 9/week @ 2023-12-27 26/week @ 2024-01-03 23/week @ 2024-01-10 9/week @ 2024-01-17 34/week @ 2024-01-24 28/week @ 2024-01-31 16/week @ 2024-02-07 41/week @ 2024-02-14 51/week @ 2024-02-21 33/week @ 2024-02-28 36/week @ 2024-03-06 49/week @ 2024-03-13 67/week @ 2024-03-20 34/week @ 2024-03-27

192 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
~53K SLoC