npm: possibly marvellous

    env-wrapper

    1.0.7 • Public • Published

    env-wrapper

    A simple js wrapper around environmental variables, to allow upfront loading, checking, and defaulting of required variables

    Installation

    From the terminal, install the package from npm:

    npm i env-wrapper
    

    From within your code, import the library:

    const env = require('env-wrapper')

    Load environment from a file

    Optionally read key-value pairs from a file and insert them into the environment. If a filename is not given, '.env' in the base directory is used. If either the assumed or named file does not exist, no error is issued. An error will be issued if the file exists but and error in encountered. Note that this is a convenience method, and env-wrapper will readily handle any environment variables inserted through other means.

    env.load()
    env.load('development.env')

    Example .env file:

    PORT=1234
    DATABASE_URL=db://localhost
    

    Read and enforce that a required environment property is present

    The original intent of this library was to simply ensure fail-fast behavior if a required environment variable had not been specified, so that we know when the application loads instead of 3am next Tuesday when actually uses it.

    const databaseUrl = env.require('DATABASE_URL')

    Read and default an optional environment property

    If the requested environment property cannot be found, and a default value is specified, that value will be inserted into the environment, and then returned as the requested value. Because the environment can be altered by this form, this can also be used as a shortcut for conditionally priming the environment for later use.

    const port = env.require('PORT', 3000)

    Simple getter / setter

    The library also provides a simple getter and setter that can be used for unconditionally inserting a value into the environment, or retrieving a value from the environment. Unlike require above, get will either return the found value, or undefined if a value is not found.

    env.set('my-key', 'abc')
    const key = env.get('my-key')

    Testing

    There are several Jasmine-based unit tests that can be run from the terminal if desired:

    npm test
    

    Release History

    Version Changes
    1.0.7 Documentation revamp
    1.0.6 Fix to handle .env file values with embedded '=' symbols
    1.0.5 Changed load to sync operation; Fix to path calculations
    1.0.4 Added load method; moved tests to Jasmine
    1.0.3 Require method returns value
    1.0.2 Fix for error message unit test
    1.0.1 Added set method; fixed package.json NPM error
    1.0.0 Initial Release

    License

    This work is released under the MIT license - see the LICENSE file for details

    Install

    npm i env-wrapper

    DownloadsWeekly Downloads

    0

    Version

    1.0.7

    License

    MIT

    Unpacked Size

    6.18 kB

    Total Files

    4

    Last publish

    Collaborators

    • mike-feldmeier