123 lines
3.3 KiB
JavaScript
123 lines
3.3 KiB
JavaScript
/*
|
|
* nconf.js: Top-level include for the nconf module
|
|
*
|
|
* (C) 2011, Charlie Robbins
|
|
*
|
|
*/
|
|
|
|
require.paths.unshift(__dirname);
|
|
|
|
var nconf = exports;
|
|
|
|
nconf.stores = require('nconf/stores');
|
|
|
|
//
|
|
// ### function use (type, options)
|
|
// #### @type {string} Type of the nconf store to use.
|
|
// #### @options {Object} Options for the store instance.
|
|
// Sets the active `nconf.store` to a new instance of the
|
|
// specified `type`.
|
|
//
|
|
nconf.use = function (type, options) {
|
|
nconf.store = new nconf.stores.create(type, options);
|
|
};
|
|
|
|
//
|
|
// ### function get (key, callback)
|
|
// #### @key {string} Key to retrieve for this instance.
|
|
// #### @callback {function} **Optional** Continuation to respond to when complete.
|
|
// Retrieves the value for the specified key (if any).
|
|
//
|
|
nconf.get = function (key, callback) {
|
|
return nconf.store.get(key, callback);
|
|
};
|
|
|
|
//
|
|
// ### function set (key, value, callback)
|
|
// #### @key {string} Key to set in this instance
|
|
// #### @value {literal|Object} Value for the specified key
|
|
// #### @callback {function} **Optional** Continuation to respond to when complete.
|
|
// Sets the `value` for the specified `key` in this instance.
|
|
//
|
|
nconf.set = function (key, value, callback) {
|
|
return nconf.store.set(key, value, callback);
|
|
};
|
|
|
|
//
|
|
// ### function clear (key, callback)
|
|
// #### @key {string} Key to remove from this instance
|
|
// #### @callback {function} **Optional** Continuation to respond to when complete.
|
|
// Removes the value for the specified `key` from this instance.
|
|
//
|
|
nconf.clear = function (key, callback) {
|
|
return nconf.store.clear(key, callback);
|
|
};
|
|
|
|
//
|
|
// ### function load (callback)
|
|
// #### @callback {function} Continuation to respond to when complete.
|
|
// Responds with an Object representing all keys associated in this instance.
|
|
//
|
|
nconf.load = function (callback) {
|
|
if (!nconf.store.load) {
|
|
var error = new Error('nconf store ' + nconf.store.type + ' has no load() method');
|
|
if (callback) {
|
|
return callback (error);
|
|
}
|
|
|
|
throw error;
|
|
}
|
|
|
|
return nconf.store.load(callback);
|
|
};
|
|
|
|
//
|
|
// ### function save (value, callback)
|
|
// #### @value {Object} **Optional** Config object to set for this instance
|
|
// #### @callback {function} Continuation to respond to when complete.
|
|
// Removes any existing configuration settings that may exist in this
|
|
// instance and then adds all key-value pairs in `value`.
|
|
//
|
|
nconf.save = function (value, callback) {
|
|
if (!callback) {
|
|
callback = value;
|
|
value = null;
|
|
}
|
|
|
|
if (!nconf.store.save) {
|
|
var error = new Error('nconf store ' + nconf.store.type + ' has no save() method');
|
|
if (callback) {
|
|
return callback (error);
|
|
}
|
|
|
|
throw error;
|
|
}
|
|
|
|
return nconf.store.save(value, callback);
|
|
};
|
|
|
|
//
|
|
// ### function reset (callback)
|
|
// #### @callback {function} **Optional** Continuation to respond to when complete.
|
|
// Clears all keys associated with this instance.
|
|
//
|
|
nconf.reset = function (callback) {
|
|
return nconf.store.reset(callback);
|
|
};
|
|
|
|
//
|
|
// ### function key (arguments)
|
|
// Returns a `:` joined string from the `arguments`.
|
|
//
|
|
nconf.key = function () {
|
|
return Array.prototype.slice.call(arguments).join(':');
|
|
};
|
|
|
|
//
|
|
// ### function path (key)
|
|
// #### @key {string} The ':' delimited key to split
|
|
// Returns a fully-qualified path to a nested nconf key.
|
|
//
|
|
nconf.path = function (key) {
|
|
return key.split(':');
|
|
};
|