dotenv-flow

Crates.iodotenv-flow
lib.rsdotenv-flow
version0.16.2
sourcesrc
created_at2023-05-01 12:29:31.698802
updated_at2023-11-16 10:58:49.144986
descriptionA `dotenv-flow` implementation for Rust
homepagehttps://github.com/cdellacqua/dotenv-flow.rs
repositoryhttps://github.com/cdellacqua/dotenv-flow.rs
max_upload_size
id853364
size53,860
Carlo Dell'Acqua (cdellacqua)

documentation

README

Crates.io

dotenv-flow.rs

A fork of dotenv-rs that adds support for the popular dotenv-flow loading strategy.

The dotenv-flow strategy works as follows:

  • if a DOTENV_ENV environment variable is set, load .env.{DOTENV_ENV}.local (e.g. .env.staging.local)
  • load .env.local
  • if a DOTENV_ENV environment variable is set, load .env.{DOTENV_ENV} (e.g. .env.staging)
  • load .env

Each step will only load variables that are not already present in the environment, so for example variables in the .env.{DOTENV_ENV}.local file will have the highest priority, followed .env.local and so on.

Breaking in 0.16.0

  • env.{DOTENV_ENV}.local is now loaded before .env.local

HowTo

Installation

cargo add dotenv-flow

Usage

To use this package, add the following line to your main function to load the environment variables from available .env.* files:

fn main() {
  dotenv_flow::dotenv_flow().ok();
}

Tests

To test this project, make sure you pass --test-threads=1 to cargo test, e.g.

cargo test -- --test-threads=1

This is necessary because cargo test runs tests in multiple threads by default, but environment variables are process-globals, therefore we need to limit concurrency to avoid race conditions.

Commit count: 241

cargo fmt