rotorix-core 0.1.0

Enigma-inspired transformation pipeline with explicit state and pluggable components
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

//! Core transformation component abstraction.
//!
//! All Enigma pipeline elements (plugboard, rotors, reflector)
//! implement this trait.

use crate::state::EnigmaState;

/// Trait implemented by all Enigma transformation components.
///
/// A component must be able to transform a single symbol in both
/// forward and reverse directions, using the current Enigma state.
///
/// Components are expected to be **pure**:
/// - no internal mutable state
/// - deterministic behavior
/// - all state is provided externally via `EnigmaState`
pub trait EnigmaComponent {
    /// Transform a symbol in the forward direction.
    ///
    /// This method is used during the forward pass through the pipeline.
    fn forward(&self, input: u8, state: &EnigmaState) -> u8;

    /// Transform a symbol in the reverse direction.
    ///
    /// This method is used during the reverse pass through the pipeline.
    fn backward(&self, input: u8, state: &EnigmaState) -> u8;
}