README- UAst
- UJsonataError
- ::runCompiled::run
- Vcompile
- Vevaluate
moonata
JSONata rewritten in moonbit.
Author
Version
0.5.0
License
Apache-2.0
Repository
Last updated
3 months ago
Downloads
45
#Moonata
Moonata 是 JSONata 的 MoonBit 实现。JSONata 是一门面向 JSON 数据的查询与转换语言。
本项目目前提供解析器、求值器、内建函数注册表、对外 facade API 与 native CLI。项目仍在对齐上游 jsonata-js 官方测试集，因此当前状态是“可用但尚未完全替代原版 JSONata”。
#功能
- JSONata 表达式解析与求值。
- 路径遍历、谓词、通配符、递归下降、变量、块表达式、Lambda、部分应用与函数链。
- 对象、数组、字符串、数值、布尔、日期时间、正则与高阶内建函数。
- Facade API：evaluate(expr, data) 与 compile(expr).run(data)。
- Native CLI，支持 --data 与 --file 输入模式。
- MoonBit 包结构与生成的 .mbti 接口文件。
#CLI
构建 native 命令：
moon build cmd/main --target native对 JSON 文件运行表达式：
_build/native/debug/build/cmd/main/main.exe '$sum(Account.Order.Product.(Price * Quantity))' --file cmd/main/test.json针对 cmd/main/test.json 的示例表达式：
Account.'Account Name' -> "Firefly"
$sum(Account.Order.Product.(Price * Quantity)) -> 336.36#库 API
在 MoonBit 代码中调用时，使用根包 facade：
///|
let data = @json.parse("{\"items\":[{\"price\":10},{\"price\":20}]}")
///|
let result = @moonata.evaluate("$sum(items.price)", data)需要重复求值时，可先编译一次：
///|
let expr = @moonata.compile("$sum(items.price)")
///|
let result = expr.run(data)上述 API 会在语法、运行时、类型、签名与护栏错误时抛出 JsonataError。
#开发
常用验证命令：
moon check
moon test
moon fmt
moon info提交代码变更前，应运行完整本地门禁，并检查生成的 .mbti diff 是否符合预期。提交信息使用 Conventional Commit 风格，例如：
feat(functions): add basic formatNumber support
fix(evaluator): align predicate context semantics
docs: update official test status#CI
仓库使用 GitHub Actions 执行以下门禁：
- moon check --deny-warn：类型检查、语法检查，警告视为错误
- moon fmt --check：格式校验
- moon info：接口生成
- moon build --deny-warn：构建，警告视为错误
- moon test --deny-warn：测试执行，警告视为错误
CI 在 master 分支推送、PR 以及手动触发时运行。
#兼容性状态
固定快照：2026-07-07，parent-operator 父级链路修复阶段。
本地测试：moon test 182/182
官方可比对审计：eligible 1251, pass 1184, fail 67, skip 431
通过率：94.6%当前剩余失败最多的官方测试分组：
function-tomillis 10
joins 10
transforms 10
parent-operator 6
variables 5
flattening 4
function-applications 2
object-constructor 2
transform 2
boolean-expresssions 1官方测试集审计流程与跳过策略记录在 docs/jsonata-official-workflow.md。
Ast
JSONata AST 节点：单一 enum + 标签字段。
所有节点统一为 Ast enum，子结构 Step/SortTerm 独立定义。
路径访问统一用 Path(Array[Step]) 表示，Step 携带 StepKind 与 StepStage。
Compiled
compile
编译 JSONata 表达式为可重复求值的 Compiled。
evaluate
JSONata 表达式求值。
解析并求值 JSONata 表达式，返回 JSON 结果。
Apache-2.0
Updated 3 months ago
45 downloads