async_compression/
lib.rs

1//! Adaptors between compression crates and Rust's modern asynchronous IO types.
2//!
3
4//! # Feature Organization
5//!
6//! This crate is divided up along two axes, which can each be individually selected via Cargo
7//! features.
8//!
9//! All features are disabled by default, you should enable just the ones you need from the lists
10//! below.
11//!
12//! If you want to pull in everything there are three group features defined:
13//!
14
15//!  Feature | Does
16//! ---------|------
17//!  `all`   | Activates all implementations and algorithms.
18//!  `all-implementations` | Activates all implementations, needs to be paired with a selection of algorithms
19//!  `all-algorithms` | Activates all algorithms, needs to be paired with a selection of implementations
20//!
21
22//! ## IO implementation
23//!
24//! The first division is which underlying asynchronous IO trait will be wrapped, these are
25//! available as separate features that have corresponding top-level modules:
26//!
27
28//!  Feature | Type
29//! ---------|------
30// TODO: Kill rustfmt on this section, `#![rustfmt::skip::attributes(cfg_attr)]` should do it, but
31// that's unstable
32#![allow(unexpected_cfgs)]
33#![cfg_attr(
34    feature = "futures-io",
35    doc = "[`futures-io`](futures_io) | [`futures::io::AsyncBufRead`](futures_io::AsyncBufRead), [`futures::io::AsyncWrite`](futures_io::AsyncWrite)"
36)]
37#![cfg_attr(
38    not(feature = "futures-io"),
39    doc = "`futures-io` (*inactive*) | `futures::io::AsyncBufRead`, `futures::io::AsyncWrite`"
40)]
41#![cfg_attr(
42    feature = "tokio",
43    doc = "[`tokio`] | [`tokio::io::AsyncBufRead`](::tokio::io::AsyncBufRead), [`tokio::io::AsyncWrite`](::tokio::io::AsyncWrite)"
44)]
45#![cfg_attr(
46    not(feature = "tokio"),
47    doc = "`tokio` (*inactive*) | `tokio::io::AsyncBufRead`, `tokio::io::AsyncWrite`"
48)]
49//!
50
51//! ## Compression algorithm
52//!
53//! The second division is which compression schemes to support, there are currently a few
54//! available choices, these determine which types will be available inside the above modules:
55//!
56
57//!  Feature | Types
58//! ---------|------
59#![cfg_attr(
60    feature = "brotli",
61    doc = "`brotli` | [`BrotliEncoder`](?search=BrotliEncoder), [`BrotliDecoder`](?search=BrotliDecoder)"
62)]
63#![cfg_attr(
64    not(feature = "brotli"),
65    doc = "`brotli` (*inactive*) | `BrotliEncoder`, `BrotliDecoder`"
66)]
67#![cfg_attr(
68    feature = "bzip2",
69    doc = "`bzip2` | [`BzEncoder`](?search=BzEncoder), [`BzDecoder`](?search=BzDecoder)"
70)]
71#![cfg_attr(
72    not(feature = "bzip2"),
73    doc = "`bzip2` (*inactive*) | `BzEncoder`, `BzDecoder`"
74)]
75#![cfg_attr(
76    feature = "deflate",
77    doc = "`deflate` | [`DeflateEncoder`](?search=DeflateEncoder), [`DeflateDecoder`](?search=DeflateDecoder)"
78)]
79#![cfg_attr(
80    not(feature = "deflate"),
81    doc = "`deflate` (*inactive*) | `DeflateEncoder`, `DeflateDecoder`"
82)]
83#![cfg_attr(
84    feature = "gzip",
85    doc = "`gzip` | [`GzipEncoder`](?search=GzipEncoder), [`GzipDecoder`](?search=GzipDecoder)"
86)]
87#![cfg_attr(
88    not(feature = "gzip"),
89    doc = "`gzip` (*inactive*) | `GzipEncoder`, `GzipDecoder`"
90)]
91#![cfg_attr(
92    feature = "lz4",
93    doc = "`lz4` | [`Lz4Encoder`](?search=Lz4Encoder), [`Lz4Decoder`](?search=Lz4Decoder)"
94)]
95#![cfg_attr(
96    not(feature = "lz4"),
97    doc = "`lz4` (*inactive*) | `Lz4Encoder`, `Lz4Decoder`"
98)]
99#![cfg_attr(
100    feature = "lzma",
101    doc = "`lzma` | [`LzmaEncoder`](?search=LzmaEncoder), [`LzmaDecoder`](?search=LzmaDecoder)"
102)]
103#![cfg_attr(
104    not(feature = "lzma"),
105    doc = "`lzma` (*inactive*) | `LzmaEncoder`, `LzmaDecoder`"
106)]
107#![cfg_attr(
108    feature = "xz",
109    doc = "`xz` | [`XzEncoder`](?search=XzEncoder), [`XzDecoder`](?search=XzDecoder)"
110)]
111#![cfg_attr(
112    not(feature = "xz"),
113    doc = "`xz` (*inactive*) | `XzEncoder`, `XzDecoder`"
114)]
115#![cfg_attr(
116    feature = "zlib",
117    doc = "`zlib` | [`ZlibEncoder`](?search=ZlibEncoder), [`ZlibDecoder`](?search=ZlibDecoder)"
118)]
119#![cfg_attr(
120    not(feature = "zlib"),
121    doc = "`zlib` (*inactive*) | `ZlibEncoder`, `ZlibDecoder`"
122)]
123#![cfg_attr(
124    feature = "zstd",
125    doc = "`zstd` | [`ZstdEncoder`](?search=ZstdEncoder), [`ZstdDecoder`](?search=ZstdDecoder)"
126)]
127#![cfg_attr(
128    not(feature = "zstd"),
129    doc = "`zstd` (*inactive*) | `ZstdEncoder`, `ZstdDecoder`"
130)]
131#![cfg_attr(
132    feature = "deflate64",
133    doc = "`deflate64` | (encoder not implemented), [`Deflate64Decoder`](?search=Deflate64Decoder)"
134)]
135#![cfg_attr(
136    not(feature = "deflate64"),
137    doc = "`deflate64` (*inactive*) | (encoder not implemented), `Deflate64Decoder`"
138)]
139//!
140
141//! ## Multi-thread support
142//! The `xz` compression algorithm supports multi-threaded compression and decompression.
143//! Enable the `xz-parallel` feature to enable multi-threading support.
144//!
145
146#![cfg_attr(docsrs, feature(doc_auto_cfg, doc_cfg))]
147#![warn(
148    missing_docs,
149    rust_2018_idioms,
150    missing_copy_implementations,
151    missing_debug_implementations
152)]
153#![cfg_attr(not(all), allow(unused))]
154
155#[macro_use]
156mod macros;
157
158#[cfg(feature = "futures-io")]
159pub mod futures;
160#[cfg(feature = "tokio")]
161pub mod tokio;
162
163pub use compression_codecs as codecs;
164pub use compression_core as core;
165
166pub use core::Level;
167
168#[cfg(feature = "zstd")]
169pub use codecs::zstd::params as zstd;
170
171#[cfg(feature = "lz4")]
172pub use codecs::lz4::params as lz4;
173
174#[cfg(feature = "brotli")]
175pub use codecs::brotli::params as brotli;
async_compression/lib.rs

async_compression/
lib.rs
