Struct IntegrityGaps 

pub struct IntegrityGaps { /* private fields */ }

What a requested integrity check left unverified.

The counts, the listed entries and the IntegrityIncomplete issue message all come from this one value, so they cannot disagree. Items that belong to no single entry (a TAR stream without an end marker) are only counted; entries past a fixed cap (256 today; rely on omitted, not the number) are counted in omitted instead of listed. The counts shape differs per surface: an iterator in Rust, a map in the CLI JSON, a dict in Python and an array of {reason, count} in Node.

Examples

use exarch_core::DecompressionBudget;
use exarch_core::IntegrityCheck;
use exarch_core::SecurityConfig;
use exarch_core::VerificationOptions;
use exarch_core::verify_archive_with_options;

let options = VerificationOptions::default()
    .with_integrity(IntegrityCheck::DecodeToEof(DecompressionBudget::DEFAULT));
let report = verify_archive_with_options("a.7z", &SecurityConfig::default(), &options)?;
if let Some(gaps) = report.integrity_gaps() {
    for (reason, count) in gaps.counts() {
        println!("{reason}: {count}");
    }
}

Implementations

impl IntegrityGaps

pub fn counts(&self) -> impl Iterator<Item = (UnverifiedReason, u64)> + '_

Counts of unverified items per reason, in reason order; reasons with no items are absent.

pub fn count(&self, reason: UnverifiedReason) -> u64

Number of items left unverified for reason.

pub fn total(&self) -> u64

Total number of unverified items.

pub fn is_empty(&self) -> bool

Returns true when nothing was left unverified.

pub fn entries(&self) -> &[UnverifiedEntry]

The unverified entries that could be listed by path, up to a fixed cap; further ones are counted in omitted.

pub const fn omitted(&self) -> u64

Number of unverified entries that had a path but were not listed because the list was full.

Trait Implementations

impl Clone for IntegrityGaps

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IntegrityGaps

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

Formats the value using the given formatter.

impl Default for IntegrityGaps

fn default() -> Self

Returns the “default value” for a type.

impl Eq for IntegrityGaps

impl PartialEq for IntegrityGaps

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for IntegrityGaps