config-stack

keep your configurations organized and stacked

Why Config Stack ?

When building a modern application, you don’t want to worry about configuration file formats; you want to focus on building awesome software. config-stack is here to help with that.

Features

• Find, load, and parse a configuration file in JSON, TOML, YAML, HJSON, JSON5.
• Provide a mechanism to set default values for your different configuration options.
• Working with environment variables (This enables 12 factor applications)
• Working with different deployment environments (development, qa, staging, production, etc.).
• Find, load, and parse a command line
• Support both typescript and javascript
• inject configuration using typescript decorator
• Type safety
• Transform configuration value to a specified type
• zero-dependency module

Example

• typescript - load from file

  import * as configStack from 'config-stack'
  configStack.loadFile('./config.toml','test')
  // or to default environment
  configStack.loadFile('/config.toml')
  configStack.getString('key') // or any other function

• javascript - load from file

  const configStack = require('config-stack')
  configStack.loadFile('./config.toml','test')
  // or to default environment
  configStack.loadFile('/config.toml')
  configStack.getString('key') // or any other function

• typescript - bind all environment variables

  import * as configStack from 'config-stack'
  configStack.automaticEnv(); // ENV will be in lowercase "env"
  console.log(configStack.getString('env'));

• javascript - bind all environment variables

  const configStack = require('config-stack')
  configStack.automaticEnv(); // ENV will be in lowercase "env"
  console.log(configStack.getString('env'));

• typescript - bind specific environment variable

  import * as configStack from 'config-stack'
  configStack.bindEnv('env','development'); 
  console.log(configStack.getString('env','development'));

• javascript - bind specific environment variable

  const configStack = require('config-stack')
  configStack.bindEnv('env','development'); 
  console.log(configStack.getString('env','development'));

• typescript - set target environment

  import * as configStack from 'config-stack'
  configStack.set('key',2,'production')
  configStack.set('key',1,'test')
  configStack.setTragetEnv('test')
  // or from default environment
  console.log(configStack.get('key')); // print 2

• javascript - set target environment

  const configStack = require('config-stack')
  configStack.set('key',2,'production')
  configStack.set('key',1,'test')
  configStack.setTragetEnv('test')
  // or from default environment
  console.log(configStack.get('key')); // print 2

• typescript - bind object

  import * as configStack from 'config-stack'
  const obj = {
     nested: {
       key: "1"
    }
  };
  console.log(configStack.getObject('nested')) // {key: "1"}
  console.log(configStack.getNumber('nested.key')) // 1 
  console.log(configStack.getString('nested.key')) // '1' 

• javascript - bind object

  const configStack = require('config-stack')
  const obj = {
     nested: {
       key: "1"
    }
  };
  console.log(configStack.getObject('nested')) // {key: "1"}
  console.log(configStack.getNumber('nested.key')) // 1 
  console.log(configStack.getString('nested.key')) // '1' 

• typescript - working with command line

  import * as configStack from 'config-stack'
  const flag = configStack.Flag('usage','environment<test|qa|etc..>');
  flag.set(
    {
        name: 'name',
        usage: 'user name',
  
    }
  );
  flag.set(
    {
        name: 'birthday',
        usage: 'user birthday',
        alias: 'b'
  
    }
  );
  flag.set(
    {
        name: 'student',
        usage: 'is user student',
        boolean: true,
        default: false
  
    }
  );
  flag.parse();
  configStack.bind(flag);
  console.log(`user name ${configStack.getString('name')}`);
  console.log(`user birthday ${configStack.getDate('birthday')}`);
  console.log(`user student ${configStack.getBoolean('student')}`);

• javascript - working with command line

  const configStack = require('config-stack')
  const flag = configStack.Flag('usage','environment<test|qa|etc..>');
  flag.set(
    {
        name: 'name',
        usage: 'user name',
  
    }
  );
  flag.set(
    {
        name: 'birthday',
        usage: 'user birthday',
        alias: 'b'
  
    }
  );
  flag.set(
    {
        name: 'student',
        usage: 'is user student',
        boolean: true,
        default: false
  
    }
  );
  flag.parse();
  configStack.bind(flag);
  console.log(`user name ${configStack.getString('name')}`);
  console.log(`user birthday ${configStack.getDate('birthday')}`);
  console.log(`user student ${configStack.getBoolean('student')}`);

./example.js --help 
./example.js -b 01-12-2003 --name john --student

• typescript - working with custom binder

  import * as configStack from 'config-stack'
  class CustomBinder implements configStack.Binder {
   bind(set: configStack.SetFunction){
    set('key','value','test')
    set('key','value')
   }
  }
  bind(new Custominder())

• javascript - working with custom binder

  const configStack = require('config-stack')
  class CustomBinder {
  bind(set){
   set('key','value','test')
   set('key','value')
  }
  }
  configStack.bind(new Custominder())

• typescript - decorators

  import * as configStack from 'config-stack'
  class TestClass {
  @configStack.GetString('name')
  public name: string;
  
  @configStack.Get('any')
  public _any: any;
  
  @configStack.GetNumber('age')
  public age: number;
  
  @configStack.GetBoolean('valid')
  public isValid: boolean;
  
  @configStack.GetRegex('regex')
  public regex: RegExp;
  
  @configStack.GetDate('date')
  public date: Date;
  
  @configStack.GetObject('obj')
  public Object: Object;
  
  @configStack.GetArray('any_array')
  public array: any[];
  
  @configStack.GetBooleanArray('boolean_array')
  public boolean_array: boolean[];
  
  @configStack.GetStringArray('string_array')
  public string_array: string[];
  
  @configStack.GetNumberArray('number_array')
  public number_array: number[];
  }
  

Installation

Install using npm:

npm install config-stack

Documentation

• Functions documentation is available right here
• Decorators documentation is available right here
• Caster documentation is available right here

Roadmap

• support remote config like etcd
• laze automatic env
• load config-stack schema
• environment variables prefix

Contributing

I welcome any contributions, features, enhancements, and bug-fixes. File an issue on GitHub and submit a pull request.

License

Type config-stack is 100% free and open-source, under the MIT license. Use it however you want.