oxide-framework-core 0.1.0

Core runtime and framework logic for the Oxide web framework.
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

use serde::Deserialize;
use std::path::Path;

#[derive(Debug, Clone, Deserialize)]
pub struct AppConfig {
    #[serde(default = "default_host")]
    pub host: String,
    #[serde(default = "default_port")]
    pub port: u16,
    #[serde(default)]
    pub app_name: String,
}

fn default_host() -> String {
    "127.0.0.1".to_string()
}

fn default_port() -> u16 {
    3000
}

impl Default for AppConfig {
    fn default() -> Self {
        Self {
            host: default_host(),
            port: default_port(),
            app_name: String::from("oxide-app"),
        }
    }
}

impl AppConfig {
    /// Load config from a YAML file, then overlay any matching environment
    /// variables. Missing file is not an error — defaults are used instead.
    pub fn load(path: Option<&str>) -> Self {
        let mut cfg = match path {
            Some(p) if Path::new(p).exists() => {
                let contents = std::fs::read_to_string(p)
                    .unwrap_or_else(|e| panic!("failed to read config file {p}: {e}"));
                serde_yaml::from_str(&contents)
                    .unwrap_or_else(|e| panic!("failed to parse config file {p}: {e}"))
            }
            _ => Self::default(),
        };

        // Environment variable overrides (OXIDE_ prefix)
        if let Ok(v) = std::env::var("OXIDE_HOST") {
            cfg.host = v;
        }
        if let Ok(v) = std::env::var("OXIDE_PORT") {
            if let Ok(port) = v.parse::<u16>() {
                cfg.port = port;
            }
        }
        if let Ok(v) = std::env::var("OXIDE_APP_NAME") {
            cfg.app_name = v;
        }

        cfg
    }
}