easy-configuration

Easy Configuration

Simply extensible loader for json config files. This package is inspired by configuration in PHP framework Nette.

Changelog

Changelog is in the bottom of this readme.

Installing

$ npm install -g easy-configuration

Loading config

var Configuration = require('easy-configuration');
var config = new Configuration('/var/data/config.json');

var data = config.load();

Be carefull with setting your path to the config file. Easy-Configuration uses required instead of fs module, because of ability to use it in browser. If you will set this path relativelly, then it will be relative to the Easy-Configuration file, not to your actual file.

Parameters

In default, this configurator contains two basic sections: parameters and includes. Parameters section can holds all your variables which you will need in other sections

{
	"parameters": {
		"basePath": "./www",
		"shared": {
			"styles": "%basePath%/css",
			"scripts": "%basePath%/js",
			"translations": "%basePath%/lang"
		}
	}
}

Including other config files

If you will add section includes, you can set list of files, which you want to merge with main config file. Paths to these config files must be relative to main config file.

{
	"includes": [
		"./packages.json"
	]
}

Own sections - main feature

When you will try to add own section, Easy Configuration will tell you, that section was found, but there is no corresponding extension. There is example of registration a new one.

var Configuration = require('easy-configuration');
var config = new Configuration('./config.json');

config.addSection('packages');

var data = config.load();

Now you will be able to add new section with name "packages"

Parameters in own sections

In your sections, you can use parameters from section "parameters".

{
	"packages": {
		"application": "%basePath%/application.js",
		"translator": {
			"translations": "%shared.translations%",
			"script": "%basePath%/translator.js"
		},
		"items": [
			{
				"name": "one",
				"title": "First"
			},
			{
				"name": "two",
				"allowed": false
			},
			{
				"name": "three"
			}
		]
	}
}

Customize packages

Sometimes you may want to customize output of your package. Most simple way is to rewrite method loadConfiguration of default Extension class. For example we always want some other data in our section, even if they are not in config file - let's say "defaults".

var Configuration = require('easy-configuration');
var config = new Configuration('./config.json');

var section = config.addSection('packages');

var defaults = {
	applications: "",
	styles: "",
	translator: {
		translations: "",
		script: ""
	}
};

section.loadConfiguration = function() {
	return this.getConfig(defaults);
};

var data = config.load();

Method getConfig has got one optional argument and it is your defaults variable. This method will return configuration only of your section merged with defaults argument (if any). Of course, there can be more complex code.

EasyConfiguration class has got one other useful method and it is merge.

var Configuration = require('easy-configuration');
var config = new Configuration('./config.json');

var section = config.addSection('packages');

var defaults = {
	applications: "",
	styles: "",
	translator: {
		translations: "",
		script: ""
	},
	"items": []
};

var defaultsItems = {
	"name": "",
	"title": "",
	allowed: true
};

section.loadConfiguration = function() {
	var config = this.getConfig(defaults);

	for (var i = 0; i < config.items.length; i++) {
		config.items[i] = this.configurator.merge(config.items[i], defaultsItems);
	}

	return config;
};

var data = config.load();

Accessing parameters from outside

var Configuration = require('easy-configuration');
var config = new Configuration('./config.json');

var data = config.load();
var parameters = config.parameters;

Changelog

• 1.4.1

  • Written rest of this changelog

• 1.4.0

  • Added changelog to readme
  • Created tests
  • Tests can be runned with npm test command
  • Added removeExtension method

• 1.3.3

  • Removed forgotten dependency on mergin module

• 1.3.2

  • External merging module removed
  • Own old merging function added back

• 1.3.1

  • Repaired some bugs with merging

• 1.3.0

  • Whole module is rewriten

• 1.2.0

  • Trying other external modules for merging
  • Removed dependencies on fs and path
  • Module can be run also in browser

• 1.1.3

  • Added MIT license

• 1.1.2

  • GIT repository renamed from Easy-Configuration to node-easy-configuration

• 1.1.1

  • Added function for remove loaded data from memory

• 1.1.0

  • Storing loaded data in memory
  • Empty sections returns empty object and not undefined

• 1.0.4

  • Renaming from EasyConfiguration to easy-configuration

• 1.0.3

  • Corrected mistakes in readme
  • Added link to Nette framework

• 1.0.2

  • Corrected mistakes in readme

• 1.0.1

  • Corrected mistakes in readme

• 1.0.0

  • Initial commit