#tar-archive #tar #reader-writer #file-reader

async-tar

A Rust implementation of an async 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.

9 unstable releases

0.5.0 Sep 2, 2024
0.4.2 Aug 24, 2021
0.4.1 Jul 29, 2021
0.3.0 Jul 29, 2020
0.1.1 Dec 24, 2019

#34 in Compression

Download history 3013/week @ 2024-08-04 3645/week @ 2024-08-11 4810/week @ 2024-08-18 5837/week @ 2024-08-25 5310/week @ 2024-09-01 4729/week @ 2024-09-08 5408/week @ 2024-09-15 5561/week @ 2024-09-22 5395/week @ 2024-09-29 6370/week @ 2024-10-06 5902/week @ 2024-10-13 5715/week @ 2024-10-20 6346/week @ 2024-10-27 7117/week @ 2024-11-03 7170/week @ 2024-11-10 5835/week @ 2024-11-17

26,802 downloads per month
Used in 16 crates (10 directly)

MIT/Apache

150KB
3K SLoC

async-tar

A tar archive reading/writing library for async Rust.


Based on the great tar-rs.

Reading an archive

use async_std::io::stdin;
use async_std::prelude::*;

use async_tar::Archive;

fn main() {
    async_std::task::block_on(async {
        let mut ar = Archive::new(stdin());
        let mut entries = ar.entries().unwrap();
        while let Some(file) = entries.next().await {
            let f = file.unwrap();
            println!("{}", f.path().unwrap().display());
        }
    });
}

Writing an archive

use async_std::fs::File;
use async_tar::Builder;

fn main() {
    async_std::task::block_on(async {
        let file = File::create("foo.tar").await.unwrap();
        let mut a = Builder::new(file);

        a.append_path("README.md").await.unwrap();
        a.append_file("lib.rs", &mut File::open("src/lib.rs").await.unwrap())
            .await
            .unwrap();
    });
}

MSRV

Minimal stable rust version: 1.63

An increase to the MSRV is accompanied by a minor version bump

License

This project is licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~5–14MB
~185K SLoC