JSPM

  • Created
  • Published
  • Downloads 9484300
  • Score
    100M100P100Q205356F

Easily load and persist config without having to think about where and how

Package Exports

  • configstore

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (configstore) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

configstore Build Status

Easily load and persist config without having to think about where and how.

Config is stored in a YAML file to make it simple for users to edit the config directly themselves. The file is located in $XDG_CONFIG_HOME or ~/.config. Eg: ~/.config/configstore/id-of-your-choosing.yml

Example usage

var Configstore = require('configstore');
var packageName = require('./package').name;

// Init a Configstore instance with an unique ID eg. package name
// and optionally some default values
var conf = new Configstore(packageName, { foo: 'bar' });

conf.set('awesome', true);
console.log(conf.get('awesome'));  // true
console.log(conf.get('foo'));      // bar

conf.set('foo', 'baz');
console.log(conf.get('foo'));      // undefined

Documentation

Methods

.set(key, val)

Set an item

.get(key)

Get an item

.del(key)

Delete an item

Properties

.all

Get all items as an object or replace the current config with an object:

conf.all = {
    hello: 'world'
};

.size

Get the item count

.path

Get the path to the config file. Can be used to show the user where to config file is located or even open it for them.

License

BSD license