environment-variable-service

A service to get environment variables in a more consistent and testable way.


Install

- If using yarn, run yarn add environment-variable-service
- If using npm, run npm install environment-variable-service

Usage

``
import { envVarService } from 'environment-variable-service';

get env var; if doesn't exist, return undefined

`

EnvironmentVariableService

Creates the service

`js
// via import (this creates the service already)
import { envVarService } from 'environment-variable-service';

// or create directly
import { EnvironmentVariableService } from 'environment-variable-service';
const envVarService = new EnvironmentVariableService();
`

getEnvironmentVariable or get

Gets the requested environment variable returning undefined if doesn't exist

`js
const var1 = envVarService.getEnvironmentVariable('ENV_VAR_1');
// or get
const var1 = envVarService.get('ENV_VAR_1');
`

getEnvironmentVariables or getAll

Gets the requested list of environment variables returning undefined for any that don't exist

`js
const [var1, var2, var3] = envVarService.getEnvironmentVariables(['ENV_VAR_1', 'ENV_VAR_2', 'ENV_VAR_3']);
// or getAll
const [var1, var2, var3] = envVarService.getAll(['ENV_VAR_1', 'ENV_VAR_2', 'ENV_VAR_3']);
`

getEnvironmentVariableWithDefault or get with a default

Gets the requested environment variable returning the default value if doesn't exist

`js
const var2 = envVarService.getEnvironmentVariableWithDefault('ENV_VAR_2', 'foobar');
// or get
const var2 = envVarService.get('ENV_VAR_2', 'foobar');
`

mustGetEnvironmentVariable or mustGet

Gets the requested environment variable throwing a Missing environment variable: ${variableName} error if doesn't exist

`js
const var3 = envVarService.mustGetEnvironmentVariable('ENV_VAR_3');
// or mustGet
const var3 = envVarService.mustGet('ENV_VAR_3');
`

mustGetEnvironmentVariables or mustGetAll

Gets the list of requested environment variables throwing a Missing environment variable: ${variableName} error if one doesn't exist (all must exist otherwise, will throw error for first var that doesn't exist)

`js
const [var1, var2, var3] = envVarService.mustGetEnvironmentVariables(['ENV_VAR_1', 'ENV_VAR_2', 'ENV_VAR_3']);
// or mustGet
const [var1, var2, var3] = envVarService.mustGetAll(['ENV_VAR_1', 'ENV_VAR_2', 'ENV_VAR_3']);
``

Publishing

- Make changes
- Create git commit using feat: for new features or fix: for updates
- Run yarn release:major, release:minor, release:patch for appropriate update (this will bump version number appropriately)
- Make PR back to main
- Upon merge to main, it will kick off action that will publish to npm