#!/usr/bin/env python3 # -*- coding: utf-8 -*- """contract_expect —— 读 `docs/contract.md` 里的**机器可读期望值**区段。 🔴 为什么存在: 期望值(菜单表 / 菜单树 / 业务模块清单 / 各尺子的断言数)原先散落在 **契约文档(散文表格)+ 尺子脚本(硬编码)** 两处 ⇒ 改一处忘另一处 ⇒ 漂移。 本脚本把 `docs/contract.md` 附录 A 的 `` 块 解析成结构化数据,**所有尺子都从那里读期望值** ⇒ 单一真源 + 自动对账。 用法: contract_expect.py sections # 列出所有区段名 contract_expect.py dump # 打印全部(调试用) contract_expect.py rows
# 打印整段(表头行 + 数据行,制表符分隔) contract_expect.py menu-tree # 期望菜单树字符串(一行) contract_expect.py menu # 某菜单的某列 contract_expect.py module # 某业务模块的某列 contract_expect.py endpoint # 某端点的某列 contract_expect.py endpoints # 全部端点(method\tpath) contract_expect.py face # 某契约面的某列 contract_expect.py official # 官方端点台账全表(method/path/status/src/note) contract_expect.py official-coverage # 官方端点覆盖 N/M(+ implemented/partial/absent/oos 计数) contract_expect.py ruler # 某把尺子的期望断言数 退出码:0 = 查到 / 2 = 契约里没有这一项(🔴 绝**不**返回空串冒充「查到了」) """ import io import os import sys BEGIN = "` / ``): # `scripts/pack-sync.py` 用它包住**生成段**(批次 12 交付物 ④)。 # ⇒ 必须在这里跳过,否则它会被当成「只有 1 列的数据行」⇒ # 列数校验立刻抛 `ContractError` ⇒ **整把尺子读不出契约**。 if line.lstrip().startswith("