param

param is a tiny module to read config parameters

  • param

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
param
1101.1.06 years ago11 years agoMinified + gzip package size for param in KB

Readme

param
A tiny module to read config parameters for your node application. It's avaiable through npm:
npm install param

what?

Param exposes a single function that finds a config parameter
// example.js
var param = require('param');
var port = param('app.port');

console.log(port);

The above example tells param to find the parameter app.port. It does so by first looking at the command line arguments
node example.js --app.port 8080 # prints 8080
If present param will simply return that value. Otherwise param will look for a configuration file specified by --config [filename] or your NODE_ENV env var. If NODE_ENV=development it will look for a config file called config/development.json or config/development.js. It will start looking for the config file in . If it doesn't exist it will try in .. until it reaches /.
{
	"app": {
		"port": 8888
	},
	"certificate": "{./certificate.file}",
	"apikey": "{$API_KEY}"
}

{$API_KEY} reads API_KEY from the environment. Equivalent to process.env.API_KEY.
{./certificate.file} reads the file called certificate.file.
Running the example again with the above file saved as config/development.json
node example.js # prints 8888
Happy configuring!

License

MIT