zexc 1.1.0

zex native lossless compressor — CLI zexc, library zexc, files *.zex
Documentation
//! ZEX compression backends.
//!
//! The production codec is **[`zex_native`]** — an original algorithm and wire
//! format. It is **not** a wrapper around LZ4 or Zstd.
//!
//! [`turbo`] is a speed-specialized encoder that emits the same wire format
//! for levels 1–2.

pub mod optimal;
pub mod turbo;
pub mod zex_native;
pub mod ldm;

// Optional research modules (not on the default encode path).
#[cfg(feature = "legacy-backends")]
pub mod hybrid;
#[cfg(feature = "legacy-backends")]
pub mod lz4;
#[cfg(feature = "legacy-backends")]
pub mod zstd_backend;

use crate::format::block::BlockType;
use crate::Result;

/// Trait implemented by block compressors.
pub trait BlockCompressor: Send + Sync {
    /// Compress `src` into `dst`. Returns block type used.
    fn compress_block(&self, src: &[u8], dst: &mut Vec<u8>, level: u8) -> Result<BlockType>;
}

/// Trait implemented by block decompressors.
pub trait BlockDecompressor: Send + Sync {
    /// Decompress `src` into `dst` for exactly `uncompressed_size` bytes.
    fn decompress_block(
        &self,
        src: &[u8],
        dst: &mut Vec<u8>,
        uncompressed_size: usize,
    ) -> Result<()>;
}