@mondora/env
    TypeScript icon, indicating that this package has built-in type declarations

    1.3.0 • Public • Published

    Package Version Build Status Coverage Status Dependencies Status Dev Dependencies Status

    env

    A better way to retrieve environment variables in nodejs.

    Features:

    • set defaults for environment variables
    • set defaults for environment variables only when NODE_ENV != production
    • throw an error if a required environment variable is not set
    • parse environment variables before returning them (eg, parse a base64 string into a Buffer)
    • get environment variables from a different source than process.env
    • for TypeScript, get the correct type information for the variable

    Install

    yarn add @mondora/env

    Usage

    import env from "@mondora/env";
     
    export const REQUIRED = env("REQUIRED", { required: true });
    export const REQUIRED_ONLY_IN_PRODUCTION = env("REQUIRED_ONLY_IN_PRODUCTION", {
      required: true,
      nonProductionDefault: "DEFAULT"
    });
    export const NON_REQUIRED = env("NON_REQUIRED");
    export const WITH_DEFAULT = env("WITH_DEFAULT", { default: "DEFAULT" });
    // PARSED is a Buffer
    export const PARSED = env("TO_BE_PARSED", {
      required: true,
      parse: value => Buffer.from(value)
    });

    API

    env(name, options)

    Retrieves the specified environment variable.

    Arguments
    • name string required: name of the environment variable to retrieve
    • options object:
      • required boolean: marks the variable as required. Ie, if the variable is not set, an error is thrown
      • nonProductionDefault boolean: makes a required variable only required when NODE_ENV == production, while giving it a default value otherwise
      • default string: a default value for the variable if it's not set
      • parse function: a function to transform the value of the variable (a string) into whatever before it's returned by env. The function is called only when a value or a default value for the variable was set
    Returns

    The value of the environment variable, parsed by the options.parse function if specified.

    setInputSource(inputSource)

    Sets the input source from which environment variables are retrieved (the default input source is process.env).

    Arguments
    • inputSource (string, string) map required: custom input source
    Returns

    Nothing.

    Develop

    To get started developing the library, clone the project and install dependencies with yarn. Then you can either:

    • yarn test: runs tests
    • yarn test --watch: runs tests, re-runs them on code changes
    • yarn coverage: runs tests, measures code coverage
    • yarn lint: runs code linters (prettier + tslint)
    • yarn prettify: formats code with prettier
    • yarn compile: compiles the project

    NOTE: this project uses prettier to enforce code formatting. Installing the prettier extension for your editor of choice is highly recommended.

    Release

    • Run npm version x.x.x to bump a new version of the package. The command will set the specified version number in package.json, commit the change, tag the commit with vx.x.x

    • Push the commit and the tag to github: git push --tags origin master

    • If linting and automated tests pass, the module will automatically be published to npm

    Note: you can use convenience commands npm version major, npm version minor, npm version patch to bump the consecutive major / minor / patch version of the package.

    Keywords

    none

    Install

    npm i @mondora/env

    DownloadsWeekly Downloads

    58

    Version

    1.3.0

    License

    MIT

    Unpacked Size

    11 kB

    Total Files

    7

    Last publish

    Collaborators

    • mondora-npm-bot