Arcee offers mutable and immutable configuration storage that can be shared between modules and workers.
npm install arcee
var config = require("arcee")
// You can pass an object...
config.set("app.webserver", {
port: 8000,
engine: "haml"
})
// ...or the location of a file
config.set("app.db", "config/db.yaml")
// Get all config under the 'app' namespace
config.get("app") // => {webserver: {...}, db: {...}}
// Get only webserver data
config.get("app.webserver") // => {port: 8000, ...}
// Objects returned are immutable by default
var webconf = config.get("app.webserver")
webconf.port // => 8000
webconf.port = 80
webconf.port // => 8000
// To allow mutable config, prefix namespace by '!'
config.set("!app.foo", {...})
// Trying to set config again throws an error...
config.set("app.mongodb", {a: 1})
config.set("app.mongodb", {a: 1, b: 2}) // => Error
// ...unless that particular configuration is mutable
config.set("!app.mongodb", {a: 1})
config.set("!app.mongodb", {a: 1, b: 2})
Stores config.
Throws an error if config has already been set at the namespace and the config is not mutable.
If it contains a dot, arcee
will separate the string
into a namespace. For example, "app.foo"
and "app.bar"
will belong to the
app
namespace.
If namespace if prefixed by !
(!app.foo
), then the configuration is mutable.
Can be an object or a file location to a JSON, YAML, TOML or JavaScript file.
arcee.set("foo", {baz: 42})
arcee.set("!data", {number: 42})
arcee.set("app.bar", {hello: "hi"})
arcee.set("file", "info.toml")
arcee.set("commonjs_file", "config.js")
Returns config.
If there is no config at that namespace, an Error
is thrown.
The Object
returned will be a copy of the object passed to arcee.set
.
Arcee supports TOML, YAML, CommonJS and JSON by default. If you would like to add support for more markup languages, use this method.
The function provided must return an object.
If true, the file location is passed to parser
instead of the contents of the
file.
arcee.addExtension("ini", require("ini").parse)
arcee.addExtension("common-js", require, true)
Returns an array containing supported config filetypes.
Arcee has test coverage of 100%. You can check that yourself by running
npm run coverage
(you will need to install
covert first).
$ cd node_modules/arcee
$ npm install
$ npm test
See CONTRIBUTING.md
GPLv3 or later.
Copyright (C) 2014 Médi-Rémi Hashim
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.