Crate deflate[−][src]
Expand description
An implementation an encoder using DEFLATE compression algorithm in pure Rust.
This library provides functions to compress data using the DEFLATE algorithm, optionally wrapped using the zlib or gzip formats. The current implementation is still a bit lacking speed-wise compared to C-libraries like zlib and miniz.
The deflate algorithm is an older compression algorithm that is still widely used today,
by e.g html headers, the .png
image format, the Unix gzip
program and commonly in .zip
files. The zlib
and gzip
formats are wrappers around DEFLATE-compressed data, containing
some extra metadata and a checksum to validate the integrity of the raw data.
The deflate algorithm does not perform as well as newer algorithms used in file formats such as
.7z
, .rar
, .xz
and .bz2
, and is thus not the ideal choice for applications where
the DEFLATE
format (with or without wrappers) is not required.
Support for the gzip wrapper (the wrapper that is used in .gz
files) is disabled by default
but can be enabled with the gzip
feature.
As this library is still in development, the compression output may change slightly between versions.
Examples:
Simple compression function:
use deflate::deflate_bytes;
let data = b"Some data";
let compressed = deflate_bytes(data);
Using a writer:
use std::io::Write;
use deflate::Compression;
use deflate::write::ZlibEncoder;
let data = b"This is some test data";
let mut encoder = ZlibEncoder::new(Vec::new(), Compression::Default);
encoder.write_all(data).expect("Write error!");
let compressed_data = encoder.finish().expect("Failed to finish compression!");
Modules
Encoders implementing a Write
interface.
Structs
A struct describing the options for a compressor or compression function.
Enums
An enum describing the level of compression to be used by the encoder
An enum describing whether we use lazy or greedy matching.
Enum allowing some special options (not implemented yet)!
Functions
Compress the given slice of bytes with DEFLATE compression using the default compression level.
Compress the given slice of bytes with DEFLATE compression.
Compress the given slice of bytes with DEFLATE compression, including a gzip header and trailer, using the default compression level, and a gzip header with default values.
Compress the given slice of bytes with DEFLATE compression, including a gzip header and trailer using the given gzip header and compression options.
Compress the given slice of bytes with DEFLATE compression, including a zlib header and trailer, using the default compression level.
Compress the given slice of bytes with DEFLATE compression, including a zlib header and trailer.