You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
46 lines
1.5 KiB
46 lines
1.5 KiB
//! A library for reading and writing TAR archives in an async fashion.
|
|
//!
|
|
//! This library provides utilities necessary to manage [TAR archives][1]
|
|
//! abstracted over a reader or writer. Great strides are taken to ensure that
|
|
//! an archive is never required to be fully resident in memory, and all objects
|
|
//! provide largely a streaming interface to read bytes from.
|
|
//!
|
|
//! [1]: http://en.wikipedia.org/wiki/Tar_%28computing%29
|
|
|
|
// More docs about the detailed tar format can also be found here:
|
|
// http://www.freebsd.org/cgi/man.cgi?query=tar&sektion=5&manpath=FreeBSD+8-current
|
|
|
|
// NB: some of the coding patterns and idioms here may seem a little strange.
|
|
// This is currently attempting to expose a super generic interface while
|
|
// also not forcing clients to codegen the entire crate each time they use
|
|
// it. To that end lots of work is done to ensure that concrete
|
|
// implementations are all found in this crate and the generic functions are
|
|
// all just super thin wrappers (e.g. easy to codegen).
|
|
|
|
#![deny(missing_docs)]
|
|
|
|
use std::io::{Error, ErrorKind};
|
|
|
|
pub use crate::{
|
|
archive::{Archive, ArchiveBuilder, Entries},
|
|
builder::Builder,
|
|
entry::{Entry, Unpacked},
|
|
entry_type::EntryType,
|
|
header::{
|
|
GnuExtSparseHeader, GnuHeader, GnuSparseHeader, Header, HeaderMode, OldHeader, UstarHeader,
|
|
},
|
|
pax::{PaxExtension, PaxExtensions},
|
|
};
|
|
|
|
mod archive;
|
|
mod builder;
|
|
mod entry;
|
|
mod entry_type;
|
|
mod error;
|
|
mod header;
|
|
mod pax;
|
|
|
|
fn other(msg: &str) -> Error {
|
|
Error::new(ErrorKind::Other, msg)
|
|
}
|