compcol 0.6.3

A no_std collection of compression algorithms behind a uniform streaming trait, gated per-algorithm by Cargo features.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

//! Integration coverage for the newly added codecs: the four standalone
//! `Algorithm` primitives reachable through the factory, and the QPACK
//! header-codec module API.

#![cfg(all(
    feature = "factory",
    feature = "huffman",
    feature = "rangecoder",
    feature = "mtf",
    feature = "bwt",
    feature = "qpack"
))]

use compcol::{Decoder, Encoder, Status};

/// Drive a boxed encoder, then a boxed decoder, over `data` and return the
/// decoded output.
fn round_trip_by_name(name: &str, data: &[u8]) -> Vec<u8> {
    let mut enc = compcol::factory::encoder_by_name(name).expect("encoder");
    let mut dec = compcol::factory::decoder_by_name(name).expect("decoder");

    let mut encoded = Vec::new();
    let mut buf = vec![0u8; 512];
    let mut pos = 0;
    while pos < data.len() {
        let (p, _) = enc.encode(&data[pos..], &mut buf).unwrap();
        encoded.extend_from_slice(&buf[..p.written]);
        pos += p.consumed;
        if p.consumed == 0 && p.written == 0 {
            break;
        }
    }
    loop {
        let (p, st) = enc.finish(&mut buf).unwrap();
        encoded.extend_from_slice(&buf[..p.written]);
        if matches!(st, Status::StreamEnd) {
            break;
        }
    }

    let mut decoded = Vec::new();
    let mut pos = 0;
    while pos < encoded.len() {
        let (p, _) = dec.decode(&encoded[pos..], &mut buf).unwrap();
        decoded.extend_from_slice(&buf[..p.written]);
        pos += p.consumed;
        if p.consumed == 0 && p.written == 0 {
            break;
        }
    }
    loop {
        let (p, st) = dec.finish(&mut buf).unwrap();
        decoded.extend_from_slice(&buf[..p.written]);
        if matches!(st, Status::StreamEnd) {
            break;
        }
    }
    decoded
}

#[test]
fn factory_round_trips_new_primitives() {
    let corpus: [&[u8]; 4] = [
        b"",
        b"the quick brown fox jumps over the lazy dog",
        &[0u8; 4096],
        b"mississippi banana bandana ananas",
    ];
    for name in ["huffman", "range", "mtf", "bwt"] {
        for data in corpus {
            assert_eq!(
                round_trip_by_name(name, data),
                data,
                "round-trip mismatch for codec {name} on {} bytes",
                data.len()
            );
        }
    }
}

#[test]
fn new_codecs_registered_in_names() {
    let names = compcol::factory::names();
    for n in ["huffman", "range", "mtf", "bwt"] {
        assert!(names.contains(&n), "{n} not registered in factory::names()");
        assert!(
            compcol::factory::extension(n).is_some(),
            "{n} has no extension"
        );
    }
}

#[test]
fn qpack_module_round_trips() {
    use compcol::hpack::HeaderField;
    use compcol::qpack::{QpackDecoder, QpackEncoder};

    let mut enc = QpackEncoder::new();
    let mut dec = QpackDecoder::new();
    let fields = [
        HeaderField::new(b":method", b"GET"),
        HeaderField::new(b":path", b"/"),
        HeaderField::new(b"user-agent", b"compcol-test/1.0"),
    ];
    let block = enc.encode_field_section(&fields);
    let out = dec.decode_field_section(&block).unwrap();
    assert_eq!(out, fields);
}