FEELers grammar and editor for the Lezer parser system.
npm install feelers
A templating solution built on top of DMN FEEL.
Like mustache / handlebars but with FEEL.
* A lezer grammar and consequently parser for the templating language
* A parseMixed language definition which brings feelers templating, feel parsing and an optional host language together
* An editor for feelers, build on top of codemirror
* An interpreter to fill your templates with data, powered by feelin
* A simple playground to showcase the language
Feelers is a string templating tool, and will return string text or error.
``js`
import { evaluate } from 'feelers';
A simple string will always be returned as-is.
`js`
evaluate("My simple string");
// "My simple string"
If your string is prefixed with an =, it will be evaluated as a single FEEL expression wrapped in a string conversion function.
`js`
const context = { secondNumber: 12 };
evaluate("= 2 + secondNumber", context);
// "14"
Finally, if your string features feelers language features, the templating engine takes over.
`js`
const context = { user: "Dave" };
evaluate("I'm sorry {{user}}, I'm afraid I can't do that.", context);
// I'm sorry Dave, I'm afraid I can't do that.
The simplest feature of feelers is inserting FEEL evaluations within your text. You may provide a variable context for the underlying FEEL engine to reference. Within these scopes, you have access to all features of the FEEL engine.
`js
const context = { user: "Dave", age: 24, hobbies: [ "surfing", "coding" ] };
evaluate(Hey there {{user}}, welcome. {{if age >= 18 then "Have a beer!" else "Here's some apple juice."}}, context);
// Hey there Dave. Have a beer!
evaluate(Hobbies: {{hobbies}}, context);
// Hobbies: ["surfing", "coding"]
evaluate({{user}}-{{user}}-{{user}}, context);`
// Dave-Dave-Dave
To simply display a section of the template, you may use a conditional section. While this can already be achieved via feel itself using if then else, this syntax is a lot easier to manage for large sections.
`js{{#if count(users) > 1}}There are multiple users{{/if}}
const conditionExample =
{{#if false}}This should not display{{/if}}
{{#if true}}This should display{{/if}};
const context = { users: [ "Bob", "Dave" ] };
evaluate(conditionExample, context);
// There are multiple users
// This should display
`
To handle dealing with arrays of data graciously, you can make use of loop tags. A special variable this is create granting you access to the current loop's element.
`js{{user}}'s hobbies are:
const context = { user: "Dave", age: 24, hobbies: [ "surfing", "coding" ] };
const hobbyExpression =
{{#loop hobbies}}
- {{this}}
{{/loop}};
evaluate(hobbyExpression, context);
/// Dave's hobbies are:
/// - surfing
/// - coding
`
Loops may be nested when dealing with more complex data. When this is an object, you may access its variables directly within the loop. Although this.name would also work in the below example
`js
const context = {
users: [
{
name: "Bob",
hobbies: [ "building", "wearing hardhats" ]
},
{
name: "Dave",
hobbies: [ "surfing", "coding" ]
}
]
}
const complexLoops = {{#loop users}}
{{name}}'s hobbies:
{{#loop hobbies}}
- {{this}}
{{/loop}}
{{/loop}}
evaluate(complexLoops, context);
// Bobs's hobbies:
// - building
// - wearing hardhats
// Dave's hobbies:
// - surfing
// - coding
`
> Loops actually create 4 helper variables: this, parent, _this_ and _parent_. Parent refers to the context just outside of your loop, in case you need to refer to it. The underscored variants are fallbacks in case your context include variables named this and parent.
Build the project in a Posix environment. On Windows, that is Git Bash or WSL.
Note we currently support development environments with Node.js version 16 (and npm version 8). We encourage you to use a Node.js version manager (e.g., nvm or n) to set up the needed versions.
Prepare the project by installing all dependencies:
`sh`
npm install
Then, depending on your use-case you may run any of the following commands:
`shrun all tests
npm run test
* lezer-feel - FEEL language definition for the Lezer parser system
* feel-playground - Interactive playground to learn the FEEL language
MIT