Load environment variables from a file.
|LTS Haskell 20.23:||0.2.1.0|
|Stackage Nightly 2023-06-04:||0.2.1.0|
|Latest on Hackage:||0.2.1.0|
Module documentation for 0.2.1.0
This is effectively a port of dotenv, whose README explains it best:
Storing configuration in the environment is one of the tenets of a twelve-factor app. Anything that is likely to change between deployment environments–such as resource handles for databases or credentials for external services–should be extracted from the code into environment variables.
But it is not always practical to set environment variables on development machines or continuous integration servers where multiple projects are run. dotenv loads variables from a .env file into ENV when the environment is bootstrapped.
This library exposes functions for doing just that.
import LoadEnv import System.Environment (lookupEnv) main :: IO () main = do loadEnv print =<< lookupEnv "FOO"
% cat .env FOO=bar % runhaskell main.hs Just "bar"
Development & Test
stack setup stack build --pedantic --test
Don’t override values already set in the environment
Given a hypothetical program
load-env, which uses one of our
FOO=bar load-env <<EOM FOO=bat EOM
load-envran. But now, it will see
barand leave it.
This is better behavior under the assumption that a
.envfile is meant to specify defaults in the case of nothing explicit. When there are explicit values in the environment, it’s most likely that our user indeed wants them respected.
- Allow lower-case characters in variable names @denibertovic
- Packaging and documentation updates
- Traverse up parent directories to find the
- Packaging updates
- Parse variables names more strictly
- Don’t fail on an empty file
- Ignore any invalid lines, not specifically things that look like comments
- Don’t throw an exception if the
.envfile is missing
- Variable names can contain underscores
- Drop support for GHC < 7.8