@mondora/env

env

A better way to retrieve environment variables in nodejs.

Install

npm install @mondora/env

Usage

import env from "@mondora/env";

export const REQUIRED = env("REQUIRED", { required: true });
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_PARSE", {
    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
  • 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

Returns

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

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.

Changelog

1.0.4 (September 6, 2017)

Initial release.

1.0.(0-3) (September 6, 2017 - bad npm publication with travis)