Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

jsonium

1.5.0 • Public • Published

JSONium

Build Status npm version License Downloads

Install

npm i jsonium --save

What?

Generator for creating all possible combinations of JSONs according to the provided templates and data sets. Example:

var Jsonium = require('jsonium');
var j = new Jsonium();
var templates = [
    {a: '{{sub}}', b: 1},
    {a: '{{sub}}', b: 2}
];
var keys = ['a'];
var datasets = [
    {sub: 'replace1'},
    {sub: 'replace2'}
];
var combos = j
    .setTemplates(templates)
    .createCombos(keys, datasets)
    .uniqueCombos()
    .getCombos();
 
console.log(combos); // [{a: 'replace1', b: 1}, {a: 'replace1', b: 2}, {a: 'replace2', b: 1}, {a: 'replace2', b: 2}]

What've happened?

There are two templates. There is one key (a) where some replacing should be done. There are two datasets with values that will be placed in the templates. setTemplates just set templates to the generator. createCombos generate all possible combinations with replacing substrings from datasets in the template's keys. uniqueCombos remove duplicates from created combinations. getCombos just return created and filtered combinations.

JSONium-instance may be used in the another JSONium-instance. Example:

var Jsonium = require('jsonium');
 
var templates = [
  {key1: '{{k1}}'}
];
var keys = ['key1'];
var datasets = [
  {k1: 'v1'},
  {k1: 'v2'}
];
var keys2 = ['key2'];
var templates2 = [
  {key2: '{{key1}} 1'},
  {key2: '{{key1}} 2'}
];
var J = new Jsonium();
J.setTemplates(templates).createCombos(keys, datasets);
var result = new Jsonium(templates2).createCombos(keys2, J).getCombos();

Here J's created combinations will be used like datasets in the another Jsonium-instance.

keys may be nested (a.b.c) and indexed (a.0).

Each substring in the templates you want to be replaced should be wrapped with {{, }}.

More examples

var Jsonium = require('jsonium');
var j = new Jsonium();
var templates = [
  {
    a: 
      [
        {b: '{{sub}}'},
        {b: '{{sub}}'}
      ]
    }
];
var keys = ['a.@each.b'];
var datasets = [
    {sub: 'replace1'},
    {sub: 'replace2'}
];
var combos = j
    .setTemplates(templates)
    .createCombos(keys, datasets)
    .uniqueCombos()
    .getCombos();
 
console.log(combos); // [{a: [{b: 'replace1'}, {b: 'replace1'}]}, {a: [{b: 'replace2'}, {b: 'replace2'}]}]
var Jsonium = require('jsonium');
var j = new Jsonium();
var templates = [
  {
    a: 
      [
        {
          b: 
            [
              {c: '{{sub}}'},
              {c: '{{sub}}'}
            ] 
        },
        {
          b: 
            [
              {c: '{{sub}}'}
            ] 
        }
      ]
    }
];
var keys = ['a.@each.b.@each.c'];
var datasets = [
    {sub: 'replace1'}
];
var combos = j
    .setTemplates(templates)
    .createCombos(keys, datasets)
    .uniqueCombos()
    .getCombos();
 
console.log(combos); // [{a: [{b: [{c: 'replace1'}, {c: 'replace1'}]}, {b: [{c: 'replace1'}]}]}]
var Jsonium = require('jsonium');
var j = new Jsonium();
var templates = [
  {key1: {a: '{{k1}}', b: '{{k2}}'}}
];
var keys = ['key1.{a,b}'];
var datasets = [
    {k1: 'v1', k2: 'v2'}
];
var combos = j
    .setTemplates(templates)
    .createCombos(keys, datasets)
    .uniqueCombos()
    .getCombos();
 
console.log(combos); // [{key1: {a: 'v1', b: 'v2'}}]

install

npm i jsonium

Downloadsweekly downloads

18

version

1.5.0

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar