node package manager


environmentize (e12e)

Utilities for handling value and behavior differences between environments.

Build Status NPM version Dependency Status Coverage Status Code Climate

environmentize helps you to set different values for each environment your code runs in. For example, you probably have different database settings for each environment or you probably want to use an analytics code only in production. environmentize helps you getting it done:

config.DB_HOST = e12e({
  production : '123.456.789.3',
  staging : '123.456.789.4'
}, '');
config.ANALYTICS_ID = e12e.production('X-12345-6', null);

Or maybe there's some code you want to run only while in development:

e12e.development(function () {
  // This will run only if you are in development. 
  console.log('This is the development environment.');


Install from NPM:

npm install environmentize


Require it:

var e12e = require('environmentize');

Get the current environment:

e12e(); // 'development' 
// or 
e12e.env; // 'development' 

environmentize will use the NODE_ENV environment variable to get the environment in which the code is running. You shouldn't ever need to change e12e.env yourself.

By default, environmentize sets five environments: 'development', 'test', 'integration', 'staging' and 'production'. If you have a different environment structure, you can change them using e12e.setup().

NOTE: The following examples assume we are in the 'development' environment, unless stated otherwise.

Check if the code is being run in a given environment:

e12e('development'); // true 
e12e('integration'); // false 
// You may use an array of environments as well 
e12e(['test', 'development']); // true 
e12e(['staging', 'production']); // false 

Get a value from an environment-value map:

  development : 'foo',
  production : 'bar'
}); // 'foo' 
  integration : 'foo',
  production : 'bar'
}); // undefined 
// You can set a fallback value 
  integration : 'foo',
  production : 'bar'
}, 'baz'); // 'baz' 

Get a value for a specific environment:

e12e('development', 'foo'); // 'foo' 
e12e('integration', 'foo'); // undefined 
// With a fallback 
e12e('integration', 'foo', 'bar'); // 'bar' 
// This works with multiple environments too 
e12e(['test', 'development'], 'foo'); // 'foo' 
e12e(['staging', 'production'], 'foo'); // undefined 
e12e(['staging', 'production'], 'foo', 'bar'); // 'bar' 

Values may be functions, in which case they are called without arguments and the returned value is used:

e12e('development', function () { return 'foo'; }); // 'foo' 
// Works for fallbacks too 
e12e('integration', function () { return 'foo'; }, function () { return 'bar'; }); // 'bar' 
// And for values in an environment-value map 
  development : function () { return 'foo'; }
}); // 'foo' 

This way you can run a piece of code only in certain environments:

e12e('development', function () {
  // Do something that should only be done during development. 
  console.log('This is the development environment');

Environmentize also sets a method for each environment, which avoids the need for the first argument in some cases:

e12e.development('foo'); // 'foo' 
e12e.integration('foo', 'bar'); // 'bar' 

This might be handy if you need to run some code only in a specific environment:

e12e.production(function () {
  // This code will run only in production. 


You can use your own environment definitions using e12e.setup():

  environments : ['dev', 'ci', 'stg', 'prod'],
  defaultEnv : 'dev'
});'foo'); // 'foo''foo', 'bar'); // 'bar' 
// Original environment methods are removed 
e12e.development('foo'); // throws error 


Environmentize's tests are written in mocha and can be run with:

npm test


Feel free to submit any patches or report any issues. I'll do my best to check them as quick as possible (in a few days, usually). When submitting a patch, please add your name and link to the author section below.

I would greatly appreciate if someone could double check the tests. I'm sure there's plenty of room for improvements there.

Issues and patches regarding grammar errors in code comments and docs are welcome as well. : )


Created by Mathias Kretschek (mkretschek).