Struct ShardInfo 

pub struct ShardInfo {
    pub shard_index: u32,
    pub total_shards: u32,
    pub filename: String,
    pub file_size: Option<u64>,
    pub preceding_bytes: Option<u64>,
    pub group_total_bytes: Option<u64>,
}

Information about a shard within a sharded model download.

preceding_bytes and group_total_bytes carry the exact byte offsets of this shard within the whole model, so aggregate progress does not have to assume every shard is the same size. GGUF shard sets almost always end with a smaller final shard, and estimating the group total as this_shard_size * shard_count made the percentage both wrong and discontinuous at every shard boundary.

Fields

shard_index: u32

0-based index of this shard.

total_shards: u32

Total number of shards in this model.

filename: String

The specific filename for this shard.

file_size: Option<u64>

Size of this shard file in bytes (if known).

preceding_bytes: Option<u64>

Summed size of every shard before this one (if all sizes are known).

group_total_bytes: Option<u64>

Summed size of every shard in the group (if all sizes are known).

Implementations

impl ShardInfo

pub fn new( shard_index: u32, total_shards: u32, filename: impl Into<String>, ) -> Self

Create a new ShardInfo instance.

pub fn with_size( shard_index: u32, total_shards: u32, filename: impl Into<String>, file_size: u64, ) -> Self

Create a new ShardInfo instance with file size.

pub const fn with_group_offsets(self, preceding: u64, group_total: u64) -> Self

Attach the exact byte offsets of this shard within its group.

Only call this when every shard size in the group is known; a partial offset is worse than none, because the fallback estimate at least stays self-consistent.

pub fn aggregate(&self, shard_downloaded: u64) -> Option<(u64, u64)>

Exact aggregate progress for the group, given this shard’s own progress.

Returns None when the group’s byte layout is unknown, leaving the caller to fall back to an equal-shard-size estimate.

pub fn display(&self) -> String

Format as display string (e.g., “Part 1/3”).

Trait Implementations

impl Clone for ShardInfo

fn clone(&self) -> ShardInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ShardInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ShardInfo

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ShardInfo

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ShardInfo

impl StructuralPartialEq for ShardInfo