env-vars-config 1.0.0

A simple lib for configuring your applications via environment variables
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

env-vars-config
===

A simple lib for configuring your applications via environment variables.

[![Build status](https://img.shields.io/github/actions/workflow/status/NikSneMC/env-vars-config/ci.yml?branch=master)](https://github.com/NikSneMC/env-vars-config/actions)
[![Latest version](https://img.shields.io/crates/v/env-vars-config.svg)](https://crates.io/crates/env-vars-config)
[![Documentation](https://docs.rs/env-vars-config/badge.svg)](https://docs.rs/env-vars-config)
![License](https://img.shields.io/crates/l/env-vars-config.svg)

* [`env-vars-config` documentation](https://docs.rs/env-vars-config)

## Minimum supported `rustc`

`1.80.0+`

This version is explicitly tested in CI and may be bumped in any release as needed. Maintaining compatibility with older compilers is a priority though, so the bar for bumping the minimum supported version is set very high. Any changes to the supported minimum version will be called out in the release notes.

## Usage

```toml
[dependencies]
env-vars-config = "1.0"
```

```rust
use std::{net::SocketAddr, str::FromStr as _};

use env_vars_config::{env_vars_config, set_env_only};

env_vars_config! {
    SERVER_ADDRESS: SocketAddr = SocketAddr::from_str("0.0.0.0:8080").expect("this is a valid SocketAddr"),
    WORKER_COUNT: i32 = 32,
    OTEL_SERVICE_NAME: String = "test-service",
}

fn main() {
    config::init();

    println!("server address: {}", config::SERVER_ADDRESS.clone());
    println!("worker count: {}", *config::WORKER_COUNT);
    println!("otel service name: {}", config::OTEL_SERVICE_NAME.clone());

    unsafe {
        use config::OTEL_SERVICE_NAME;
        set_env_only!(OTEL_SERVICE_NAME);
    }

    println!(
        "otel service name (from env): {}",
        std::env::var("OTEL_SERVICE_NAME").unwrap()
    );

    assert!(!config::check_values());
}

```