#env #environment

enve

it helps you work with environment variables and convert it to any type using only type annotations

4 releases (breaking)

Uses new Rust 2021

0.3.0 Jul 28, 2022
0.2.0 Jul 27, 2022
0.1.0 Jul 24, 2022
0.0.0 Jul 22, 2022

#24 in #environment

Download history 238/week @ 2022-07-21 293/week @ 2022-07-28 401/week @ 2022-08-04

936 downloads per month

MIT license

18KB
269 lines

enve

Crates.io docs.rs GitHub Workflow Status The MSRV

[dependencies]
enve = "0.3"

enve helps you work with environment variables and convert it to any type using only type annotations.

All standard environment variable types are included, but enve under the hood uses estring, so you can easily create your own type.

Documentation

Look at the examples to see the power!

Usage

Basic

fn main() -> Result<(), enve::Error> {
    enve::sset("E", "10");

    let res: f32 = enve::get("E")?;

    println!("result: {}", res);

    Ok(())
}

You can use predefined structs like SepVec if you enable structs feature.

Note: You can use custom types as annotations! Just implement ParseFragment.

use enve::SepVec;

type PlusVec<T> = SepVec<T, '+'>;
type MulVec<T> = SepVec<T, '*'>;

fn main() -> Result<(), enve::Error> {
    enve::sset("E", "10+5*2+3");

    let res: f32 = enve::get::<PlusVec<MulVec<f32>>>("E")
        .unwrap()
        .iter()
        .map(|m| m.iter().product::<f32>())
        .sum::<f32>();

    assert_eq!(res, 23.0);

    Ok(())
}

You can also use predefined aggregators if you enable aggs feature.

use enve::{SepVec, Product, Sum, estring::Aggregate};

type PlusVec<T> = SepVec<T, '+'>;
type MulVec<T> = SepVec<T, '*'>;

fn main() -> Result<(), enve::Error> {
    enve::sset("E", "10+5*2+3");

    let res: f32 = enve::get::<Sum<PlusVec<Product<MulVec<f32>>>>>("E")?
        .agg();

    assert_eq!(res, 23.0);

    Ok(())
}

Contact Us

Join us in:

Matrix

License

MIT. See LICENSE to see the full text.

Contributors

pleshevskiy (Dmitriy Pleshevskiy) – creator, maintainer.

Dependencies

~41KB