Struct CodecRegistry 

pub struct CodecRegistry { /* private fields */ }

Central registry of compression/encoding codecs.

On construction the seven built-in codecs are pre-registered. Custom codecs can be added via CodecRegistry::register; duplicate ids are rejected.

Implementations

impl CodecRegistry

pub fn new() -> Self

Construct a new registry with all seven built-in codecs pre-registered.

pub fn register( &mut self, descriptor: CodecDescriptor, ) -> Result<(), CodecError>

Register a custom CodecDescriptor.

Returns CodecError::AlreadyRegistered if a codec with the same id already exists in the registry.

pub fn get(&self, id: CodecId) -> Option<&CodecDescriptor>

Look up a codec by its id.

Returns None when the id is not registered.

pub fn list_all(&self) -> Vec<&CodecDescriptor>

Return all registered codecs, sorted in ascending CodecId order.

pub fn negotiate(local: &[CodecId], remote: &[CodecId]) -> Option<CodecId>

Negotiate a codec between two peers.

Returns the first id in local that also appears in remote, or None if there is no common codec. This is a static method because negotiation does not require access to a registry instance — it operates purely on the id sets.

pub fn best_for_speed(&self) -> Option<&CodecDescriptor>

Return a reference to the fastest registered codec.

When multiple codecs share the best speed class the one with the numerically smallest CodecId is returned for determinism.

Returns None only if the registry is empty (not possible after new() unless all entries were somehow replaced).

pub fn best_for_compression(&self) -> Option<&CodecDescriptor>

Return a reference to the codec with the lowest compression_ratio_estimate (best compression).

When multiple codecs share the same ratio the one with the numerically smallest CodecId is returned for determinism. NaN ratio values are sorted last.

Returns None only if the registry is empty.

Trait Implementations

impl Default for CodecRegistry

fn default() -> Self

Returns the “default value” for a type.