canic-core 0.99.21

Canic — a canister orchestration and management toolkit for the Internet Computer
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

//! Module: model::fleet_activation::endpoint_mode
//!
//! Responsibility: own the explicit runtime distinction between managed and standalone-local endpoints.
//! Does not own: Fleet identity, stable activation state, endpoint policy, or lifecycle scheduling.
//! Boundary: lifecycle ops set the mode synchronously; missing initialization defaults fail-closed to managed.

use std::cell::Cell;

///
/// FleetEndpointMode
///

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum FleetEndpointMode {
    Managed,
    StandaloneLocal,
}

thread_local! {
    static FLEET_ENDPOINT_MODE: Cell<FleetEndpointMode> =
        const { Cell::new(FleetEndpointMode::Managed) };
}

///
/// FleetEndpointModeState
///

pub struct FleetEndpointModeState;

impl FleetEndpointModeState {
    pub fn set(mode: FleetEndpointMode) {
        FLEET_ENDPOINT_MODE.set(mode);
    }

    #[must_use]
    pub fn get() -> FleetEndpointMode {
        FLEET_ENDPOINT_MODE.get()
    }
}

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

    #[test]
    fn endpoint_mode_defaults_to_managed_and_changes_only_explicitly() {
        FleetEndpointModeState::set(FleetEndpointMode::Managed);
        assert_eq!(FleetEndpointModeState::get(), FleetEndpointMode::Managed);

        FleetEndpointModeState::set(FleetEndpointMode::StandaloneLocal);
        assert_eq!(
            FleetEndpointModeState::get(),
            FleetEndpointMode::StandaloneLocal
        );

        FleetEndpointModeState::set(FleetEndpointMode::Managed);
    }
}