envigil 0.3.0

Keep vigil over your environment — load, parse, and validate env vars with zero dependencies.
Documentation
//! Builder API — no features required.
//!
//! Run: cargo run --example basic

use envigil::validate;
use envigil::{EnvSource, VarBuilder};
use std::time::Duration;

fn main() -> Result<(), envigil::Error> {
    let cfg = EnvSource::new()
        .prefix("APP_")
        .declare(
            VarBuilder::new("PORT", |v| v.parse::<u16>().map_err(|e| e.to_string()))
                .default(8080)
                .validate(validate::range(1..=65535)),
        )
        .declare(VarBuilder::new("HOST", |v| Ok(v.to_owned())).default("127.0.0.1".to_owned()))
        .declare(
            VarBuilder::new("TIMEOUT_SECS", envigil::parse::secs).default(Duration::from_secs(30)),
        )
        .declare(
            VarBuilder::new("DATABASE_URL", |v| Ok(v.to_owned()))
                .required()
                .secret(),
        )
        .load()?;

    let port = cfg.get::<u16>("APP_PORT")?;
    let host = cfg.get::<String>("APP_HOST")?;
    let timeout = cfg.get::<Duration>("APP_TIMEOUT_SECS")?;
    let db_url = cfg.get::<envigil::Secret<String>>("APP_DATABASE_URL")?;

    println!("host:    {host}");
    println!("port:    {port}");
    println!("timeout: {timeout:?}");
    println!("db:      {db_url}"); // prints [REDACTED]

    Ok(())
}