Struct ShardWriter 

pub struct ShardWriter { /* private fields */ }

Builder for creating shards.

A shard is a zstd-compressed blob of concatenated file contents. File indexing is handled by the TreeManifest, not the shard itself. Shards are opaque blocks — like filesystem blocks.

Implementations

impl ShardWriter

pub fn new() -> Self

Creates a new shard writer.

pub fn add_file(&mut self, path: &str, content: &[u8]) -> Result<()>

Adds a file to the shard.

Arguments

• path - File path (validated for safety)
• content - File content bytes

Errors

Returns VoidError::Shard if the path is invalid.

pub fn finish(self, compression_level: i32) -> Result<Vec<u8>>

Finishes building and returns the zstd-compressed shard bytes.

Errors

Returns VoidError::Compression if compression fails.

pub fn file_count(&self) -> u32

Returns the number of files added.

pub fn body_size(&self) -> usize

Returns the uncompressed body size.

pub fn is_empty(&self) -> bool

Returns true if this shard has no content.

pub fn finish_padded( self, strategy: PaddingStrategy, compression_level: i32, ) -> Result<Vec<u8>>

Finishes building and returns serialized shard bytes with optional size padding.

Padding is applied to hide the true shard size from the server. The padding size is stored as a little-endian u64 at the end of the shard.

Errors

Returns VoidError::Compression if compression fails.

Trait Implementations

impl Default for ShardWriter

fn default() -> Self

Returns the “default value” for a type.