dfajit 0.1.1

JIT compilation of DFA transition tables to native x86_64 jump tables
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

//! Error types for DFA JIT compilation.

/// Errors from DFA compilation or execution.
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum Error {
    /// The DFA has zero states.
    #[error("DFA has zero states. Fix: provide at least one state in the transition table.")]
    EmptyDfa,

    /// The transition table dimensions are inconsistent.
    #[error("invalid transition table: {reason}. Fix: ensure transitions.len() == state_count * class_count. Validate your TransitionTable inputs carefully.")]
    InvalidTable {
        /// Description of the inconsistency.
        reason: String,
    },

    /// Executable memory allocation failed.
    #[error("failed to allocate executable memory: {reason}. Fix: check OS memory limits and mmap permissions.")]
    MemoryAllocation {
        /// Underlying reason.
        reason: String,
    },

    /// The DFA state count exceeds the JIT compiler's limit.
    #[error("DFA has {states} states, exceeding the {max}-state JIT limit. Fix: use the interpreted fallback for large DFAs.")]
    TooManyStates {
        /// Actual state count.
        states: usize,
        /// Maximum supported by JIT.
        max: usize,
    },
}

/// Result type alias.
pub type Result<T> = std::result::Result<T, Error>;