konfik 0.1.2

config parser
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
87
88
89
90
91
92
93
94
95

// SPDX-License-Identifier: MIT
// Copyright (c) 2025 kingananas20

mod load;
mod load_cli;
mod load_env;
mod load_file;
mod parse_env;

pub use load_file::ParseFileFormatError;

use crate::Error;
use std::{
    fmt::Debug,
    path::{Path, PathBuf},
};

/// Configuration loader with clean, composable API
pub struct ConfigLoader {
    env_prefix: Option<String>,
    config_files: Vec<PathBuf>,
    cli_enabled: bool,
    #[expect(clippy::type_complexity)]
    validation: Option<Box<dyn Fn(&serde_json::Value) -> Result<(), Error>>>,
}

impl Debug for ConfigLoader {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("ConfigLoader")
            .field("env_prefix", &self.env_prefix)
            .field("config_files", &self.config_files)
            .field("cli_enabled", &self.cli_enabled)
            .field(
                "validation",
                &"Option<Box<dyn Fn(&serde_json::Value) -> Result<(), Error>>>",
            )
            .finish()
    }
}

impl Default for ConfigLoader {
    fn default() -> Self {
        Self {
            env_prefix: None,
            config_files: vec![
                "config.json".into(),
                "config.yaml".into(),
                "config.toml".into(),
            ],
            cli_enabled: false,
            validation: None,
        }
    }
}

impl ConfigLoader {
    /// Set environment variable prefix
    #[must_use]
    pub fn with_env_prefix(mut self, prefix: impl Into<String>) -> Self {
        self.env_prefix = Some(prefix.into());
        self
    }

    /// Add a config file to check (in order)
    #[must_use]
    pub fn with_config_file<P: AsRef<Path>>(mut self, path: P) -> Self {
        self.config_files.push(path.as_ref().to_path_buf());
        self
    }

    /// Clear default config files and set specific ones
    #[must_use]
    pub fn with_config_files<P: AsRef<Path>>(mut self, files: Vec<P>) -> Self {
        self.config_files
            .extend(files.iter().map(|p| p.as_ref().to_path_buf()));
        self
    }

    /// Enable CLI argument parsing
    #[must_use]
    pub const fn with_cli(mut self) -> Self {
        self.cli_enabled = true;
        self
    }

    /// Add validation function
    #[must_use]
    pub fn with_validation<F>(mut self, f: F) -> Self
    where
        F: Fn(&serde_json::Value) -> Result<(), Error> + 'static,
    {
        self.validation = Some(Box::new(f));
        self
    }
}