Struct DictionaryConfig 

pub struct DictionaryConfig {

    pub dictionary_type: DictionaryType,
    pub chars: String,
    pub start: Option<String>,
    pub length: Option<usize>,
    pub start_codepoint: Option<u32>,
    pub words: Option<Vec<String>>,
    pub words_file: Option<String>,
    pub delimiter: Option<String>,
    pub case_sensitive: Option<bool>,
    pub alternating: Option<Vec<String>>,
    pub mode: Option<EncodingMode>,
    pub padding: Option<String>,
    pub common: bool,
}

Configuration for a single dictionary loaded from TOML.

Fields

dictionary_type: DictionaryType

Dictionary type: “char” (default) or “word”

chars: String

The characters comprising the dictionary (explicit list)

start: Option<String>

Starting character for range-based dictionary definition Use with length to define sequential Unicode ranges

length: Option<usize>

Number of characters in range-based dictionary Use with start to define sequential Unicode ranges

start_codepoint: Option<u32>

Starting Unicode codepoint for ByteRange mode (256 chars)

words: Option<Vec<String>>

Inline word list for word-based dictionaries

words_file: Option<String>

Path to external word list file (one word per line)

delimiter: Option<String>

Delimiter between words in encoded output (default: “ “)

case_sensitive: Option<bool>

Whether word matching is case-sensitive (default: false)

alternating: Option<Vec<String>>

Names of sub-dictionaries for alternating word encoding (e.g., [“pgp_even”, “pgp_odd”])

mode: Option<EncodingMode>

The encoding mode to use (auto-detected if not specified)

padding: Option<String>

Optional padding character (e.g., “=” for base64)

common: bool

Whether this dictionary renders consistently across platforms (default: true) Dictionaries with common=false are excluded from random selection (–dejavu)

Implementations

impl DictionaryConfig

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

Returns the effective character set, generating from range if needed.

Priority:

1. If chars is non-empty, use it directly
2. If start + length are set, generate sequential range
3. Otherwise return empty string (ByteRange mode uses start_codepoint instead)

pub fn effective_mode(&self) -> EncodingMode

Returns the effective encoding mode, auto-detecting if not explicitly set.

Auto-detection rules:

• ByteRange: Must be explicitly set (requires start_codepoint)
• Chunked: If alphabet length is a power of 2
• Radix: Otherwise (true base conversion)

Trait Implementations

impl Clone for DictionaryConfig

fn clone(&self) -> DictionaryConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DictionaryConfig

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

Formats the value using the given formatter.

impl Default for DictionaryConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DictionaryConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.