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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

//! Enigma transformation state.
//!
//! This module defines the explicit state used by the Enigma pipeline.
//! All state is external to the components and can be safely cloned,
//! snapshotted, and restored.

/// Represents the mutable state of an Enigma transformation session.
///
/// The state is intentionally kept simple and explicit to guarantee
/// deterministic behavior and ease of testing.
#[derive(Default, Clone, Debug, PartialEq, Eq)]
pub struct EnigmaState {
    /// Current positions of the rotors.
    ///
    /// Each entry corresponds to a rotor in the machine, ordered
    /// from left to right.
    pub rotor_positions: Vec<u32>,

    /// Monotonic step counter.
    ///
    /// Incremented after each processed symbol.
    pub step_counter: u64,
}

impl EnigmaState {
    /// Creates a new `EnigmaState` with the given number of rotors,
    /// all initialized to position zero.
    pub fn new(rotor_count: usize) -> Self {
        Self {
            rotor_positions: vec![0; rotor_count],
            step_counter: 0,
        }
    }

    /// Resets all rotor positions and the step counter to zero.
    pub fn reset(&mut self) {
        for pos in &mut self.rotor_positions {
            *pos = 0;
        }
        self.step_counter = 0;
    }
}