Code Monkey home page Code Monkey logo

elm-constants's Introduction

elm-constants

Generate constant values in Elm from your environment

Based on a config file, this tool will generate an Elm file of environment variables so you don't have to pass them to Elm with flags and keep them around in your model.

Install

yarn add --dev elm-constants

or

npm install elm-constants --save-dev

Usage

Add a config file to the root of your project called elm-constants.json.

Populate it like this:

{
  "path": "./path/to/elm/dir",
  "moduleName": "Constants",
  "values": [
    ["SERVER_URL", "backendUrl"],
    "GOOGLE_API_KEY"
  ]
}

For the values field you can have either a regular string or an array with two values. If you specify a regular string, this tool will automatically convert it to a valid Elm variable name. In the case of GOOGLE_API_KEY, it would generate googleApiKey. If you're not happy with the generated name or just want to rename it anyways, you can specify an array where the first value is the environment variable and the second is the Elm name.

Then, in your pre-build step, run yarn elm-constants (or npx elm-constants) to generate an Elm file!

Based on the above config, you would get something like:

module Constants exposing (googleApiKey, serverUrl)


googleApiKey : String
googleApiKey =
    "def"


backendUrl : String
backendUrl =
    "abc"

CLI Options

Options:
  --version, -v     Print the installed version                  [boolean]
  --no-dotenv       Dont' use dotenv                             [boolean]
  --env-path, -p    Path to env file                             [string]
  --config, -c      Path to config file                          [string]
  --help, -h        Show help                                    [boolean]

Config Schema

The schema for the config file.

{ "path": : String
, "moduleName" : String
, "values" : [String, String] | String
}

Dotenv

This package automatically works with dotenv. By default this will look for an .env file at current working directory. Alternatively you may provide a path flag (--env-path) for a custom file such as --env-path=./env/.env.staging. If you run elm-constants in and NODE_ENV is not production, then this tool automatically loads that file.

If you want to turn this off, just pass --no-dotenv to elm-constants

Rationale

Have you ever been writing an Elm app and started off like this:

type alias Flags =
  { serverUrl : String
  , googleApiKey : String
  , ...
  }


init : Flags -> ( Model, Cmd Msg )
init flags =
  ( { severUrl = flags.severUrl, googleApiKey = flags.googleApiKey, ... }
  , fetch flags.serverUrl
  )

And if you're writing an SPA, you have to pass those flag down to every page:

type Msg
  = PageMsg Page.Msg
  
  
update : Msg -> Model -> ( Model, Cmd Msg )
update msg model = 
    case (msg, model.page) of
       (PageMsg subMsg, PageModel subModel) ->
            let
                (nextSubModel, nextSubMsg) =
                    Page.update model.serverUrl -- Pass serverUrl down to each page
                        subMsg
                        subModel
            in
            ( { model | page = PageModel nextSubModel }
            , nextSubMsg |> Cmd.map PageMsg
            )
        ...
      
view : Model -> Html Msg
view model =
    case model.page of
       PageModel subModel ->
           Page.view model.googleApiKey subModel -- Pass googleApiKey to each page 
       ...

I got tired of havng to keep these seemingly static pieces of data in the model and having to pass them everywhere. So I wrote a way to generate an Elm constants file based on your environment!

Thanks

Thanks to elm-graphql for making me think to use file generation to solve a problem.

elm-constants's People

Contributors

gustavoaz7 avatar mthadley avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

elm-constants's Issues

Empty environment variables are not supported

To reproduce:

.env:

BASE_PATH=

elm-constants.json:

{
  "path": "./src/",
  "moduleName": "Env",
  "values": [
    "BASE_PATH"
  ]
}

Run elm-constants.

Expected behavior:

Env.elm produced with basePath = "".

Actual behavior:

I couldn't find any of the environment variable you specified, so I have nothing to generate!

BASE_PATH="" of course does not change anything because it produces the same shell variable with the same shell value.

I guess the issue is here:

elm-constants/index.js

Lines 139 to 147 in bf6eefe

const envValue = process.env[envValueName];
if (envValue) {
return [
[elmName].concat(accExposing),
[toElmValue(elmName, envValue)].concat(accElmValue)
];
} else {
return acc;
}

There's a confusion here between falsy environment variables and those which are missing.

I think there's also a larger issue here which is that we shouldn't try to be "safe" against missing environment variables. Elm code cannot detect undefined variables, so if a variable is truly missing, we should probably error out immediately rather than let later compilation steps fail when the variable is not there.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.