Struct NormalEntry

pub struct NormalEntry<T = Vec<u8>> { /* private fields */ }

Entry that read from PNA archive.

Implementations

impl<T> NormalEntry<T>

pub fn header(&self) -> &EntryHeader

Information in the header of the entry.

pub fn metadata(&self) -> &Metadata

Metadata of the entry.

pub fn xattrs(&self) -> &[ExtendedAttribute]

Extended attributes of the entry.

pub fn extra_chunks(&self) -> &[RawChunk<T>]

Extra chunks.

pub fn with_metadata(self, metadata: Metadata) -> Self

Apply metadata to the entry.

Example

use libpna::{EntryBuilder, Metadata};

let mut entry = EntryBuilder::new_dir("dir_entry".into()).build()?;
entry.with_metadata(Metadata::new());

pub fn with_xattrs(self, xattrs: &[ExtendedAttribute]) -> Self

Apply extended attributes to the entry.

Example

use libpna::{EntryBuilder, ExtendedAttribute};

let mut entry = EntryBuilder::new_dir("dir_entry".into()).build()?;
entry.with_xattrs(&[ExtendedAttribute::new("key".into(), b"value".into())]);

impl<T: Clone> NormalEntry<T>

pub fn with_extra_chunks(self, chunks: &[RawChunk<T>]) -> Self

Apply extra chunks to the entry.

Example

use libpna::{ChunkType, EntryBuilder, RawChunk};

let mut entry = EntryBuilder::new_dir("dir_entry".into()).build()?;
entry.with_extra_chunks(&[RawChunk::from_data(
    ChunkType::private(*b"myTy").unwrap(),
    b"some data",
)]);

impl<T: AsRef<[u8]>> NormalEntry<T>

pub fn reader(&self, option: impl ReadOption) -> Result<EntryDataReader<'_>>

Return the reader of this NormalEntry.

Examples

use libpna::{Archive, ReadOptions};
use std::{fs, io};

let file = fs::File::open("foo.pna")?;
let mut archive = Archive::read_header(file)?;
for entry in archive.entries_skip_solid() {
    let entry = entry?;
    let mut reader = entry.reader(ReadOptions::builder().build())?;
    let name = entry.header().path();
    let mut dist_file = fs::File::create(name)?;
    io::copy(&mut reader, &mut dist_file)?;
}

Trait Implementations

impl<T: Clone> Clone for NormalEntry<T>

fn clone(&self) -> NormalEntry<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for NormalEntry<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> From<NormalEntry<&'a [u8]>> for NormalEntry<Vec<u8>>

fn from(value: NormalEntry<&'a [u8]>) -> Self

Converts to this type from the input type.

impl<'a> From<NormalEntry<&'a [u8]>> for NormalEntry<Cow<'a, [u8]>>

fn from(value: NormalEntry<&'a [u8]>) -> Self

Converts to this type from the input type.

impl<'a> From<NormalEntry<Cow<'a, [u8]>>> for NormalEntry<Vec<u8>>

fn from(value: NormalEntry<Cow<'a, [u8]>>) -> Self

Converts to this type from the input type.

impl<T> From<NormalEntry<T>> for ReadEntry<T>

fn from(value: NormalEntry<T>) -> Self

Converts to this type from the input type.

impl From<NormalEntry> for NormalEntry<Cow<'_, [u8]>>

fn from(value: NormalEntry<Vec<u8>>) -> Self

Converts to this type from the input type.

impl<T: Hash> Hash for NormalEntry<T>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: Ord> Ord for NormalEntry<T>

fn cmp(&self, other: &NormalEntry<T>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<T: PartialEq> PartialEq for NormalEntry<T>

fn eq(&self, other: &NormalEntry<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: PartialOrd> PartialOrd for NormalEntry<T>

fn partial_cmp(&self, other: &NormalEntry<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T> Entry for NormalEntry<T>

where NormalEntry<T>: SealedEntryExt,

impl<T: Eq> Eq for NormalEntry<T>

impl<T> StructuralPartialEq for NormalEntry<T>