spz 0.0.6

SPZ file format handling for Rust, and CLI tooling.
Documentation 
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

// SPDX-License-Identifier: Apache-2.0 OR MIT

use std::io::{BufRead, BufReader, Read};

use anyhow::Context;
use anyhow::Result;
use flate2::{
	Compression,
	bufread::{GzDecoder, GzEncoder},
};

/// Compress data using gzip compression.
#[inline]
pub fn to_gzip_bytes(decompressed: &[u8], compressed: &mut Vec<u8>) -> Result<()> {
	compressed.clear();
	compressed.reserve(decompressed.len() / 4);

	let reader = BufReader::new(decompressed);

	to_gzip(reader, compressed)
}

/// Compress data using gzip compression.
#[inline]
pub fn to_gzip<B>(decompressed: B, compressed: &mut Vec<u8>) -> Result<()>
where
	B: BufRead,
{
	let mut encoder = GzEncoder::new(decompressed, Compression::default());

	encoder.read_to_end(compressed)
		.with_context(|| "unable to decompress")?;

	Ok(())
}

/// Decompress gzip-compressed data into the given buffer.
#[inline]
pub fn gzip_to_bytes<C, D>(compressed: C, mut decompressed: D) -> Result<()>
where
	C: AsRef<[u8]>,
	D: AsMut<Vec<u8>>,
{
	let mut gz_decoder = GzDecoder::new(compressed.as_ref());

	gz_decoder
		.read_to_end(decompressed.as_mut())
		.with_context(|| "unable to decompress")?;

	Ok(())
}