Lib.rs

API of totebag crate

🗣️ Overview

This is the README for the totebag crate, which provides the API of the totebag tool for extracting/archiving files and directories in multiple formats.

The totebag crate provides a unified API for handling various archive formats, making it easy for developers to integrate archiving and extraction functionality into their Rust applications. It abstracts the differences between various archive formats, providing a consistent interface for working with archives.

Supported archive formats

• Ar
• Cab
• Cpio
• Tar
• Tar+Gzip
• Tar+Bzip2
• Tar+Xz
• Tar+Zstd
• Zip
• 7z
• Lha, Lzh (extraction only)
• Rar (extraction only)

🚶 How to use

💚 Archiving files and directories

use std::path::PathBuf;

let config = totebag::ArchiveConfig::builder()
    .dest("results/test.zip")         // destination file.
    .rebase_dir(PathBuf::from("new")) // rebased directory in the archive file.
    .overwrite(true)                  // set overwrite flag of the destination file.
    .build();
let targets: Vec<PathBuf> = vec!["src", "Cargo.toml"].iter() // files to be archived.
    .map(|s| PathBuf::from(s)).collect::<Vec<_>>();   
match totebag::archive(&targets, &config) {
    Ok(_) => println!("archiving is done"),
    Err(e) => eprintln!("error: {:?}", e),
}

💛 Extracting the archive file

use std::path::PathBuf;

let config = totebag::ExtractConfig::builder()
    .dest("results") // set the destination directory.
    .build();
match totebag::extract("extracting_archive_file.zip", &config) {
    Ok(r) => println!("{:?}", r),
    Err(e) => println!("error: {:?}", e),
}

Compression level

💙 List entries in an archive file

The list function returns a string-formatted list of entries in the archive file.

use std::path::PathBuf;

let file = PathBuf::from("listing_archive_file.zip");
let config = totebag::ListConfig::new(totebag::OutputFormat::Default);
match totebag::list(file, &config) {
    Ok(formatted_list) => println!("{:?}", formatted_list),
    Err(e) => println!("error: {:?}", e),
}

The entries function returns a vector of Entry objects that are reflected in the archive file.

use std::path::PathBuf;

let file = PathBuf::from("listing_archive_file.zip");
match totebag::entries(file) {
    Ok(entries) => println!("{:?}", entries),
    Err(e) => println!("error: {:?}", e),
}