There are several configuration modules available for node.js. Each have their strengths and weaknesses, but no one project can be considered the optimal configuration option for all use cases. Some applications have need of complex configuration that can be fetched from a central server. Others just want a simple JSON object loaded when the app starts.
node-configure seeks to solve the problem of a single application that is being developed by a group of developers who need the ability to have a different application configuration for each developer and deployment environment, but do not wish to utilize a complex configuration module.
Using node-configure, each developer can have a separate configuration file checked in to source control without being forced to worry about overwrites from another developer.
node-configure is designed to provide a global config that can be obtained from any node application file without forcing the main app file to load and pass around configuration setting objects. With node-configure, any file or module that requires the node-configure module will receive the same configuration object, which is the parsed result of the JSON configuration file.
With node-configure, it is the responsibility of modules that wish to obtain configuration settings to know their appropriate configuration fields and to provide defaults as necessary.
The following is an example of how one might use the node-configure module.
var config = ;var port = 2000; // default portifconfigserverPortport = configserverPort;// elsewhere...server;
var config = ;var request = "host":"my.couchdb.com" "port":5984 ;ifconfigcouchDbifconfigcouchDbhostrequesthost = configcouchDbhost;ifconfigcouchDbportrequestport = configcouchDbport;// later...requestpath = "/mydata";http;
The node start script:
node main.js --config myConfig.json
At present node-configure only supports JSON configuration files.
The first time the node-configure module is required by an application, it will attempt to load the file specified
--config switch relative to the current working directory as obtained via
node-configure fails to find or load the file, it will throw an exception.
--config switch is not included as a command line parameter, node-configure will attempt to load the file
"config.json" in the current working directory. If that file is not found, node-configure will throw an exception.
node-configure makes use of npm's
package-level configuration system. If you wish to
change the default behavior of node-configure you may do so through this system. After changing a package
configuration option via
npm config set, you must restart the node-configure package to use the new settings.
npm config set configure:notFound throw npm restart configure
node-configure supports the following npm configuration keys: