rust-tokio-supervisor 0.1.3

A Rust tokio supervisor with declarative task supervision, restart policy, shutdown coordination, and observability.
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

//! Command audit configuration model.
//!
//! This module owns the single public audit configuration used by the
//! supervisor root configuration and by IPC security audit persistence.

use confique::Config;
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};

/// Audit persistence configuration.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize, Config, JsonSchema)]
pub struct AuditConfig {
    /// Whether audit logging is enabled. Default: true.
    #[config(default = true)]
    #[serde(default = "default_true")]
    pub enabled: bool,

    /// Audit storage backend. Default: "memory".
    /// - "memory": ring buffer only, not persisted.
    /// - "file": append-only JSON lines file.
    #[config(default = "memory")]
    #[serde(default = "default_audit_backend")]
    pub backend: String,

    /// File path for file backend. Required when backend is "file".
    #[serde(default)]
    pub file_path: Option<String>,

    /// Failure strategy when audit backend is unavailable.
    /// - "fail_closed": reject write commands when audit cannot be written.
    /// - "defer_bounded": defer audit writes with bounded queue.
    ///   Default: "fail_closed".
    #[config(default = "fail_closed")]
    #[serde(default = "default_fail_closed")]
    pub failure_strategy: String,

    /// Max queue size for "defer_bounded" strategy. Default: 1000.
    #[config(default = 1000)]
    #[serde(default = "default_1000")]
    pub max_defer_queue: usize,
}

impl Default for AuditConfig {
    /// Returns default audit config: memory backend, fail_closed strategy.
    fn default() -> Self {
        Self {
            enabled: true,
            backend: "memory".into(),
            file_path: None,
            failure_strategy: "fail_closed".into(),
            max_defer_queue: 1000,
        }
    }
}

/// Serde default helper: returns true.
fn default_true() -> bool {
    true
}

/// Serde default helper: returns "memory".
fn default_audit_backend() -> String {
    "memory".into()
}

/// Serde default helper: returns "fail_closed".
fn default_fail_closed() -> String {
    "fail_closed".into()
}

/// Serde default helper: returns 1000.
fn default_1000() -> usize {
    1000
}