async_tar_wasm/
lib.rs

1//! A library for reading and writing TAR archives in an async fashion.
2//!
3//! This library provides utilities necessary to manage [TAR archives][1]
4//! abstracted over a reader or writer. Great strides are taken to ensure that
5//! an archive is never required to be fully resident in memory, and all objects
6//! provide largely a streaming interface to read bytes from.
7//!
8//! [1]: http://en.wikipedia.org/wiki/Tar_%28computing%29
9
10// More docs about the detailed tar format can also be found here:
11// http://www.freebsd.org/cgi/man.cgi?query=tar&sektion=5&manpath=FreeBSD+8-current
12
13// NB: some of the coding patterns and idioms here may seem a little strange.
14//     This is currently attempting to expose a super generic interface while
15//     also not forcing clients to codegen the entire crate each time they use
16//     it. To that end lots of work is done to ensure that concrete
17//     implementations are all found in this crate and the generic functions are
18//     all just super thin wrappers (e.g. easy to codegen).
19
20#![deny(missing_docs)]
21#![deny(clippy::all)]
22
23use std::io::{Error, ErrorKind};
24
25pub use crate::{
26    archive::{Archive, ArchiveBuilder, Entries},
27    builder::Builder,
28    entry::Entry,
29    entry_type::EntryType,
30    header::{
31        GnuExtSparseHeader, GnuHeader, GnuSparseHeader, Header, HeaderMode, OldHeader, UstarHeader,
32    },
33    pax::{PaxExtension, PaxExtensions},
34};
35
36#[cfg(feature = "fs")]
37pub use crate::entry::Unpacked;
38
39mod archive;
40mod builder;
41mod entry;
42mod entry_type;
43mod error;
44mod header;
45mod pax;
46
47#[cfg(test)]
48#[macro_use]
49extern crate static_assertions;
50
51fn other(msg: &str) -> Error {
52    Error::new(ErrorKind::Other, msg)
53}
async_tar_wasm/lib.rs

async_tar_wasm/
lib.rs
