neocrates 0.1.47

use serde::Deserialize;
use serde_yaml;
use std::env;
use std::fs::File;
use std::io::Read;
use std::path::{Path, PathBuf};

pub fn load_config_from_file<T, P>(path: P) -> Option<T>
where
    T: for<'de> Deserialize<'de>,
    P: AsRef<std::path::Path>,
{
    let mut file = File::open(path).ok()?;
    let mut contents = String::new();
    file.read_to_string(&mut contents).ok()?;
    serde_yaml::from_str(&contents).ok()
}

// Loads configuration from a specific YAML file path.
///
/// This function is similar to `load_config_from_file` but more explicitly accepts
/// a path parameter and provides better documentation. It is useful when you need
/// to load configuration from non-standard locations or specifically named files.
///
/// # Arguments
/// * `config_path` - The path to the configuration file to load.
///
/// # Returns
/// `Some(T)` if the configuration file is found and parsed successfully,
/// `None` otherwise.
///
/// # Example
/// ```
/// use serde::Deserialize;
/// use std::path::Path;
///
/// #[derive(Deserialize)]
/// struct AppConfig {
///     server_port: u16,
///     debug_mode: bool,
/// }
///
/// if let Some(config) = neocrates::helper::core::loader::load_named_config::<AppConfig>(Path::new("custom-config.yml")) {
///     println!("Server port: {}", config.server_port);
/// } else {
///     eprintln!("Failed to load configuration");
/// }
/// ```
pub fn load_named_config<T>(config_path: &Path) -> Option<T>
where
    T: for<'de> Deserialize<'de>,
{
    load_config_from_file(config_path)
}

/// Helper function to find a file by searching upwards from the current directory.
fn find_config_path(file_name: &str) -> Option<PathBuf> {
    let mut current_dir = env::current_dir().ok()?;
    loop {
        let file_path = current_dir.join(file_name);
        if file_path.exists() {
            return Some(file_path);
        }
        if !current_dir.pop() {
            break;
        }
    }
    None
}

/// Loads configuration from environment-specific or default YAML files.
///
/// This function searches for configuration files in the following order:
/// 1. `application.{ENV}.yml`
/// 2. `application.{ENV}.yaml`
/// 3. `config.{ENV}.yml`
/// 4. `config.{ENV}.yaml`
/// 5. `application.yml`
/// 6. `application.yaml`
/// 7. `config.yml`
/// 8. `config.yaml`
///
/// Where `ENV` is the value of the environment variable "ENV".
///
/// For each candidate filename, the function searches recursively upwards from the
/// current working directory to the root directory until the file is found.
///
/// # Returns
/// `Some(T)` if a valid configuration file is found and parsed successfully,
/// `None` otherwise.
///
/// # Example
/// ```
/// use serde::Deserialize;
///
/// #[derive(Deserialize)]
/// struct AppConfig {
///     server_port: u16,
///     debug_mode: bool,
/// }
///
/// // Set ENV variable (optional)
/// std::env::set_var("ENV", "production");
///
/// if let Some(config) = neocrates::helper::core::loader::load_config::<AppConfig>() {
///     println!("Server port: {}", config.server_port);
/// } else {
///     eprintln!("Failed to load configuration");
/// }
/// ```
pub fn load_config<T>() -> Option<T>
where
    T: for<'de> Deserialize<'de>,
{
    let env_var = env::var("ENV").ok();
    let mut candidates = Vec::new();

    if let Some(env) = env_var.as_deref() {
        if !env.is_empty() {
            candidates.push(format!("application.{}.yml", env));
            candidates.push(format!("application.{}.yaml", env));
            candidates.push(format!("config.{}.yml", env));
            candidates.push(format!("config.{}.yaml", env));
        }
    }

    candidates.push("application.yml".to_string());
    candidates.push("application.yaml".to_string());
    candidates.push("config.yml".to_string());
    candidates.push("config.yaml".to_string());

    for file_name in candidates {
        if let Some(path) = find_config_path(&file_name) {
            if let Some(config) = load_config_from_file::<T, _>(path) {
                return Some(config);
            }
        }
    }

    None
}