Struct Builder 

pub struct Builder<W: Write> { /* private fields */ }

A structure for building Common or BSD-variant archives (the archive format typically used on e.g. BSD and Mac OS X systems).

This structure has methods for building up an archive from scratch into any arbitrary writer.

Implementations

impl<W: Write> Builder<W>

pub fn new(writer: W) -> Builder<W>

Create a new archive builder with the underlying writer object as the destination of all data written.

Examples found in repository

examples/create.rs (line 33)

fn main() {
    let num_args = env::args().count();
    if num_args < 3 {
        println!("Usage: create <outpath> <inpath> [<inpath>...]");
        return;
    }

    let output_path = env::args().nth(1).unwrap();
    let output_path = Path::new(&output_path);
    let output_file =
        File::create(output_path).expect("failed to open output file");
    let mut builder = ar::Builder::new(output_file);

    for index in 2..num_args {
        let input_path = env::args().nth(index).unwrap();
        let input_path = Path::new(&input_path);
        builder
            .append_path(input_path)
            .expect(&format!("failed to add {:?} to archive", input_path));
    }
}

pub fn into_inner(self) -> Result<W>

Unwrap this archive builder, returning the underlying writer object.

pub fn append<R: Read>(&mut self, header: &Header, data: R) -> Result<()>

Adds a new entry to this archive.

pub fn append_path<P: AsRef<Path>>(&mut self, path: P) -> Result<()>

Adds a file on the local filesystem to this archive, using the file name as its identifier.

Examples found in repository

examples/create.rs (line 39)

fn main() {
    let num_args = env::args().count();
    if num_args < 3 {
        println!("Usage: create <outpath> <inpath> [<inpath>...]");
        return;
    }

    let output_path = env::args().nth(1).unwrap();
    let output_path = Path::new(&output_path);
    let output_file =
        File::create(output_path).expect("failed to open output file");
    let mut builder = ar::Builder::new(output_file);

    for index in 2..num_args {
        let input_path = env::args().nth(index).unwrap();
        let input_path = Path::new(&input_path);
        builder
            .append_path(input_path)
            .expect(&format!("failed to add {:?} to archive", input_path));
    }
}

pub fn append_file(&mut self, name: &[u8], file: &mut File) -> Result<()>

Adds a file to this archive, with the given name as its identifier.