Struct CommittedFileEvidence 

pub struct CommittedFileEvidence { /* private fields */ }

Immutable evidence captured when an assembled file is committed.

The fields are intentionally private: every instance is created only after statting its path and checking its recorded size against the expected file length.

Implementations

impl CommittedFileEvidence

pub fn from_full_md5_path( path: impl AsRef<Path>, logical_name: impl Into<String>, expected_length: u64, md5: [u8; 16], bound_file_id: Option<FileId>, ) -> Result<Self, EvidenceError>

Capture evidence based on a complete file MD5.

pub fn from_contiguous_assembly_path( path: impl AsRef<Path>, logical_name: impl Into<String>, expected_length: u64, crc32: u32, hash_16k: [u8; 16], proof: ContiguousAssemblyProof, bound_file_id: Option<FileId>, ) -> Result<Self, EvidenceError>

Capture evidence based on a contiguous CRC-verified assembly.

pub fn path(&self) -> &Path

Path statted while this evidence was captured.

pub fn logical_name(&self) -> &str

The logical output name associated with the path.

pub fn expected_length(&self) -> u64

The expected unpadded file length.

pub fn stat_fingerprint(&self) -> &FileStatFingerprint

Immutable stat fingerprint captured from Self::path.

pub fn bound_file_id(&self) -> Option<FileId>

Optional PAR2 file ID explicitly bound by the caller.

pub fn file_id(&self) -> Option<FileId>

Alias for Self::bound_file_id.

pub fn full_md5(&self) -> Option<[u8; 16]>

Complete-file MD5 evidence, when that form was captured.

pub fn assembly_crc32(&self) -> Option<u32>

Complete-file CRC32 from contiguous-assembly evidence, if present.

pub fn hash_16k(&self) -> Option<[u8; 16]>

MD5 of the first 16 KiB from contiguous-assembly evidence, if present.

pub fn first_16k_md5(&self) -> Option<[u8; 16]>

Alias for Self::hash_16k.

pub fn assembly_proof(&self) -> Option<&ContiguousAssemblyProof>

Contiguous-assembly proof, when this evidence was captured that way.

Trait Implementations

impl Clone for CommittedFileEvidence

fn clone(&self) -> CommittedFileEvidence

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommittedFileEvidence

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

Formats the value using the given formatter.

impl Eq for CommittedFileEvidence

impl PartialEq for CommittedFileEvidence

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CommittedFileEvidence