oxihuman-core 0.1.2

Core data structures, algorithms, and asset management for OxiHuman
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
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

// Copyright (C) 2026 COOLJAPAN OU (Team KitaSan)
// SPDX-License-Identifier: Apache-2.0
#![allow(dead_code)]

pub struct AggregateRoot {
    pub id: u64,
    pub version: u64,
    pub pending_events: Vec<String>,
}

pub fn new_aggregate_root(id: u64) -> AggregateRoot {
    AggregateRoot {
        id,
        version: 0,
        pending_events: Vec::new(),
    }
}

pub fn aggregate_apply_event(a: &mut AggregateRoot, event: &str) {
    a.pending_events.push(event.to_string());
    a.version += 1;
}

pub fn aggregate_pending_events(a: &AggregateRoot) -> &[String] {
    &a.pending_events
}

pub fn aggregate_clear_events(a: &mut AggregateRoot) {
    a.pending_events.clear();
}

pub fn aggregate_version(a: &AggregateRoot) -> u64 {
    a.version
}

pub fn aggregate_increment_version(a: &mut AggregateRoot) {
    a.version += 1;
}

pub fn aggregate_id(a: &AggregateRoot) -> u64 {
    a.id
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_new_aggregate() {
        /* new aggregate has version 0 and no events */
        let a = new_aggregate_root(1);
        assert_eq!(aggregate_id(&a), 1);
        assert_eq!(aggregate_version(&a), 0);
        assert!(aggregate_pending_events(&a).is_empty());
    }

    #[test]
    fn test_apply_event() {
        /* applying event adds to pending and increments version */
        let mut a = new_aggregate_root(1);
        aggregate_apply_event(&mut a, "UserCreated");
        assert_eq!(aggregate_version(&a), 1);
        assert_eq!(aggregate_pending_events(&a).len(), 1);
    }

    #[test]
    fn test_clear_events() {
        /* clear removes pending events */
        let mut a = new_aggregate_root(1);
        aggregate_apply_event(&mut a, "ev1");
        aggregate_clear_events(&mut a);
        assert!(aggregate_pending_events(&a).is_empty());
    }

    #[test]
    fn test_increment_version() {
        /* explicit version increment */
        let mut a = new_aggregate_root(1);
        aggregate_increment_version(&mut a);
        assert_eq!(aggregate_version(&a), 1);
    }

    #[test]
    fn test_multiple_events() {
        /* multiple events accumulate */
        let mut a = new_aggregate_root(2);
        aggregate_apply_event(&mut a, "ev1");
        aggregate_apply_event(&mut a, "ev2");
        aggregate_apply_event(&mut a, "ev3");
        assert_eq!(aggregate_version(&a), 3);
        assert_eq!(aggregate_pending_events(&a).len(), 3);
    }

    #[test]
    fn test_version_preserved_after_clear() {
        /* version not reset when events cleared */
        let mut a = new_aggregate_root(1);
        aggregate_apply_event(&mut a, "e");
        aggregate_clear_events(&mut a);
        assert_eq!(aggregate_version(&a), 1);
    }

    #[test]
    fn test_aggregate_id() {
        /* id stored correctly */
        let a = new_aggregate_root(42);
        assert_eq!(aggregate_id(&a), 42);
    }
}