gritshield 0.1.0

A security-first, high-performance micro-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

use colored::*;
use std::sync::Once;

static INIT_ENV: Once = Once::new();

/// Automatically initializes the .env configuration system exactly once on boot.
/// Subsequent calls bypass the disk completely for optimal memory speeds.
pub fn initialize_env() {
    INIT_ENV.call_once(|| {
        if dotenvy::dotenv().is_ok() {
            println!(
                "{}",
                "[CONFIG] Successfully loaded .env configurations into memory."
                    .bold()
                    .green()
            );
        } else {
            println!(
                "{}",
                "[CONFIG] No .env file detected. Falling back to system environment variables."
                    .bold()
                    .yellow()
            );
        }
    });
}

/// An environment variable getter with strict hierarchical system lookups and defaults.
pub fn get_env(key: &str, default: &str) -> String {
    // Ensure the initialization has run
    initialize_env();

    // Query process memory. std::env::var automatically checks BOTH:
    //    a) Values injected via dotenvy from a local file
    //    b) Actual native OS system variables (e.g. DATABASE_URL set via bash/docker env flags)
    match std::env::var(key) {
        Ok(val) => val, // Found in file or OS
        Err(_) => {
            // fallback to default
            default.to_string()
        }
    }
}