load-config-folder

Load the config from folder as a plain object.

• The config file format can be registered.
• The registered file format order is the search order.
• the virtual file system can be specfied: loadConfig.setFileSystem(fs)
  • fs.path = require('path.js/lib/path').path for the virtual POSIX path.
    • you must set the path first before call setFileSystem.

The load-config-folder is similar to the load-config-file. But it will load the configuration from the folder with a specified file name, you can use addConfig to set the specified config file name(it's a basename).

Usage

1import loadConfig, { FolderConfig } from 'load-config-folder'
2import yaml from 'js-yaml'
3import cson from 'cson'
4
5//the config file basename for the folder.
6FolderConfig.addConfig(['_config']);
7FolderConfig.register(['.yaml', '.yml'], yaml.safeLoad);
8FolderConfig.register('.cson', cson.parseCSONString.bind(cson));
9FolderConfig.register('.json', JSON.parse);
10
11//Synchronously load config for the folder.
12//it will search folder/_config.yaml, folder/_config.yml, folder/_config.cson, folder/_config.json
13//the first exist file will be loaded.
14//the default encoding is "utf8" if no encoding.
15//loadConfig('config', {encoding: 'ascii'})
16//the non-enumerable "$cfgPath" property added.
17console.log(loadConfig('./folder'));
18
19//Asynchronously load config from file
20loadConfig('./folder', function(err, result){
21  if (err) {
22    console.log('error:', err);
23  } else {
24    console.log(result);
25  }
26})
27
28let result = await loadConfig('./folder', true)
29result = await FolderConfig.load('./folder')
30result = FolderConfig.loadSync('./folder')

API

1import { FolderConfig } from 'load-config-folder'

• FolderConfig.setFileSystem(fs): set your favour file system. defaults to 'fs'.
  • the "file system" must implement readFile(path[, options], done) and readFileSync(path[, options])
• load(dir, options, done): Asynchronously load config from dir
  • return the plain object and the $cfgPath property added if suceesful.
• loadSync(dir, options): Synchronously load config from dir
  • return the plain object and the $cfgPath property added if suceesful.

License

MIT