Struct CreationSource 

pub struct CreationSource {
    pub path: PathBuf,
    pub par2_name: String,
    pub file_id: FileId,
    pub file_length: u64,
    pub hash_full: [u8; 16],
    pub hash_16k: [u8; 16],
    pub slice_checksums: Vec<SliceChecksum>,
}

A validated explicit source file and the metadata needed by critical PAR2 packets.

What a planned source has, and what only a created one has

Planning needs a file’s identity — path, PAR2 name, length, the 16 KiB digest, the FileId derived from them, and how many slices the file occupies. It does not need the file’s contents: hash_full and the per-slice checksums are read by exactly one place, the FileDesc and IFSC bodies in output.rs, and those are only written when outputs are.

Planning fills only the identity, leaving hash_full zero and one zeroed SliceChecksum per slice — correctly sized, so every quantity derived from a source (packet lengths, the memory plan, the staged packet layout) is already final at planning time — and creation fills the content hashes from the encoder’s input feed where possible, avoiding a separate hashing pass. Other paths read the source to compute the hashes before writing the final packets.

A source held by a Par2CreatePlan therefore carries placeholder content hashes; the sources handed to packet building never do.

Fields

path: PathBuf

Canonical path read during creation.

par2_name: String

Safe path recorded in PAR2 packets, using / separators.

file_id: FileId

PAR2 file identifier.

file_length: u64

Source length in bytes.

hash_full: [u8; 16]

MD5 of the complete source file. Zero until creation fills it; see the type’s note on planned versus created sources.

hash_16k: [u8; 16]

MD5 of the first 16KiB, or the complete file when shorter.

slice_checksums: Vec<SliceChecksum>

Zero-padded per-slice CRC32 and MD5 pairs. One entry per slice from planning onward; the entries are zero until creation fills them.

Implementations

impl CreationSource

pub fn slice_count(&self) -> u32

Number of source slices represented by this source.

Trait Implementations

impl Clone for CreationSource

fn clone(&self) -> CreationSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CreationSource

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

Formats the value using the given formatter.

impl Eq for CreationSource

impl PartialEq for CreationSource

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CreationSource