Struct ContainerCaps 

pub struct ContainerCaps {
    pub read: bool,
    pub write: bool,
    pub forward_parse: bool,
    pub degraded_parse: bool,
    pub trailing_index: bool,
    pub solid: bool,
    pub per_entry_codec: bool,
    pub needs_seek: bool,
    pub stores_dirs: bool,
    pub stores_symlinks: bool,
}

What a container can do, and what it needs from its input.

Fields

read: bool

write: bool

forward_parse: bool

Entries can be enumerated from a forward-only source at full data fidelity (metadata may be approximate). True for zip, tar, cpio.

degraded_parse: bool

Only a best-effort salvage scan is possible forward-only. Distinct from forward_parse: this rung yields partial results by construction.

trailing_index: bool

The authoritative index lives at the end of the stream (zip, 7z, rar).

solid: bool

Entries share codec state, so reaching entry N decodes 1..N (7z, rar).

per_entry_codec: bool

Each entry carries its own codec (zip, 7z).

needs_seek: bool

Random access is required even to enumerate (squashfs, iso).

stores_dirs: bool

A directory can be recorded AS a directory, rather than as an empty regular file that happens to share its name.

ar is the counter-example and the reason this field exists: its format has no directory concept at all, so writing one produces a zero-byte file named proj/sub — after which an entry named proj/sub/a.txt cannot be extracted, because its parent is a file. A writer that cannot store the kind is expected to be told so by its caller and warn, rather than emit the lie.

stores_symlinks: bool

A symlink can be recorded as a link, target and all, rather than as a regular file carrying the target text as its contents.

Implementations

impl ContainerCaps

pub const fn read_only() -> Self

A container that can be read but not written — RAR, whose compressor is proprietary.

pub const fn read_write() -> Self

A container supporting both directions. Every other capability stays false — a constructor must not claim what a format has not.

Trait Implementations

impl Clone for ContainerCaps

fn clone(&self) -> ContainerCaps

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ContainerCaps

impl Debug for ContainerCaps

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

Formats the value using the given formatter.

impl Default for ContainerCaps

fn default() -> ContainerCaps

Returns the “default value” for a type.

impl Eq for ContainerCaps

impl PartialEq for ContainerCaps

fn eq(&self, other: &ContainerCaps) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ContainerCaps