Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    envconfpublic

    envconf

    This module makes it easy to use express-style configuration for any application. It allows your users to define separate configuration environments in code and switch between sets of configuration via a single environment variable.

    Basic Usage

     
    var envconf = require('envconf');
     
    var c = envconf.createConfig();
     
    c.configure('development', function (c) {
      c.set('settingOne', 'devValue');
    });
     
    c.configure('production', function (c) {
      // You can also pass in an object literal to set a bunch 
      // of values at once 
      c.set({
        settingTwo: 'prodValue'
        prodOnly: 'prodSpecific'
      });
    });
     
    c('development').get('settingOne').should.equal('devValue');
     
    process.env.NODE_ENV = 'production';
    c.default.get('settingTwo').should.equal('prodValue');
    c.default.get('prodOnly').should.equal('prodSpecific');

    The previous code shows picking up the default environment from the NODE_ENV environment variable.

    You can however configure your own environment variables as shown below.

     
    var c2 = envconf.createConfig({ defaultEnvVar: 'MY_LIBRARY_VAR'});
     
    c2.configure('development', function (c) {
      c.set('settingOne', 'devValue');
    });
     
    c2.configure('production', function (c) {
      c.set('settingTwo', 'prodValue');
    });
     
    c2('development').get('settingOne').should.equal('devValue');
     
    process.env.MY_LIBRARY_VAR = 'production';
    c.default.get('settingTwo').should.equal('prodValue');

    Setting Getters

    Instead of a setting a simple value, you can instead use the setFunc method to provide a function that will run when the value is requested:

    var c2 = envconf.createConfig();
     
    c2.configure('development', function (c) {
      c.setFunc('settingOne', function () { return 'This value came from a function'; });
    });
     
    c2.get('settingOne').should.equal('This value came from a function');

    or, if you use the object literal version of set, values that are functions will be treated as if you called setFunc for that value:

    var c2 = envconf.createConfig();
     
    c2.configure('development', function (c) {
      c.set({
        settingOne: function () { return 'This value also came from a function'; }
      });
    });
     
    c2.get('settingOne').should.equal('This value also came from a function');

    This can be handy if you want to have a default value that you need to derive from ambient state.

    Customizing the config object

    Do you want to add helper methods for your specific configuration? Or set specific values in every configuration? It's easy with a config customizer:

     
    function addConfigHelpers(config) {
      config.useSql = function (host, db) {
        config.set('sql host', host);
        config.set('sql database name', db);
      }
    }
     
    var c3 = envconf.createConfig( { customizer: addConfigHelpers });
     
    c3.configure('test', function (c) {
      c.useSql('testmachine', 'testdb');
    });
     
    c3.configure('production', function (c) {
      c.useSql('realDatabase', 'actualDb');
    });
     
    // Can also customize after creation, customizations 
    // will affect any child configs too! 
    c3 = envconf.createConfig();
    var prod = c3('prod');
     
    c3.customize(addConfigHelpers);
     
    c3.configure('production', function (c) {
      c.useSql('realDatabase', 'actualDb');
    });

    Saving and Restoring config values

    Are you making changes to a global configuration in your unit tests, and want to ensure you've restored the state after your test? Use a snapshot:

     
    var c4 = envconf.createConfig();
    c4.configure(function (c) {
      c.set('originalValue', 'one');
    });
     
    // set up contents of c4 
     
    var snapshot = c4.snapshot();
     
    c4.configure(function (c) {
      c.set('originalValue', 'two');
    });
     
    c4.restore(snapshot);
     
    c4.get('originalValue').should.equal('one');

    Snapshot/restore also saves and restores any child configurations.

    Temporary Configs

    Similarly, you might want to set up a configuration and then be able to throw it away without giving it a name. Easy:

     
    var c5 = envconf.createConfig();
    c5.configure(function (c) {
      c.set('originalValue', 'one');
    });
     
    var c6 = envconf.tempConfig();
    c6.set('tempValue', 'temp');
     
    // You can look up values in the temp config or the parent 
    c6.get('tempValue').should.equal('temp');
    c6.get('originalValue').should.equal('one');
     
    // But the parent has no record of the temp 
    c5.environments.length.should.equal(0);

    install

    npm i envconf

    Downloadslast 7 days

    17,499

    version

    1.1.0

    license

    none

    homepage

    github.com

    last publish

    collaborators

    • avatar