balena temen

A templating engine for JSON.

Provides facilities to:

• evaluate JSON
• evaluate JSON with custom evaluation keyword, functions and filters
• evaluate single expression (result is of any type)
• evaluate single logical expression (result is a boolean)
• retrieve AST of any expression / identifier

Goal

balena-temen crate is one small piece of the [balena.io] configuration project. This project has no public / open specification yet, but we're working on it and it will be public once finished.

Supported platforms

This library is written in the Rust language and can be used:

• directly, as a [Rust crate]
• as an isomorphic [NPM package] (NodeJS & browser)

Documentation

• [API documentation]
• [Expression language documentation]

Usage

Rust

Add as a dependency to your Cargo.toml:

[dependencies] balena-temen = "0.1"

Evaluate simple JSON:

```rust use balenatemen::evaluate; use serdejson::json;

let data = json!({ "wifi": { "ssid": "Balena Ltd", "id": { "$$eval": "super.ssid | slugify" } } }); let evaluated = json!({ "wifi": { "ssid": "Balena Ltd", "id": "balena-ltd" } });

assert_eq!(evaluate(data).unwrap(), evaluated); ```

Node

Add as a dependency to your package.json:

json { "dependencies": { "balena-temen": "0" } }

Evaluate simple JSON:

```js const bt = require('balena-temen');

console.log( bt.evaluate({ "ssid": "Some Cool SSID!", "id": { "$$eval": "super.ssid | slugify" } }) ); ```

Fully working example available in the examples/node folder:

bash cd examples/node npm install npm start

Browser

Add as a dependency to your package.json:

json { "dependencies": { "balena-temen": "0" } }

Evaluate simple JSON:

```js import * as bt from "balena-temen";

console.log( bt.evaluate({ "ssid": "Some Cool SSID Network!", "id": { "$$eval": "super.ssid | slugify" } }) ); ```

Fully working example available in the examples/browser folder:

bash cd examples/browser npm install npm start

Open localhost:8080 in your browser and you should see evaluated JSON in the browser console.

Support

If you're having any problem, please [raise an issue] on GitHub or [contact us], and the [balena.io] team will be happy to help.

License

balena-temen is open source software, and may be redistributed under the terms specified in the [license].