Pick the most suitable value from a list of possible values

This is a flexible library which facilitates the rendering of text based on a template and a list of alternate parameters. Alternate parameters can be evaluated against a criteria to select the fittest.

npm i -D pick-alternate-value

import pav from "pick-alternate-value"

const tUpper = value => value.toUpperCase();
const conf = {
  templates: ['<a>{{a}}</a> to <b>{{b}}</b> to <c>{{c}}</c>',
    '<c>{{c}}</c>'],
  props: { a: ['k1', 'k2'], b: [tUpper, 'k3'], c: ['k4', 'k5', 'k6'] },
  placeholders: {
    clean: [['<a>{{', '}}</a>']],
    extract: [['<b>{{', '}}</b>'], ['<c>{{', '}}</c>']],
  },
};

const data = {
  k1: 'k1v1',
  k2: 'k1v11',
  k3: 'k3v',
  k4: 'k4v',
  k6: 'k4v66',
};
pav.renderLongest(conf, data)
// return <a>k1v1</a> to <b>K3V</b> to <c>k4v66</c>
pav.renderLongest(conf, data, 10)
// return <c>k4v</c>

pickLongestSize(list, defaultValue, max) ⇒ object

Pick the first string (or object) with the longest size

pickShortestSize(list, defaultValue, min) ⇒ object

Pick the first string (or object) with the shortest size

sumSize(list) ⇒ integer

Adds the size of all the items in the list

minSize(list) ⇒ integer

Finds the minimum size of all the items in the list

maxSize(list) ⇒ integer

Finds the maximum size of all the items in the list

hasNoNull(list) ⇒ integer

Returns true if the list does not contain any null

discardPlaceholders(template, phStart, phEnd) ⇒ string

Discard the placeholders of a string template. Useful to check the minimum length of a template.

extractPlaceholders(template, phStart, phEnd) ⇒ array

Extract the placeholders of a string template.

getArrInArr(arrIdx, listOfList) ⇒ array

Gets an array using an array of indexes

decArrayIndex(arrIdx, maxIdx) ⇒ array

Decrements an array of indexes from left to right. For right to left, uses .reverse(). This is useful for iterating over indices.

combineListOfList(listOfList) ⇒ array

Combine a list of list in a similar as imbricated for loops

highestRankedCombination(listCombination, rankFn, filterFn) ⇒ array

Finds the combination with the highest rank

coalesce(fns, value) ⇒ array

Run functions sequentially until one succeeds or return null.

extractValuesFromPaths(props, data) ⇒ object

Uses json paths mapping to transform an object

voidTemplate(placeholders4clean, template) ⇒ object

Creates a template without specific placeholders

getTemplateParams(propsData, placeholders, selected) ⇒ object

Build template parameters based on given placeholders

renderFittest(conf, data, selector) ⇒ string

Render text based on a template with selection of the most suited (fit) parameters.

renderLongest(conf, data, max) ⇒ string

Render text based on a template with selection of the longest parameters.

Pick the first string (or object) with the longest size

Kind: global function
Returns: object - The object or string that is the longest

Example

// returns abcd
pav.pickLongestSize(['ab', 'a', 'abcd'])

Pick the first string (or object) with the shortest size

Kind: global function
Returns: object - The object or string that is the longest

Example

// returns a1
pav.pickShortestSize(['abd', 'a1', 'a2', 'abc'])

Adds the size of all the items in the list

Kind: global function
Returns: integer - The sum of all the sizes

Example

// returns 7
pav.sumSize(['ab', 'a', 'abcd'])

Finds the minimum size of all the items in the list

Kind: global function
Returns: integer - The minimum of all the sizes

Example

// returns 1
pav.minSize(['ab', 'a', 'abcd'])

Finds the maximum size of all the items in the list

Kind: global function
Returns: integer - The maximum of all the sizes

Example

// returns 4
pav.maxSize(['ab', 'a', 'abcd'])

Returns true if the list does not contain any null

Kind: global function
Returns: integer - true if no null

Example

// returns false
pav.hasNoNull(['ab', null, 'abcd'])

Discard the placeholders of a string template. Useful to check the minimum length of a template.

Kind: global function
Returns: string - The template without ny placeholders

Example

// returns 123456
pav.discardPlaceholders('1234${placeholder}56','${','}')

Extract the placeholders of a string template.

Kind: global function
Returns: array - all the placeholders

Example

// returns placeholder
pav.extractPlaceholders('1234${placeholder}56','${','}')

Gets an array using an array of indexes

Kind: global function
Returns: array - the selected list

Example

// returns ['b', '1']
pav.getArrInArr([1, 1], [['a','b'], [1, 2]])

Decrements an array of indexes from left to right. For right to left, uses .reverse(). This is useful for iterating over indices.

Kind: global function
Returns: array - the selected list

Example

// returns [1, 2, 4]
pav.decArrayIndex([2, 2, 4], [3, 2, 4])

Combine a list of list in a similar as imbricated for loops

Kind: global function
Returns: array - All the possible combinations in reverse order

Example

// returns [['b', 2], ['a', 2], ['b', 1], ['a', 1]]
pav.combineListOfList([['a','b'], [1, 2]])

Finds the combination with the highest rank

Kind: global function
Returns: array - The highest ranked combination

Example

// returns ['bb', 22]
pav.highestRankedCombination([['bb', 2], ['a', 22], ['b', 1], ['a', 1]])

Run functions sequentially until one succeeds or return null.

Kind: global function
Returns: array - The result of applying the passed function

Example

// returns the result of f1('value') otherwise the value of f2('value')
pav.coalesce([f1, f2], 'value')

Uses json paths mapping to transform an object

Kind: global function
Returns: object - An object with the extracted data

Example

// returns { a: ['3', '4'], b: '13' }
const x13 = value => value*13;
const data = {q: '1', p: {a: '3', b: '4'}}
pav.extractValuesFromPaths({ a: ['p.a', 'p.b'], b: [x13, 'q'] }, data)

Creates a template without specific placeholders

Kind: global function
Returns: object - a template without these placeholders

Example

// returns AABB
pav.voidTemplate([['<a>{{', '}}</a>']], 'AA<a>{{jdsljals}}</a>BB')

Build template parameters based on given placeholders

Kind: global function
Returns: object - the merging of relevant parameters with default ones.

Example

// return { a: 'X', b: 'C', c: 'D', d: 'Y' }
pav.getTemplateParams({ a: ['A', 'B'], b: ['C'], c: [null, 'D', 'E'],
d: 'G' }, ['a', 'd'], ['X', 'Y'])

Render text based on a template with selection of the most suited (fit) parameters.

Kind: global function
Returns: string - the rendered template

Example

// return <a>k1v</a> to <b>K3V</b> to <c>k4v</c>
  const tUpper = value => value.toUpperCase();
  const conf = {
   templates: ['<a>{{a}}</a> to <b>{{b}}</b> to <c>{{c}}</c>',
     '<b>{{a}}</b> to <c>{{b}}</c>'],
   props: { a: ['k1', 'k2'], b: [tUpper, 'k3'], c: ['k4', 'k5', 'k1'] },
   placeholders: {
     clean: [['<a>{{', '}}</a>']],
     extract: [['<b>{{', '}}</b>'], ['<c>{{', '}}</c>']],
   },
 };

 const data = {
   k1: 'k1v',
   k2: 'k2v',
   k3: 'k3v',
   k4: 'k4v',
 };
pav.renderFitest(conf, data, selector)

Render text based on a template with selection of the longest parameters.

Kind: global function
Returns: string - the rendered template

Example

const tUpper = value => value.toUpperCase();
 const conf = {
   templates: ['<a>{{a}}</a> to <b>{{b}}</b> to <c>{{c}}</c>',
     '<c>{{c}}</c>'],
   props: { a: ['k1', 'k2'], b: [tUpper, 'k3'], c: ['k4', 'k5', 'k6'] },
   placeholders: {
     clean: [['<a>{{', '}}</a>']],
     extract: [['<b>{{', '}}</b>'], ['<c>{{', '}}</c>']],
   },
 };

 const data = {
   k1: 'k1v1',
   k2: 'k1v11',
   k3: 'k3v',
   k4: 'k4v',
   k6: 'k4v66',
 };
 pav.renderLongest(conf, data)
 // return <a>k1v1</a> to <b>K3V</b> to <c>k4v66</c>
 pav.renderLongest(conf, data, 10)
 // return <c>k4v</c>

MIT © olih