Struct DeltaEncoder 

pub struct DeltaEncoder { /* private fields */ }

Delta encoder using bsdiff

Provides delta compression and decompression with intelligent decision logic, with optional media-aware configuration.

Implementations

impl DeltaEncoder

pub fn new() -> Self

Create a new delta encoder with default settings

pub fn with_thresholds( similarity_threshold: f64, min_space_savings: f64, ) -> Self

Create a delta encoder with custom thresholds

pub fn encode( &self, base: &[u8], target: &[u8], ) -> CompressionResult<(Vec<u8>, bool)>

Encode a delta between base and target

Returns (delta_data, should_use_delta)

Arguments

• base - Base version data
• target - Target version data

Returns

Tuple of (delta_data, should_use_delta). If should_use_delta is false, delta_data contains the full target data instead.

pub fn encode_with_depth( &self, base: &[u8], target: &[u8], current_chain_depth: u32, ) -> CompressionResult<(Vec<u8>, bool)>

Encode a delta between base and target with chain depth tracking

Returns (delta_data, should_use_delta)

Arguments

• base - Base version data
• target - Target version data
• current_chain_depth - Current depth in the delta chain

Returns

Tuple of (delta_data, should_use_delta). If should_use_delta is false, delta_data contains the full target data instead.

Delta Chain Depth

When the chain depth exceeds max_chain_depth, the encoder will return the full object instead of creating another delta. This prevents excessively long delta chains that can hurt decompression performance.

pub fn decode(&self, base: &[u8], delta: &[u8]) -> CompressionResult<Vec<u8>>

Decode a delta to reconstruct the target

Arguments

• base - Base version data
• delta - Delta data

Returns

Reconstructed target data

pub fn decode_chain( &self, versions: &[(Vec<u8>, bool)], ) -> CompressionResult<Vec<u8>>

Apply a delta chain to reconstruct the final version

Arguments

• versions - Ordered list of (data, is_delta) tuples, base first

Returns

Reconstructed final version

pub fn hash_data(data: &[u8]) -> String

Calculate hash for data (for tracking purposes)

pub fn max_chain_depth(&self) -> u32

Get the maximum chain depth setting

pub fn set_max_chain_depth(&mut self, depth: u32)

Set the maximum chain depth

When encoding deltas, if the current chain depth reaches this value, the encoder will store the full object instead of creating another delta.

Arguments

• depth - Maximum allowed chain depth (typically 50-100)

Example

use mediagit_compression::delta::DeltaEncoder;

let mut encoder = DeltaEncoder::new();
encoder.set_max_chain_depth(75);
assert_eq!(encoder.max_chain_depth(), 75);

pub fn with_max_chain_depth(max_chain_depth: u32) -> Self

Create a delta encoder with custom chain depth

Arguments

• max_chain_depth - Maximum allowed chain depth

Example

use mediagit_compression::delta::DeltaEncoder;

let encoder = DeltaEncoder::with_max_chain_depth(100);
assert_eq!(encoder.max_chain_depth(), 100);

Trait Implementations

impl Clone for DeltaEncoder

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 DeltaEncoder

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

Formats the value using the given formatter.

impl Default for DeltaEncoder

fn default() -> Self

Returns the “default value” for a type.