from-env: Provides a generic way to construct values from environment variables.

[ configuration, library, mit ] [ Propose Tags ] [ Report a vulnerability ]

This package exposes a class FromEnv that works with GHC.Generics to provide a generic way to construct values from environment variables.

In many applications you'll have a configuration object holding a connection string to your database, the url of an S3 bucket, you name it. It can be tedious to have to construct this configuration object manually. With this package, you just derive Generic and then create an instance of FromEnv for your configuration type and you're done. Just call fromEnv and you got your configuration.

import System.Environment.FromEnv
import GHC.Generics
newtype Config = Config { configS3BucketUrl :: String } deriving Generic
instance FromEnv Config
config <- fromEnv

The default behaviour is to convert field names like configS3BucketUrl into environment variables like CONFIG_S3_BUCKET_URL, but it can be overriden by providing a custom instance of FromEnv.

[Skip to Readme]

Modules

[Last Documentation]

System
- Environment
  - System.Environment.FromEnv
    - System.Environment.FromEnv.TryParse

Downloads

from-env-0.1.0.0.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

No current members of group

For package maintainers and hackage trustees

edit package information

Candidates

0.1.0.0

Versions [RSS]	0.1.0.0, 0.1.1.0, 0.1.2.0, 0.1.3.0
Dependencies	base (>=4.16.4.0 && <4.17), casing (>=0.1.4 && <0.2), text (>=1.2.5 && <1.3) [details]
License	MIT
Copyright	Alexander Goussas 2023
Author	Alexander Goussas
Maintainer	goussasalexander@gmail.com
Category	Configuration
Bug tracker	https://github.com/aloussase/from-env/issues
Source repo	head: git clone https://github.com/aloussase/from-env.git
Uploaded	by aloussase at 2023-07-30T20:19:50Z
Distributions
Downloads	199 total (8 in the last 30 days)
Rating	(no votes yet) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs not available [build log] All reported builds failed as of 2023-07-30 [all 2 reports]

Readme for from-env-0.1.0.0

[back to package description]

from-env

Haskell package to construct datatypes from environment variables.

In many applications you'll have an .env file or set environment variables some way. These environment variables usually contain configuration data such as database connection urls, secrets; etc.

Next, you make a configuration data type to hold this variables so your application can access them. Normally you'd have a bunch of calls to lookupEnv in order to build your data type. This is tedious and error-prone. Thankfully, in Haskell we can do better!

import GHC.Generics
import System.Environment.FromEnv

data Config = Config
    { configDbUrl     :: !String
    , configApiSecret :: !String
    }
    deriving Generic

instance FromEnv Config

main = do
    config <- fromEnv
    -- do something with config

And that's it! By deriving Generic you can now create an instance of FromEnv for free. Check out the haddocks for more.

License

MIT