envcfg

envcfg

envcfg is an environment aware configuration module. It is inspired by settings and cfg.

It can load configurations from json files, modules or just plain objects. Do note that when loading from disk readFileSync or require will be used.

Install

npm install envcfg

Usage

The configuration can be broken down by environment, with the special * key which can be used to share common settings across all environments.

Files

Files can be loaded by passing the path to file that follows the structure above. If the file ends in .json it will be assumed it is a JSON file and will be parsed accordingly.

var envcfg = require('envcfg');
var config = envcfg(__dirname + '/path/to/config.json');

{
	"*": {
		"foo": "foo-*",
		"buz": "buzz-*"
	},
	"development": {
		"bar": "bar-development"
	},
	"test": {
		"foo": "foo-test",
		"bar": "bar-test"
	}
}

Modules

Loading modules by path is not different than loading JSON besides the naming convention. Just be sure the module sets it's module.exports to the configuration.

var envcfg = require('envcfg');
var config = envcfg(__dirname + '/path/to/config_module');

module.exports = exports = {
	"*": {
		"foo": "foo-*",
		"buz": "buzz-*"
	},
	"development": {
		"bar": "bar-development"
	},
	"test": {
		"foo": "foo-test",
		"bar": "bar-test"
	}
}

Programmatically

It is also possible to pass in a plain object.

var config = require('envcfg')({
	"*": {
		"foo": "foo-*",
		"buz": "buzz-*"
	},
	"development": {
		"bar": "bar-development"
	},
	"test": {
		"foo": "foo-test",
		"bar": "bar-test"
	}
});

Mutability

Ever have anyone muck around with your configuration settings? No worries, the object returned from envcfg cannot be tampered with. In strict mode exceptions will be thrown and in none-strict mode, they will be ignored.

'use strict';

var config = require('envcfg')({
	"*": {
		"foo": "foo-*",
		"buz": "buzz-*"
	},
	"development": {
		"bar": "bar-development"
	},
	"test": {
		"foo": "foo-test",
		"bar": "bar-test"
	}
});

// throws on re-setting
config.buzz = "buzz off"; // throws TypeError

// throws on setting new values
config.something_new = 'wtf'; // throws TypeError