5 releases
0.4.2 | Sep 17, 2024 |
---|---|
0.4.1 | Sep 5, 2024 |
0.4.0 | Aug 21, 2024 |
0.3.2 | Aug 14, 2024 |
0.3.1 | Aug 14, 2024 |
#54 in Compression
256 downloads per month
Used in 4 crates
(2 directly)
135KB
2.5K
SLoC
loona-hpack
Logo by MisiasArt
An HPACK coder implementation in Rust.
Forked from https://github.com/mlalic/hpack-rs in January of 2023, to add functionality and let loona pass h2spec.
Overview
The library lets you perform header compression and decompression according to the HPACK spec.
The decoder module implements the API for performing HPACK decoding.
The Decoder
struct will track the decoding context during its lifetime (i.e.
subsequent headers on the same connection should be decoded using the same instance).
The decoder implements the full spec and allows for decoding any valid sequence of bytes representing a compressed header list.
The encoder module implements the API for performing HPACK encoding.
The Encoder
struct will track the encoding context during its lifetime (i.e. the
same instance should be used to encode all headers on the same connection).
The encoder so far does not implement Huffman string literal encoding; this, however, is enough to be able to send requests to any HPACK-compliant server, as Huffman encoding is completely optional.
Examples
Encoding
Encode some pseudo-headers that are fully indexed by the static header table.
use loona_hpack::Encoder;
let mut encoder = Encoder::new();
let headers = vec![
(b":method".to_vec(), b"GET".to_vec()),
(b":path".to_vec(), b"/".to_vec()),
];
// The headers are encoded by providing their index (with a bit flag
// indicating that the indexed representation is used).
assert_eq!(
encoder.encode(headers.iter().map(|h| (&h.0[..], &h.1[..]))),
vec![2 | 0x80, 4 | 0x80]
);
Decoding
Decode the headers from a raw byte sequence. In this case both of them are indexed by the static table.
use loona_hpack::Decoder;
let mut decoder = Decoder::new();
let header_list = decoder.decode(&[0x82, 0x84]).unwrap();
assert_eq!(header_list, [
(b":method".to_vec(), b"GET".to_vec()),
(b":path".to_vec(), b"/".to_vec()),
]);
Interoperability
The decoder is tested for interoperability with HPACK encoders that have published their results to the http2jp/hpack-test-case repo.
License
The project is published under the terms of the MIT License.
Dependencies
~0.6–1.1MB
~22K SLoC