#json-regress

#快速运行

bash scripts/check-local.sh              # 核心、数值数组、RL、文件 CLI
bash scripts/check-local.sh --integration # 加上固定版本 MoonXi CPU 集成

#直接比较文件

bash scripts/json-regress.sh compare examples/files/baseline.json examples/files/candidate.json examples/files/json.rules.json --format json

#使用方式

moon add willzhang/json_regress@0.1.0

///|
import {
  "willzhang/json_regress" @regress,
}

///|
test "readme regression example" {
  let rules = @json_regress.Rules::new(ignore_paths=["/request_id"], tolerances=[
    { path: "/score", absolute: 0.01, relative: 0.0, },
  ])
  @json_regress.assert_matches(
    { "request_id": "old", "score": 0.8, "count": 100 },
    { "request_id": "new", "score": 0.805, "count": 100 },
    rules~,
  )
  let differences = @json_regress.compare({ "count": 100 }, { "count": 99 })
  assert_eq(differences[0].path, "/count")
  assert_eq(differences[0].reason, @json_regress.ValueMismatch)
}

"/loss": OutsideTolerance; expected=0.25; actual=0.28
"/sample_count": ValueMismatch; expected=100; actual=99

#数值数组、真实集成与轨迹

#比较语义

• 对象不考虑键插入顺序，数组按原始下标比较；不做数组重排或按 id 匹配。
• 缺失用 None 表示，JSON null 用 Some(Null) 表示；缺失节点与 null 不相等。
• 路径采用 RFC 6901 的 JSON Pointer 字符串语法。"" 指向根，"/" 指向空字符串键；键中的 ~ 写成 ~0，/ 写成 ~1。不支持 URI fragment、JSONPath、通配符、正则或 Unicode 归一化。
• 规则只匹配完整路径。忽略某路径会跳过该节点及其子树，也会忽略该节点的缺失。忽略父节点优先于子节点容差。数组中的忽略只作用于原始下标，不会移动其余元素。
• 不存在的规则路径不生效，也不报错。/00 不会命中数组下标 0，/- 不匹配数组元素；它们可以匹配同名对象键。这里借用 Pointer 语法作为比较规则标识，并非提供独立的完整 Pointer 求值器。
• 数值容差只作用于该路径的两个数值，不把字符串转成数字，也不继承到子节点。通过条件是 abs(a-b) <= absolute 或 abs(a-b) / max(abs(a),abs(b)) <= relative；两个零视为相等。相对误差使用两侧较大绝对值，对调输入不改变结果。
• 容差必须是有限非负值。同一路径多条容差会报错，避免先后顺序影响结果；即使忽略根节点，也会先检查全部规则。
• 报告按编码后路径的 UTF-16 字典序排序；因此数组的 /10 排在 /2 前。报告中的对象也按键字典序输出。深度超过 128 层时返回 DepthLimit，不视为匹配。

#数值和输入边界

#当前验证与交付状态

#项目协作