/SelectTransform

This project is based upon https://github.com/SelectTransform/st.js but differs in implementation, functionality and robustness.

Primary LanguageJavaScriptApache License 2.0Apache-2.0

SelectTransform

This project is based upon https://github.com/SelectTransform/st.js but differs in implementation, functionality and robustness.

Description

SelectTransform is a module that eases transformation of JS objects using JSON template and JS input data object.

JSON template may contain special readable notation describing how to transform data objects.

Installation

npm i selecttransform

Questions?

This package has deviated a bit from the original implementation and has numerous additional features. If you would like to contribute, join the development, help us maintain the repository or just have some questions about the usage, reach out to us on our community server: https://discord.gg/eNVm2N24

Example Usage

JavaScript

const ST = require('selecttransform').SelectTransform;

const st = new ST();

const data = {
  name: 'Jakub',
  friends: [
    {
      name: 'Michal',
    },
  ],
};

const template = {
  name: '{{ name }}',
  friends: {
    '{{ #each friends }}': {
      index: '{{ $index }}',
      name: '{{ name }}',
    },
  },
};

// Or you can use transformSync
st.transform(template, data).then(console.log);

// Result:
/**
 * {
 *   "name": "Jakub",
 *   "friends": [
 *     {
 *       "index": 0,
 *       "name": "Michal"
 *     },
 *   ],
 * }
 */

TypeScript

import { SelectTrasnform as ST } from 'selecttransform';

const st = new ST();

const data = {
  name: 'Jakub',
  friends: [
    {
      name: 'Michal',
    },
  ],
};

const template = {
  name: '{{ name }}',
  friends: {
    '{{ #each friends }}': {
      index: '{{ $index }}',
      name: '{{ name }}',
    },
  },
};

// Or you can use transform and promise-like structure
console.log(st.transformSync(template, data));

// Result:
/**
 * {
 *   "name": "Jakub",
 *   "friends": [
 *     {
 *       "index": 0,
 *       "name": "Michal"
 *     },
 *   ],
 * }
 */

For complete documentation see Wiki or tests.

Contributions

You are welcome to make a pull request to the repository which I will try to resolve as quickly as possible.

Mainly I'd expect you to want to extend functions available to you in templates. That is done using executors. Executors are separated into three categories:

  • Value executors - those are executors that are in place of any value in the template (eg. ternary executor: "name": "{{ #? path.to.name }}")
  • Key executors - those are executors that are in place of any key, usually represent a function which has name and parameters (eg. optional executor: "{{ #optional name }}": { ... })
  • Array executors - those are executors that are in place of an array (eg. conditional executor: [{ "{{ #if someCondition === true }}": "Correct" }, { "{{ #else }}": "Incorrect" }])

You can freely create new executor in each of these categories using provided templates and by adding them into corresponding index.ts files.

Alternatively, if you would like to make changes to Select or Transform classes I would gladly see to your requests or proposals.