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

headers-accept

🤝 The missing Accept implementation for headers::Header

4 releases

0.1.3 May 6, 2024
0.1.2 May 1, 2024
0.1.1 Apr 29, 2024
0.1.0 Apr 25, 2024

#1449 in Network programming

Download history 240/week @ 2024-04-23 278/week @ 2024-04-30 54/week @ 2024-05-07 1/week @ 2024-05-14 13/week @ 2024-05-21 9/week @ 2024-05-28

158 downloads per month

MIT license

28KB
332 lines

headers-accept

🤝 The missing `Accept` implementation for `headers::Header`

🎨 Overview

This crate provides an implementation of headers::Header for Accept.

While other crates exist, they either rely on stagnant crates like mime (headers-accept uses mediatype instead) or deviate from RFC 9110 (by imposing onerous sort logic) or both.

This crate aims to solve these problems while adhereing to the spec outlined in section 12.5.1.

📦 Install

To use the crate in your project, add the following to your Cargo.toml file:

[dependencies]
headers-accept = "0.1.3"

🤸 Usage

Example

use std::str::FromStr;

use headers_accept::Accept;
use mediatype::MediaTypeBuf;

let accept = Accept::from_str("audio/*; q=0.2, audio/basic").unwrap();
let mut media_types = accept.media_types();
assert_eq!(
    media_types.next(),
    Some(&MediaTypeBuf::from_str("audio/basic").unwrap())
);
assert_eq!(
    media_types.next(),
    Some(&MediaTypeBuf::from_str("audio/*; q=0.2").unwrap())
);
assert_eq!(media_types.next(), None);

🦺 Safety

This crate uses #![forbid(unsafe_code)] to ensure everything is implemented in 100% safe Rust.

👯 Contributing

We appreciate all kinds of contributions, thank you!

Dependencies

~1MB
~12K SLoC