eventdbx 3.16.5

Immutable, event-sourced, nosql, write-side database system.
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

use std::{env, fmt};

use serde::{Deserialize, Serialize};

pub const RESTRICT_ENV: &str = "EVENTDB_RESTRICT";
const LEGACY_RESTRICT_ENV: &str = "EVENTFUL_RESTRICT";

#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
pub enum RestrictMode {
    Off,
    Default,
    Strict,
}

impl RestrictMode {
    pub fn as_str(self) -> &'static str {
        match self {
            Self::Off => "off",
            Self::Default => "default",
            Self::Strict => "strict",
        }
    }

    pub fn enforces_validation(self) -> bool {
        !matches!(self, Self::Off)
    }

    pub fn requires_declared_schema(self) -> bool {
        matches!(self, Self::Strict)
    }
}

impl Default for RestrictMode {
    fn default() -> Self {
        Self::Default
    }
}

impl fmt::Display for RestrictMode {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(self.as_str())
    }
}

pub fn from_env() -> RestrictMode {
    env::var(RESTRICT_ENV)
        .or_else(|_| env::var(LEGACY_RESTRICT_ENV))
        .ok()
        .and_then(|value| parse_mode(&value))
        .unwrap_or_default()
}

pub fn set_env(mode: RestrictMode) {
    // Setting environment variables is marked unsafe in the 2024 edition.
    unsafe {
        env::set_var(RESTRICT_ENV, mode.as_str());
    }
}

pub fn parse_mode(input: &str) -> Option<RestrictMode> {
    let normalized = input.trim().to_ascii_lowercase();
    match normalized.as_str() {
        "off" | "false" | "0" | "no" | "none" | "unrestricted" | "dev" => Some(RestrictMode::Off),
        "strict" | "all" | "enforced" => Some(RestrictMode::Strict),
        "default" | "true" | "1" | "yes" | "on" | "prod" | "restricted" | "hybrid" => {
            Some(RestrictMode::Default)
        }
        _ => None,
    }
}

pub fn legacy_bool(enabled: bool) -> RestrictMode {
    if enabled {
        RestrictMode::Default
    } else {
        RestrictMode::Off
    }
}

pub fn strict_mode_missing_schema_message(aggregate: &str) -> String {
    format!(
        "aggregate {} requires a schema before events can be appended when restrict=strict",
        aggregate
    )
}