ruzstd/
lib.rs

1//! A pure Rust implementation of the [Zstandard compression format](https://www.rfc-editor.org/rfc/rfc8878.pdf).
2//!
3//! ## Decompression
4//! The [decoding] module contains the code for decompression.
5//! Decompression can be achieved by using the [`decoding::StreamingDecoder`]
6//! or the more low-level [`decoding::FrameDecoder`]
7//!
8//! ## Compression
9//! The [encoding] module contains the code for compression.
10//! Decompression can be achieved by using the [`encoding::compress`]/[`encoding::compress_to_vec`]
11//! functions or the [`encoding::FrameCompressor`]
12//!
13#![doc = include_str!("../Readme.md")]
14#![no_std]
15#![deny(trivial_casts, trivial_numeric_casts, rust_2018_idioms)]
16
17#[cfg(feature = "std")]
18extern crate std;
19
20#[cfg(not(feature = "rustc-dep-of-std"))]
21extern crate alloc;
22
23#[cfg(feature = "std")]
24pub(crate) const VERBOSE: bool = false;
25
26macro_rules! vprintln {
27    ($($x:expr),*) => {
28        #[cfg(feature = "std")]
29        if crate::VERBOSE {
30            std::println!($($x),*);
31        }
32    }
33}
34
35mod bit_io;
36mod common;
37pub mod decoding;
38pub mod encoding;
39
40pub(crate) mod blocks;
41
42#[cfg(feature = "fuzz_exports")]
43pub mod fse;
44#[cfg(feature = "fuzz_exports")]
45pub mod huff0;
46
47#[cfg(not(feature = "fuzz_exports"))]
48pub(crate) mod fse;
49#[cfg(not(feature = "fuzz_exports"))]
50pub(crate) mod huff0;
51
52mod tests;
53
54#[cfg(feature = "std")]
55pub mod io_std;
56
57#[cfg(feature = "std")]
58pub use io_std as io;
59
60#[cfg(not(feature = "std"))]
61pub mod io_nostd;
62
63#[cfg(not(feature = "std"))]
64pub use io_nostd as io;