tar 0.1.8

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.8
Please check build logs and if you believe this is docs.rs' fault, report into this issue report.


Build Status


A tar archive reading/writing library for Rust.

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

Reading an archive

# #![allow(unused_must_use, unstable)]
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().unwrap());

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

Writing an archive

# #![allow(unused_must_use, unstable)]
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());


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.