Gzip wrapper
Gzip<C> compresses the payload of an inner codec C as gzip
(RFC 1952) through flate2. Enable
the gzip Cargo feature to use it:
[dependencies]
beavers = { version = "0.1", features = ["gzip"] }
Encoding runs the inner codec and writes its output as one gzip member. Decoding decompresses every concatenated member and passes the result to the inner codec, so payloads from other gzip writers decode as well.
| Setting | Default | Range |
|---|---|---|
with_level |
6 | 0 (store only) to 9 (smallest output) |
with_max_decoded_len |
64 MiB | Any byte count |
use beavers::{Decoder, Encoder, Gzip, Json};
let codec = Gzip::new(Json::new()).with_level(9);
let bytes = codec.encode(&vec!["beaver"; 100])?;
let value: Vec<String> = codec.decode(&bytes)?;
assert_eq!(value.len(), 100);
# Ok::<(), beavers::BoxError>(())
with_level panics on a level above 9, because the value is fixed when the
codec is constructed. Decoding fails when the decompressed payload would exceed
with_max_decoded_len, and malformed compressed data is also a decode failure.
See codec wrappers for when to compress
in the codec rather than in the broker client.