Struct UploadValidator 

pub struct UploadValidator { /* private fields */ }

Validates one UploadPack stream’s framing, chunk by chunk, without buffering or hashing. After any error the stream is dead: every later call returns that same error.

Implementations

impl UploadValidator

pub fn new( pack_id: Option<&[u8]>, total_bytes: Option<u64>, limits: UploadLimits, ) -> Result<Self, UploadError>

Start validating from the header’s pack_id and total_bytes (None when absent).

Errors

UploadError::BadPackId, UploadError::TotalMissing or UploadError::TotalTooLarge.

pub fn push( &mut self, chunk_pack_id: Option<&[u8]>, offset: Option<u64>, data_len: usize, last: bool, ) -> Result<Progress, UploadError>

Account for one chunk carrying data_len bytes.

Errors

UploadError::AfterLast, UploadError::TooManyChunks, UploadError::BadPackId, UploadError::PackIdMismatch, UploadError::OffsetMissing, UploadError::OffsetGap, UploadError::ByteCountOverflow, UploadError::Overrun or, on the last chunk, UploadError::LengthMismatch. After any error, this and every later call return that same error, and nothing the failed chunk carried is counted.

pub fn finish(self) -> Result<UploadDone, UploadError>

End of stream.

Errors

The error that killed the stream, if any; otherwise UploadError::NoLast if the last chunk never arrived.

pub const fn key(&self) -> PackKey

The pack id the header declared.

pub const fn declared(&self) -> u64

The total_bytes the header declared.

pub const fn received(&self) -> u64

Bytes accepted so far.

Trait Implementations

impl Clone for UploadValidator

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 UploadValidator

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

Formats the value using the given formatter.