Configurator.ts

Allows to create and manage configuration files in your project. You can use gulp-config-parameters plugin to automate how your configuration is created and managed.

Installation

1. Install module:

   npm install configurator.ts --save

2. Use typings to install all required definition dependencies.

   typings install

3. ES6 features are used, so you may want to install es6-shim too:

   npm install es6-shim --save

   if you are building nodejs app, you may want to require("es6-shim"); in your app. or if you are building web app, you man want to add <script src="path-to-shim/es6-shim.js"> on your page.

Usage

Create your configuration file, lets say ./config.json:

{
  "factoryName": "BMW",
  "showEngineInfo": true,
  "engine": {
    "version": 12,
    "description": "Reactive engine for reactive cars"
  }
}

Then register your configuration file in configurator and use it to get your configuration properties:

import {defaultConfigurator} from "configurator.ts/Configurator";
 
defaultConfigurator.setConfiguration(require("./config.json"));
console.log("factory name: ", configurator.get("factoryName")); // prints: factory name: BMW
console.log("show engine info?: ", configurator.get("showEngineInfo")); // prints: show engine info?: true
console.log("car engine: ", configurator.get("engine")); // prints: car engine: [Object object]

If you have separate parameters file you can use it this way:

Lets say you have created ./parameters.json

{
  "factoryName": "BMW",
  "showEngineInfo": true,
  "engine": {
    "version": 12,
    "description": "Reactive engine for reactive cars"
  }
}

And your ./config.json is like this:

{
  "factoryName": "%factoryName%",
  "showEngineInfo": "%showEngineInfo%",
  "engine": {
    "version": "%engine::version%",
    "name": "Reactive",
    "description": "%engine::description%"
  }
}

Now you can use configuration (with replaced parameters) this way:

import {defaultConfigurator} from "configurator.ts/Configurator";
 
defaultConfigurator.setConfiguration(require("./config.json"));
defaultConfigurator.replaceWithParameters(require("./parameters.json"));
console.log("factory name: ", configurator.get("factoryName")); // prints: factory name: BMW
console.log("show engine info?: ", configurator.get("showEngineInfo")); // prints: show engine info?: true
console.log("car engine: ", configurator.get("engine")); // prints: car engine: [Object object]

This allows you to create a common configuration file for your app, and use different parameters on different platforms. You can use gulp-config-parameters plugin to automate this process.

If you are using typedi you can inject your configuration in your classes

import {Service} from "typedi/Service";
import {Config} from "../../src/Annotations";
import {EngineFactory} from "./EngineFactory";
 
@Service()
export class CarFactory {
 
    private factoryName: string;
    private showEngineInfo: boolean;
 
    constructor(@Config("factoryName") factoryName: string,
                @Config("showEngineInfo") showEngineInfo: boolean) {
 
        this.factoryName = factoryName; // gives you "BMW"
        this.showEngineInfo = showEngineInfo; // gives you "true"
    }
 
}

You can also inject right to the properties:

import {Service} from "typedi/Service";
import {Config} from "../../src/Annotations";
import {EngineFactory} from "./EngineFactory";
 
@Service()
export class CarFactory {
 
    @InjectConfig("factoryName")
    factoryName: string;  // value is "BMW"
    
    @InjectConfig("showEngineInfo")
    showEngineInfo: boolean; // value is "true"
    
}

Samples

Take a look on samples in ./sample for more examples of usage.

Todos

• cover with tests
• more documentation and samples