Crates.io | enveror |
lib.rs | enveror |
version | 0.1.8 |
source | src |
created_at | 2023-11-19 16:58:43.132807 |
updated_at | 2024-08-05 15:02:22.386423 |
description | A library to load environment variables into structs with serde |
homepage | |
repository | https://github.com/ysuzuki19/enveror-rs |
max_upload_size | |
id | 1041337 |
size | 15,985 |
Library for Structured Environment Variables
.
serde
in enveror
If you want to define following structure,
{
"STAGE": "dev",
"CLOUD": {
"API_KEY_ID": "hogehoge=hog",
"API_SECRET_KEY": "fug+;l[l;uw:er-0-63-096z,nxvcafuga",
"STORAGE": {
"IMAGES": "myimages"
}
},
"CORS_ORIGINS": ["http://localhost:3000", "", "https://enveror.example.com"],
"WORKER_COUNT": 4,
"TIMEOUT_SECONDS": 2.3,
"EMPTY_STRING": " ",
"SAMPLE": true,
"CONFIG": {
"FLAGS": [true, false, false, true],
"NUMBERS": [1, 2, 3, 4, 5, 6, 7, 8, 9]
}
}
You can set variable as following environment variables.
STAGE="dev"
CLOUD.API_KEY_ID="hogehoge=hog"
CLOUD.API_SECRET_KEY="fug+;l[l;uw:er\-0-63-096z,nxvcafuga"
CLOUD.STORAGE.IMAGES="myimages"
CORS_ORIGINS=["http://localhost:3000", "", "https://enveror.example.com"]
WORKER_COUNT=4
TIMEOUT_SECONDS=2.3
EMPTY_STRING=" "
SAMPLE=true
CONFIG.FLAGS=[true, false, false, true]
CONFIG.NUMBERS=[1, 2, 3, 4, 5, 6, 7, 8, 9]
The following is testing code for parsing and deserialization.
use std::path::PathBuf;
use serde::{Deserialize, Serialize};
#[derive(Debug, Serialize, Deserialize)]
#[serde(rename_all = "lowercase")]
enum Stage {
Dev,
Prod,
}
#[derive(Debug, Serialize, Deserialize)]
#[serde(rename_all = "UPPERCASE")]
struct EnverorConfig {
stage: Stage,
cloud: Cloud,
cors_origins: Vec<String>,
worker_count: u8,
timeout_seconds: f32,
empty_string: String,
sample: bool,
}
#[derive(Debug, Serialize, Deserialize)]
#[serde(rename_all = "UPPERCASE")]
struct Cloud {
api_key_id: String,
api_secret_key: String,
storage: CloudStorage,
}
#[derive(Debug, Serialize, Deserialize)]
#[serde(rename_all = "UPPERCASE")]
struct CloudStorage {
images: String,
}
extern crate enveror;
#[test]
fn parse_deserialize() -> Result<(), Box<dyn std::error::Error>> {
enveror::Enveror::new()
.ignore_default_config()
.path(PathBuf::from("./tests/case_enveror"))
.load()?
.construct::<EnverorConfig>()?;
Ok(())
}