Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

env-restorer

vandium-io413BSD-3-Clause1.0.0

Automatically snapshots and restores environment variables

environment, variable, snapshot, restorer, process.env

readme

Build Status npm version

env-restorer

Utility that snapshots the environment variables from process.env and can restore them on demand. Initially developed for testing vandium.

Features

  • Automatically snapshots environment variable state
  • Nested snapshots are allowed
  • No dependencies

Installation

Install via npm.

npm install env-restorer

Getting Started

A snapshot of the environment variables is created automatically when the library is loaded.

const envRestorer = require( 'env-restorer' );

// change environment variables
process.env.MY_SPECIAL_VALUE = '42';

envRestorer.restore();
// restore environment variables back to initial state (MY_SPECIAL_VALUE will no longer exist)

To create another snapshot of the environment variables state, simply call snapshot():

const envRestorer = require( 'env-restorer' );

// change environment variables
process.env.MY_SPECIAL_VALUE = '42';

const snapshot = envRestorer.snapshot();

// change environment variables
process.env.MY_SPECIAL_VALUE = '43';

snapshot.restore();
// process.env.MY_SPECIAL_VALUE will now equal '42'

envRestorer.restore();
// restore environment variables back to initial state (MY_SPECIAL_VALUE will no longer exist)

Feedback

We'd love to get feedback on how to make this tool better. Feel free to contact us at `feedback@vandium.io`

License

BSD-3-Clause

changelog

Change Log

1.0.0 (2016-05-15)

Initial Release