#env-var #serialization #deserialize #env #serde #config-file

serde-envfile

♻️ Deserialize and serialize environment variables

1 unstable release

0.1.0 Oct 27, 2023

#1065 in Encoding

Download history 28/week @ 2024-04-01 13/week @ 2024-04-08 10/week @ 2024-04-22 34/week @ 2024-04-29 105/week @ 2024-05-06 26/week @ 2024-05-13 55/week @ 2024-05-20 34/week @ 2024-05-27 42/week @ 2024-06-03 126/week @ 2024-06-10 158/week @ 2024-06-17 208/week @ 2024-06-24 17/week @ 2024-07-01 297/week @ 2024-07-08

688 downloads per month
Used in 2 crates

MIT OR Apache-2.0 OR EUPL-1.2

35KB
952 lines

serde-envfile

Built ontop the dotenvy and envy crates, serde-envfile supports both the serialization and the deserialization of environment variables from or to files (from_file, to_file), strings (from_str, to_string), or the environment of the application (from_env, to_env).

Install ☁️

Extend your Cargo.toml configuration file to include serde-envfile as a dependency or install the package with the Cargo package manager.

cargo add serde-envfile

Use 🔨

use serde::{Deserialize, Serialize};
use serde_envfile::{Error, from_str, to_string};

#[derive(Debug, Deserialize, Serialize)]
struct Test {
    hello: String,
}

fn main() -> Result<(), Error> {
    let env = "HELLO=\"WORLD\"";
    let test: Test = from_str(env)?;
    let env = to_string(&test)?;

    println!("{}", env);

    Ok(())
}

Introducing the Value type, serde-envfile, provides a more flexible approach to working with environment variables.

use serde_envfile::{to_string, Error, Value};

fn main() -> Result<(), Error> {
    let mut env = Value::new();
    env.insert("hello".into(), "world".into());
    let env = to_string(&env)?;

    println!("{}", env);

    Ok(())
}

Dependencies

~2–2.8MB
~48K SLoC