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

serde-envfile

♻️ Deserialize and serialize environment variables

1 unstable release

0.1.0 Oct 27, 2023

#942 in Encoding

Download history 10/week @ 2023-12-17 13/week @ 2024-01-28 7/week @ 2024-02-11 34/week @ 2024-02-18 32/week @ 2024-02-25 5/week @ 2024-03-03 23/week @ 2024-03-10 1/week @ 2024-03-17 28/week @ 2024-03-31

53 downloads per month

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