convert-all-string-template-slots-pmb v1.0.1

convert-all-string-template-slots-pmb

Convert any unary function into a string template tag that converts all its slot values.

API

import convertTempaleSlots from 'convert-all-string-template-slots-pmb';

This module exports one function:

convertAllStringTemplateSlots(f)

Given an unary conversion function f, return a tag function (a renderer for a tagged template literal) c that converts all slot values before inserting them.

The conversion function is actually invoked as f(x, i, v, t) where x is the slot value, i is the slot index (counted starting at 0), v is the list of all slot values, and t is the list of texts. t[i] is the text preceeding v[i] === x; t.length === v.length + 1 because of the (potentially empty) text after the last slot.

The c function holds these properties:

• func: A reference to f.
• compose(g): Given an unary conversion function g, return a tag function that converts using the composition of f and g, i.e. g(f(x)).

Usage

see test/usage.mjs.

Similar modules

• string-template-format-base: Unclear whether the conversion function is invoked with additional arguments. Implementation is more complex. No composition method. Seems to no longer be maintained.

Known issues

• Needs more/better tests and docs.

License

ISC