cloud-sdk 0.55.0

no_std-first provider-neutral cloud SDK foundations.
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

use super::DiagnosticEvent;

/// Caller-owned opt-in sink for payload-free lifecycle events.
///
/// Core never logs and never retains the observer or its errors. The shared
/// receiver permits reentrant use and concurrent observation when the caller's
/// implementation supplies the necessary interior synchronization. Returned
/// errors are ignored; panics follow ordinary Rust panic behavior while the
/// workspace lease retains cleanup ownership during unwinding.
pub trait DiagnosticObserver {
    /// Caller-specific observation failure.
    type Error;

    /// Observes one copy-only event. Returned errors never alter SDK execution.
    fn observe(&self, event: DiagnosticEvent) -> Result<(), Self::Error>;
}

/// Disabled observer used by ordinary client methods.
#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
pub struct NoopDiagnosticObserver;

impl DiagnosticObserver for NoopDiagnosticObserver {
    type Error = core::convert::Infallible;

    fn observe(&self, _event: DiagnosticEvent) -> Result<(), Self::Error> {
        Ok(())
    }
}

pub(crate) fn notify<O>(observer: &O, event: DiagnosticEvent)
where
    O: DiagnosticObserver + ?Sized,
{
    let _ignored = observer.observe(event);
}