adeo / opp--core_env

NodeJS library transforms environment variables into JSON hierarchical structures.

@core/env

Why:

Because configuration of node.js application can be very painfull...

What:

This module transform environment variables into JSON hierarchical structures. Usage is very simple, just require it in top of you application. You can create .env file in root of you application for development and debug but don't do it in production.

Example

Environment:

array_deep=(json)[]
array_deep_0=(boolean)0
array_deep_1=(boolean)1

Code:

const env = require('@core/env');
console.log(env);

Result:

{
    "array": {
        "deep": [
            false,
            true
        ]
    }
}

Supported types

Environment:

string=(string)text
number=(number)1
boolean=(boolean)false
json=(json){"json":true}
regexp=(regexp)/\d.test?/
symbol=(symbol)mySymbol
null=(null)
NaN=(NaN)
undefined=(undefined)
Infinity=(Infinity)1
-Infinity=(Infinity)-1
file_buff=(file)/path/to/file
file_utf8=(file-utf8)/path/to/file

Result:

{
  string:      'text',
  number:      1,
  boolean:     false,
  json:        { json: true },
  regexp:      /\d.test?/,
  symbol:      Symbol(mySymbol),
  null:        null,
  NaN:         NaN,
  undefined:   undefined,
  Infinity:    Infinity,
  '-Infinity': -Infinity,
  file: { 
     buff: <Buffer 73 74 72 69 6e 67 3d ... >,
     utf8: 'string=(string)...',
  }
}

Quote

Environment:

quote1=!(number)1
quote2=!!(boolean)true

Result:

{
  quote1: "(number)1",
  quote2: "!(boolean)true"
}

Templates

Environment:

string_for_replace=string1
replace1=string2+${string.for.replace}
replace2=${string.for.replace}/test/${replace1}
replace_quote=!${replace2}/test

Result:

{
  string: { for: { replace: 'string1' } },
  replace1: 'string2+string1',
  replace2: 'string1/test/string2+string1',
  replace: { quote: '${replace2}/test' }
}

Maintainers

Leonid Levkin < [e-mail] >