carcass-config/proto/manager.js

(Node.js) A config file loader and manager, in Carcass style.

var carcass, configProto, configurable, parsers, path, _,
  __slice = [].slice;

path = require('path');

carcass = require('carcass');

configurable = require('configurable');

configProto = require('./config');

parsers = require('../').parsers;

_ = require('lodash');


/**
 * Mixin this so your object / instance becomes a config manager. It will have
 *   the ability to load a stack of config files, parse them with a set of
 *   parsers, and store the result in the object / instance.
 *
 * @see `npm info configurable`
 */

module.exports = _.merge(configProto, {

  /**
   * ENV is used in a config file name.
   *
   * @type {Function}
   */
  env: carcass.helpers.accessor('_env', function() {
    var _ref;
    return (_ref = process.env.NODE_ENV) != null ? _ref : 'development';
  }),

  /**
   * We assume all the config files are in a same directory.
   *
   * @type {Function}
   */
  configDir: carcass.helpers.accessor('_configDir'),

  /**
   * Initialize config.
   *
   * Note that the parsers and the file stacks are just some nice defaults. You
   *   can safely override this.
   */
  initConfig: function(filename) {
    var dir, ext, name;
    if (filename == null) {
      filename = 'config.json';
    }
    configurable(this);
    this.parser([parsers.file, parsers.cjson, parsers.eson()]);
    dir = this.configDir();
    if (dir == null) {
      return this;
    }
    ext = path.extname(filename);
    name = path.basename(filename, ext);
    this.source(path.resolve(dir, name + '.default' + ext));
    this.source(path.resolve(dir, filename));
    this.source(path.resolve(dir, name + '.' + this.env() + ext));
    return this;
  },

  /**
   * In addition to loading the configs, it also extends settings.
   */
  reload: function(done) {
    if (done == null) {
      done = function() {};
    }
    return this._load((function(_this) {
      return function(err, res) {
        var _ref;
        if (err) {
          return done(err);
        }
        _this.settings = _.merge((_ref = _this.settings) != null ? _ref : {}, res);
        return done(err, res);
      };
    })(this));
  },

  /**
   * Helper; get an instance of a class and set some defaults.
   */
  getConsumer: function() {
    var args, ins, name;
    name = arguments[0], args = 2 <= arguments.length ? __slice.call(arguments, 1) : [];
    if (_.isFunction(name)) {
      ins = (function(func, args, ctor) {
        ctor.prototype = func.prototype;
        var child = new ctor, result = func.apply(child, args);
        return Object(result) === result ? result : child;
      })(name, args, function(){});
      if (typeof ins.configManager === "function") {
        ins.configManager(this);
      }
    } else if ((this.classes != null) && _.isFunction(this.classes[name])) {
      ins = (function(func, args, ctor) {
        ctor.prototype = func.prototype;
        var child = new ctor, result = func.apply(child, args);
        return Object(result) === result ? result : child;
      })(this.classes[name], args, function(){});
      if (typeof ins.configManager === "function") {
        ins.configManager(this);
      }
    }
    return ins;
  }
});