canic-core 0.26.12

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

use super::bootstrap::BootstrapStatusOps;
use std::cell::Cell;

thread_local! {
    // Readiness is an internal synchronization barrier.
    // It must only be set once by bootstrap completion.
    // It must never be reset or inferred from public state.
    static READY: Cell<bool> = const { Cell::new(false) };
}

///
/// ReadyOps
///
/// Internal readiness barrier for bootstrap synchronization.
///
/// Semantics:
/// - Starts as false on each fresh runtime (init or post-upgrade).
/// - Transitions to true exactly once after successful bootstrap.
/// - Never transitions back to false within the same runtime.
///

pub struct ReadyOps;

impl ReadyOps {
    #[must_use]
    pub fn is_ready() -> bool {
        READY.with(Cell::get)
    }

    pub fn mark_ready() {
        READY.with(|ready| {
            if !ready.get() {
                ready.set(true);
                BootstrapStatusOps::mark_ready();
                crate::log!(crate::log::Topic::Init, Info, "canister marked READY");
            }
        });
    }
}