sourcegate

sourcegate -- have any json you want

Use

Give it an array of paths to json files or objects. They will be deep-merged, left to right, using n-deep-merge. It does not mutate any given vars, instead returns a new object. Array merges have union semantics. Files not found are for now simply ignored. Comments are allowed in json files thanks to strip-json-comments.

var sg = require('sourcegate');
var merged = sg(['initialize.json', 'customize/config.json', {c: 3}])

If you are using this to write linter rules, and even if not, you should look into hal-rc or best beverage.

Configure

Sourcegate takes a second argument with the following default options:

{
  root: process.cwd(),
  relative: true,
  merge: true,
  write: {
    path: '', // a file name or path is required to enable writing it
    options: {},
    root: process.cwd(), // optional
    relative: true // optional
  },
  async: false // always the case so far...
}

If the root path is set, it can be relative (by default), or absolute.

Notice that merging is actually optional. That was added for the tests, though it could be useful elsewhere for simply loading files to memory.

The write is optional, enabled by write.path. The options are handed to node. The write.root and write.relative are same as the ones used for reading, unless explicitly made different.

Missing

Some day there may be an async implementation. I so far use it only for workflow tasks, thus async hasn't been needed.

Test

npm test

Dependencies

Unlicensed

This is free and unencumbered public domain software. For more information, see UNLICENSE.