tar 0.1.6

A Rust implementation of a TAR file reader and writer. This library does not currently handle compression, but it is abstract over all I/O readers and writers. Additionally, great lengths are taken to ensure that the entire contents are never required to be entirely resident in memory all at once.
docs.rs failed to build tar-0.1.6
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.
Visit the last successful build: tar-0.4.40

tar-rs

Build Status

Documentation

A tar archive reading/writing library for Rust.

# Cargo.toml
[dependencies.tar]
git = "https://github.com/alexcrichton/tar-rs"

Reading an archive

# #![allow(unused_must_use)]
extern crate tar;

use tar::Archive;
use std::io::{File, SeekSet};

fn main() {
    let file = File::open(&Path::new("foo.tar")).unwrap();
    let a = Archive::new(file);

    for file in a.files().unwrap() {
        // Make sure there wasn't an I/O error
        let mut file = file.unwrap();

        // Inspect metadata about the file
        println!("{}", file.filename());
        println!("{}", file.size());

        // files implement the Reader trait
        println!("{}", file.read_to_string());

        // files also implement the Seek trait
        file.seek(0, SeekSet);
    }
}

Writing an archive

# #![allow(unused_must_use)]
extern crate tar;

use tar::Archive;
use std::io::File;

fn main() {
    let file = File::create(&Path::new("foo.tar")).unwrap();
    let a = Archive::new(file);

    a.append("file1.txt", &mut File::open(&Path::new("file1.txt")).unwrap());
    a.append("file2.txt", &mut File::open(&Path::new("file2.txt")).unwrap());
    a.finish();
}

License

tar-rs is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0), with portions covered by various BSD-like licenses.

See LICENSE-APACHE, and LICENSE-MIT for details.