#env-var #parser #variables #environment

rust-decouple

A simple library to ease the process of parsing environment variables

5 unstable releases

0.3.0 Sep 22, 2024
0.2.0 Aug 7, 2024
0.1.2 Aug 5, 2024
0.1.1 Aug 5, 2024
0.1.0 Aug 5, 2024

#219 in Configuration

Download history 326/week @ 2024-08-05 2/week @ 2024-08-12 169/week @ 2024-09-16 22/week @ 2024-09-23 21/week @ 2024-09-30 5/week @ 2024-10-07

348 downloads per month

MIT license

11KB
127 lines

Rust-Decouple

Rust decouple is a long term project that aims to mimic the functionality of the python-decouple library

Due to the nature of the Rust language, the library will be implemented in a different way, but the goal is to provide a similar functionality. So far, the library is in a very early stage of development and is not ready for use.

The benefits of the rust version is that the cast is automatically done by the library, so you don't have to worry about it.

Usage

Basic usage

The most basic usage of the library is to define a struct with the variables you want to decouple and then call the parse method on it. The library will automatically try to parse the environment variables and return a struct with the values.

use rust_decouple::Decouple;

#[derive(Decouple)]
struct EnvVars {
    api_key: String,
}

fn main() {
    let constants = match EnvVars::parse() {
        Ok(v) => v,
        Err(e) => panic!("Error at parsing environment variables. Error: {e}"),
    };

    println!("My secret API KEY value is: {}", constants.api_key)
}

If you have not set the environment variable API_KEY, this example program will panic with the message

Error at parsing environment variables. Error: Couldn't find variable `API_KEY`
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

Once you set the environment variable, the program will print the value of the variable. For instance, if you set the variable API_KEY to 123456, the output will be:

My secret API KEY value is 123456

Note that this crate does not provide a way to set environment variables, you should set them before running your program, and as you might have noted, the library will look for the environment variable with the same name as the struct field in uppercase.

Advanced usage

Simple default values

The library also provides a way to set default values for the variables but not using procedural macros in the current version.

use rust_decouple::core::Environment;

fn main() {
    let api_key = Environment::from("API_KEY", Some("sample_api_key".to_string()));

    println!("My secret API KEY value is: {:?}", api_key)
}

In this example, the library will look for the environment variable API_KEY and if it is not set, it will use the default value sample_api_key.

One possible output of this program will be:

My secret API KEY value is: Ok("sample_api_key")

The derive macro is based in this implementation, so anything you can do with the Decouple derive macro, you can do with the Environment struct.

Vector environment variables

The library also provides a way to parse environment variables as vectors. The library will look for the environment variable with the same name as the struct field in uppercase and will split the value by commas.

use rust_decouple::Decouple;

#[derive(Decouple)]
struct EnvVars {
    api_keys: Vec<String>,
}

fn main() {
    let constants = match EnvVars::parse() {
        Ok(v) => v,
        Err(e) => panic!("Error at parsing environment variables. Error: {e}"),
    };

    println!("My secret API KEYS values are: {:?}", constants.api_keys);
}

If you set the environment variable API_KEYS to 123456,7891011, the output will be:

My secret API KEYS values are: ["123456", "7891011"]

And you can do the same with the VecEnvironment struct:

use rust_decouple::core::VecEnvironment;

fn main() {
    let api_keys = VecEnvironment::from("API_KEYS", Some(vec!["sample_api_key".to_string()]));
    println!("My secret API KEYS values are: {:?}", api_keys);
}

And the output will be:

My secret API KEYS values are: Ok(["sample_api_key"])

Dependencies

~105KB