balena temen

JSON的模板引擎。

提供以下功能

• 评估JSON
• 使用自定义评估关键字、函数和过滤器评估JSON
• 评估单个表达式（结果为任何类型）
• 评估单个逻辑表达式（结果为布尔值）
• 检索任何表达式/标识符的AST

目标

balena-temen 包是 balena.io 配置项目的一个小部分。该项目目前还没有公开/开放规范，但我们正在努力工作，完成后将公开。

支持的平台

此库是用 Rust 语言编写的，可以直接使用

• 作为一个 Rust 包
• 作为一个同构的 NPM 包（NodeJS & 浏览器）

文档

• API 文档
• 表达式语言文档
• 变更日志

重大更改

版本 0.3

• Python 风格的 kwargs 已被移除，以支持位置参数。所有函数和过滤器仅接受位置参数。
• NOW() 函数仅接受一个 boolean 参数

版本 0.2

• 所有函数和过滤器标识符都大写
  • 示例 uuidv4() -> UUIDV4()

版本 0.1

$$eval 关键字已更名为 $$formula。如果您愿意，仍然可以使用 $$eval 通过使用 Engine 的 EngineBuilder 和 自定义 eval 关键字 注册。

用法

Rust

在您的 Cargo.toml 中添加依赖项

[dependencies]
balena-temen = "0.1"

评估简单的 JSON

use balena_temen::evaluate;
use serde_json::json;

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

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

JavaScript

通过 npm 安装

npm install --save balena-temen

评估简单的 JSON

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

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

在 examples/node 文件夹中可以找到使用此模块在 nodeJS 中的示例

cd examples/node
npm install
npm start

在 examples/browser 文件夹中可以找到使用此模块在浏览器中的示例

cd examples/browser
npm install
npm start

在您的浏览器中打开 localhost:8080，您应该在浏览器控制台中看到已评估的 JSON。

支持

如果您有任何问题，请通过 GitHub 提交问题 或 联系我们，balena.io 团队将很高兴为您提供帮助。

许可证

balena-temen 是开源软件，可以在指定的 许可证 条件下重新分发。