Skip to content

v0.13.3

Choose a tag to compare

@hesheng01 hesheng01 released this 11 Sep 03:54
· 99 commits to main since this release

v0.13.3 — 内测报告 §9.5 缺口修复:退出码可判 + B10 + 语法糖 + 位宽/溢出

1. 退出码(报告里唯一"不可用"级)—— 现在 CI 可判

  • 脚本错误 / assert-eq 失败 → 退出码 1(默认仍"遇错继续执行", 后续行照跑, 末尾打印 wal-rust: N error(s), M assertion failure(s) in <script>);
  • --halt-on-error → 第一处错误即停, 退出码 1;
  • (exit N) → 以前在脚本里完全不生效(脚本继续跑且 rc=0), 表达式模式还会打印 error: exit:0 并 rc=1; 现在三种模式都立刻停止并返回 N;
  • --stdin 会话: 有探针报错/断言失败 → 退出码 1, 结果照旧按序打到 stdout, 不打断会话;
  • REPL 不受影响。

2. B10 round-trip 丢初值(根因在读者)

$dumpvars 快照扫描按"试 ID 长度 + 要求 ID 前是空格"推断, 于是未分隔的向量行 b1010s1(自家 writer 与 VCS/Icarus 都会产出)全被拒 → 宽>1 的纯初值信号读回来变 x。改为与主扫描共用同一套拆分规则(空格/制表/无分隔/CRLF)+ 哈希后字节复核。.fst 输出被拒是既定契约(本次只订正 --help 里含糊的措辞)。

3. 文档承诺的 #name / ~scope / expr@offset 其实是坏的

expr_from_node 的 "symbol" 分支直接返回原文, 把 symbol = choice(base_symbol, scoped_symbol, grouped_symbol) 压平, 后三个分支永远不可达; @ 也没进 is_anon_token。现在 #clk ≡ (resolve-group 'clk)、~top ≡ (in-scope top)、x@1 ≡ (rel_eval x 1)(旧版 (in-group "top." #clk) 报 Undefined symbol: #clk)。

4. 宽向量静默截断 + i64 溢出

  • 干净向量先看有效位长度: >63 位 → 返回位串, 不再静默丢高位(1024-bit 只置 MSB 的信号以前读出来是 0, (= (get s) 0) 为真);≤63 位仍是整数(128bit 信号的小值 255/128 语义不变);
  • + - * div % sum abs 全部 checked:溢出、(div MIN -1) 明确报错, release/debug 行为一致(以前 release 静默回绕成负数);
  • 位串参与 >= 时给出实际位串并指明出路((= ...) 或 (string->int "..."))。

5. 文档/可用性

  • (help) 总览补 exit/assert-eq/defmacro/defunm/macroexpand/gensym 与语法糖;(help <topic>) 未命中时回落 DOCS(以前 (help "defmacro") 说没有、(doc "defmacro") 却有);
  • DOCS 新增 dump-trace/defsig/defmacro/macroexpand/gensym/defunm/exit/e;assert-eq 条目写明退出码;
  • README 新增 Macros 一节(示例已逐条跑过)+ 退出码约定 + find-sig 通配 + 多文件同名取舍;
  • 手册 §1.8 macroexpand 的错例(when 不是宏)已换;
  • find-sig / CLI sigs 支持 *(任意串)?(单字符), 无通配仍是子串(向后兼容), 通配按 *pattern* 子串语义。

门禁

矩阵 44/44(新增 6 项:退出码 7 场景、未分隔 dumpvars、宽信号 round-trip、语法糖、宽位/溢出、find-sig 通配)、fuzz 三闸(N=120)、diff_find ALL MATCH;基线逐值一致(77629 / 92871 / 1168)。

二进制为 glibc ≥ 2.17 构建(CentOS 7 / RHEL 7 / Ubuntu 16.04+ 可用)。