Struct AcceptEncoding 

pub struct AcceptEncoding { /* private fields */ }

A parsed Accept-Encoding, enough to answer whether a coding was accepted.

Each slot holds the quality value (0..=1000) a coding was named with, if it was named outright; star holds the quality value of * if present.

Implementations

impl AcceptEncoding

pub fn parse(value: &str) -> Self

Examples found in repository

examples/codings.rs (line 16)

async fn main() {
	let accept = AcceptEncoding::parse(DEFAULT_ACCEPT_ENCODING);

	// What a response's headers negotiate against what the request asked for.
	let mut headers = HeaderMap::new();
	headers.insert("content-encoding", HeaderValue::from_static("gzip"));
	headers.insert("content-length", HeaderValue::from_static("42"));
	let coding = decision(&headers, &accept).expect("gzip is in the default Accept-Encoding");
	println!("negotiated: {coding:?}");

	// A decoded body's length and coding no longer describe what the caller receives.
	strip_decoded_headers(&mut headers);
	println!("headers after decoding: {:?}", headers.keys().count());

	// Round-trip a body through the coding that was negotiated.
	let original = b"the quick brown fox jumps over the lazy dog".repeat(8);
	let compressed = compress_buffer(&original, coding)
		.await
		.expect("gzip compresses");
	println!(
		"{} bytes in, {} bytes out",
		original.len(),
		compressed.len()
	);

	let stream = futures::stream::once(async move { Ok(Bytes::from(compressed)) });
	let mut decoded = decode_stream(Box::pin(stream), coding);
	let mut round_tripped = Vec::new();
	while let Some(chunk) = decoded.next().await {
		round_tripped.extend_from_slice(&chunk.expect("the body decodes"));
	}
	println!("round-tripped intact: {}", round_tripped == original);

	// A request that compresses on top of a coding the caller already applied names both, in order.
	println!(
		"Content-Encoding: {}",
		layer_content_encoding(Some("br"), Coding::Gzip)
	);
}

Trait Implementations

impl Clone for AcceptEncoding

fn clone(&self) -> AcceptEncoding

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AcceptEncoding

impl Debug for AcceptEncoding

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

Formats the value using the given formatter.

impl Default for AcceptEncoding

fn default() -> AcceptEncoding

Returns the “default value” for a type.