Struct WriteConfig 

pub struct WriteConfig {
    pub defaults: Defaults,
    pub categorizers: Vec<CategorizerConfig>,
    pub chunking: ChunkingConfig,
    pub tournament: TournamentConfig,
    pub codec_tunables: CodecTunables,
    pub mode: ImageMode,
    pub write_codec: String,
    pub turnover_threshold: u32,
    pub skip_chunking: bool,
    pub encryption: EncryptionConfig,
    pub dictionaries: DictionaryConfig,
}

Top-level write configuration. All fields are public so the TOML loader can construct values directly; runtime validation lives in WriteConfig::validate.

Fields

defaults: Defaults

Default codec selection + inline threshold.

categorizers: Vec<CategorizerConfig>

File categorizer rules (extension/magic → codec).

chunking: ChunkingConfig

FastCDC chunking parameters.

tournament: TournamentConfig

Compression tournament settings.

codec_tunables: CodecTunables

Per-codec tunable parameters (memory budgets, quality levels).

mode: ImageMode

Image mode: read-only archive or read-write filesystem.

write_codec: String

Codec for incremental writes (RW mode only). Defaults to LZ4. During turnover, defaults.text_codec is used for re-compression.

turnover_threshold: u32

Turnover threshold: number of history entries before automatic compaction triggers (RW mode only). 0 = manual turnover only.

skip_chunking: bool

Skip FastCDC chunking; compress each file as a single drop. Trades dedup granularity for create speed. Recommended for max-write profile where speed >> ratio.

encryption: EncryptionConfig

Encryption configuration.

dictionaries: DictionaryConfig

ZSTD dictionary configuration.

Implementations

impl WriteConfig

pub fn from_toml(path: &Path) -> Result<Self, ConfigError>

Load a config from a TOML file.

Errors

Returns ConfigError::Io on read errors, ConfigError::Toml on parse errors, or ConfigError::InvalidValue on validation errors.

pub fn to_toml(&self) -> Result<String, ConfigError>

Serialise to a TOML string.

Errors

Returns ConfigError::TomlSer on serialisation errors.

pub fn write_to_toml(&self, path: &Path) -> Result<(), ConfigError>

Write a serialised config to a file.

Errors

Returns ConfigError::Io on write errors or ConfigError::TomlSer on serialisation errors.

impl WriteConfig

pub fn default_v0_1() -> Self

Create the v0.1-compatible default configuration. All fields match the behavior of limnifs-write before this config was introduced.

pub fn from_profile(name: &str) -> Option<Self>

Load a built-in profile by name, then override fields via builder methods.

pub fn with_text_codec(self, codec: &str) -> Self

Override the text codec.

pub fn with_binary_codec(self, codec: &str) -> Self

Override the binary codec.

pub fn with_chunk_size(self, size: u32) -> Self

Override the average chunk size.

pub fn with_mode(self, mode: ImageMode) -> Self

Override the image mode (RO vs RW).

pub fn with_brotli_quality(self, quality: u8) -> Self

Override Brotli quality.

pub fn build(self) -> Result<Self, ConfigError>

Finalize (validate and return).

Errors

Returns ConfigError on invalid configuration.

pub fn validate(&self) -> Result<(), ConfigError>

Validate field relationships and range constraints.

Errors

Returns a ConfigError on any invalid value.

pub fn codec_registry(&self) -> Result<CodecRegistry, ConfigError>

Build the codec registry to use for this config. Maps codec names to numeric ids.

pub fn text_codec_id(&self) -> Result<u8, ConfigError>

Resolve the default text codec id.

Errors

Returns ConfigError if the codec name is unknown.

pub fn binary_codec_id(&self) -> Result<u8, ConfigError>

Resolve the default binary codec id.

Errors

Returns ConfigError if the codec name is unknown.

pub fn to_core_tunables(&self) -> CodecTunables

Build the codec-agnostic limnifs_core::codec::CodecTunables view of this config’s per-codec knobs. Used by the parallel writer to honour PPMd order/budget, Brotli quality, ZSTD level, Bzip2 block size — anything else falls back to codec defaults.

pub fn metadata_codec_id(&self) -> Result<u8, ConfigError>

Resolve the default metadata codec id.

Errors

Returns ConfigError if the codec name is unknown.

Trait Implementations

impl Clone for WriteConfig

fn clone(&self) -> WriteConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WriteConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for WriteConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for WriteConfig

impl PartialEq for WriteConfig

fn eq(&self, other: &WriteConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for WriteConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for WriteConfig