Struct PartMetadata 

pub struct PartMetadata {
    pub generation: u64,
    pub url_hash: [u8; 32],
    pub content_len: u64,
    pub chunk_size: u64,
    pub chunk_count: u64,
    pub bitmap: ChunkBitmap,
    pub etag: Option<String>,
    pub last_modified: Option<String>,
    pub hash: HashConfig,
}

Persisted state for a resumable part file.

Fields

generation: u64

Monotonic generation used to choose the newest metadata slot.

url_hash: [u8; 32]

SHA-256 hash of the source URL.

content_len: u64

Total content length in bytes.

chunk_size: u64

Normalized chunk size in bytes.

chunk_count: u64

Number of chunks in the resource.

bitmap: ChunkBitmap

Completion bitmap for all chunks.

etag: Option<String>

Stored ETag validator, when available.

last_modified: Option<String>

Stored Last-Modified validator, when available.

hash: HashConfig

Optional final-file hash verification configuration.

Implementations

impl PartMetadata

pub fn new( url_hash: [u8; 32], remote: &RemoteInfo, chunk_size: u64, hash: HashConfig, ) -> Result<Self>

Creates metadata for a new part file.

Passing 0 for chunk_size selects the default chunk size.

Errors

Returns an error if the chunk size is invalid, validator headers are too large for the metadata slot, or the completion bitmap cannot be sized.

pub fn completed_chunks(&self) -> u64

Returns the number of completed chunks.

pub fn completed_bytes(&self) -> u64

Returns the number of bytes represented by completed chunks.

pub fn all_complete(&self) -> bool

Returns whether every chunk is complete.

pub fn ensure_compatible( &self, url_hash: [u8; 32], remote: &RemoteInfo, chunk_size: u64, hash: HashConfig, ) -> Result<()>

Verifies that existing metadata still matches a remote resource and caller configuration.

Errors

Returns an error if the URL hash, content length, available validators, chunk size, or hash configuration differ from the stored metadata.

pub fn encode_slot(&self, slot_size: u64) -> Result<Vec<u8>>

Encodes this metadata into a fixed-size metadata slot.

Errors

Returns an error if slot_size is invalid for this metadata, if header values exceed their fixed capacities, or if supporting lengths overflow.

Panics

Panics only if fixed metadata constants no longer fit their encoded integer fields.

pub fn decode_slot(slot: &[u8]) -> Result<Self>

Decodes metadata from a fixed-size metadata slot.

Errors

Returns an error if the slot is too short, has an unsupported version, fails CRC validation, has inconsistent lengths, or contains invalid UTF-8/header/hash data.

Trait Implementations

impl Clone for PartMetadata

fn clone(&self) -> PartMetadata

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PartMetadata

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

Formats the value using the given formatter.

impl Eq for PartMetadata

impl PartialEq for PartMetadata

fn eq(&self, other: &PartMetadata) -> 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 StructuralPartialEq for PartMetadata