Struct SolidArchive

pub struct SolidArchive<T: Write> { /* private fields */ }

An object providing writing to a solid mode PNA file. An instance of an SolidArchive can be written.

Examples

Creates a new solid mode PNA file and adds entry to it.

use libpna::{Archive, EntryBuilder, WriteOptions};
use std::fs::File;

let option = WriteOptions::builder().build();
let file = File::create("foo.pna")?;
let mut archive = Archive::write_solid_header(file, option)?;
let mut entry_builder = EntryBuilder::new_file("bar.txt".into(), WriteOptions::store())?;
entry_builder.write_all(b"content")?;
let entry = entry_builder.build()?;
archive.add_entry(entry)?;
archive.finalize()?;

Implementations

impl<W: Write> SolidArchive<W>

pub fn add_entry<T>(&mut self, entry: NormalEntry<T>) -> Result<usize>

where NormalEntry<T>: Entry,

Adds a new entry to the archive.

Arguments

• entry - The entry to add to the archive.

Examples

use libpna::{Archive, EntryBuilder, WriteOptions};
use std::fs::File;

let option = WriteOptions::builder().build();
let file = File::create("example.pna")?;
let mut archive = Archive::write_solid_header(file, option)?;
archive
    .add_entry(EntryBuilder::new_file("example.txt".into(), WriteOptions::store())?.build()?)?;
archive.finalize()?;

pub fn write_file<F>( &mut self, name: EntryName, metadata: Metadata, f: F, ) -> Result<()>

where F: FnMut(&mut SolidArchiveEntryDataWriter<'_, W>) -> Result<()>,

Write a regular file as solid entry into archive.

Example

use libpna::{Archive, Metadata, WriteOptions};
use std::fs;
use std::io::{self, prelude::*};

let file = fs::File::create("foo.pna")?;
let option = WriteOptions::builder().build();
let mut archive = Archive::write_solid_header(file, option)?;
archive.write_file("bar.txt".into(), Metadata::new(), |writer| {
    writer.write_all(b"text")
})?;
archive.finalize()?;

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

Write an end marker to finalize the archive.

Marks that the PNA archive contains no more entries. Normally, a PNA archive reader will continue reading entries in the hope that the entry exists until it encounters this end marker. This end marker should always be recorded at the end of the file unless there is a special reason to do so.

Examples

Create an empty archive.

use libpna::{Archive, WriteOptions};
use std::fs::File;

let option = WriteOptions::builder().build();
let file = File::create("example.pna")?;
let mut archive = Archive::write_solid_header(file, option)?;
archive.finalize()?;