star-toml 26.7.3

Framework for loading, layering, and validating any *.toml configuration file
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
110
111

//! Test suite for validating the wasm4pm-compat OCEL export mapping and adapter integration.
//! wasm4pm-compat is a required dependency; no feature flag is needed.

use star_toml::{
    events::{AdmissionEvent, ConfigEventKind},
    ocel::export_events_to_ocel,
};

#[test]
fn test_ocel_export_does_not_compute_q() {
    // The OCEL export should only represent the audit process log, without computing or defining q_config.
    let event = AdmissionEvent::new(
        "run123",
        "evt_001",
        1,
        ConfigEventKind::SourceDiscovered,
        vec!["source_file.toml".to_string()],
        vec![("path".to_string(), "config.toml".to_string())],
    );

    let log = export_events_to_ocel(&[event]);

    // Validate that no q_config attribute exists on the objects or events (ensuring no q_config is computed or defined here).
    for obj in log.objects() {
        assert!(obj.attributes().iter().all(|attr| attr.key != "q_config"));
    }
    for ev in log.events() {
        assert!(ev.attributes().iter().all(|attr| attr.key != "q_config"));
    }
}

#[test]
fn test_lifecycle_events_export_to_ocel() {
    let events = vec![
        AdmissionEvent::new(
            "run123",
            "evt_001",
            1,
            ConfigEventKind::SourceDiscovered,
            vec!["source_config.toml".to_string()],
            vec![("source".to_string(), "main".to_string())],
        ),
        AdmissionEvent::new(
            "run123",
            "evt_002",
            2,
            ConfigEventKind::LayerMerged,
            vec!["layer_main".to_string()],
            vec![("strategy".to_string(), "recursive".to_string())],
        ),
    ];

    let log = export_events_to_ocel(&events);

    assert_eq!(log.events().len(), 2);
    assert_eq!(log.events()[0].activity(), "SourceDiscovered");
    assert_eq!(log.events()[1].activity(), "LayerMerged");

    // Check ConfigRun object is mapped
    let run_obj_found = log.objects().iter().any(|obj| obj.object_type() == "ConfigRun");
    assert!(run_obj_found);
}

#[test]
fn test_ocel_export_preserves_event_order() {
    let events = vec![
        AdmissionEvent::new(
            "run_999",
            "first_id",
            10,
            ConfigEventKind::SourceDiscovered,
            vec![],
            vec![],
        ),
        AdmissionEvent::new(
            "run_999",
            "second_id",
            20,
            ConfigEventKind::ConfigValidated,
            vec![],
            vec![],
        ),
    ];

    let log = export_events_to_ocel(&events);
    assert_eq!(log.events().len(), 2);
    assert_eq!(log.events()[0].id(), "first_id");
    assert_eq!(log.events()[0].timestamp_ns(), Some(10));
    assert_eq!(log.events()[1].id(), "second_id");
    assert_eq!(log.events()[1].timestamp_ns(), Some(20));
}

#[test]
fn test_ocel_export_has_config_run_object() {
    let event = AdmissionEvent::new(
        "my_test_run",
        "evt_010",
        100,
        ConfigEventKind::CanonicalSaved,
        vec!["canonical_output.toml".to_string()],
        vec![],
    );

    let log = export_events_to_ocel(&[event]);
    let run_obj = log
        .objects()
        .iter()
        .find(|obj| obj.object_type() == "ConfigRun")
        .expect("ConfigRun object should exist");
    assert_eq!(run_obj.id(), "run_my_test_run");
}