参考
CLI 参考
本页的英文版本在翻译之后已有更改。英文页面为最新版本。 阅读英文版
Oloproof 注册的每一条命令及其作用。每条命令都接受 --help,它会打印出这些摘要所依据的完整说明。
本页由 scripts/generate_cli_reference.py 从 CLI 生成。手工编辑它没有意义:下一次生成会覆盖它,而且只要提交的副本过时,make check 就会失败。
命令
| 命令 | 作用 |
|---|---|
| oloproof audit | 本项目中每个人执行过的每一项操作,以及每项操作能证明什么。 |
| oloproof compare | 报告两次已存储运行的配对计数、差值和决策。 |
| oloproof credentials list | 本工作区保存的名称。从不显示值。 |
| oloproof credentials set | 为本工作区存储一个服务商密钥,从环境变量或标准输入读取。 |
| oloproof diagnose | 在某种干预下,使用黄金上下文重新执行一次运行中失败的用例。 |
| oloproof doctor | 报告本机提供的 Python、平台和服务商环境。 |
| oloproof evaluators calibrate | 将概率评判模型给出的概率与人的判断进行对照度量,并拟合一个校正。 |
| oloproof evaluators list | 列出每个已存储的评估器版本,以及决策会读取到的状态。 |
| oloproof evaluators probe | 在没有标注的情况下探测评判器:当没有任何重要因素变化时,它的判定有多频繁地改变。 |
| oloproof evaluators retire | 撤销对某个评估器版本的信任。此操作是终结性的:需记录一个新版本来替代它。 |
| oloproof evaluators try | 用已记录的标注度量一个草稿评估器,但不验证任何东西。 |
| oloproof evaluators validate | 用已存储的人工标注度量评估器,并基于该证据验证它。 |
| oloproof export | 为一次运行、一次比较或一个评估器版本写出可移植的证据包。 |
| oloproof gate | 依据策略对发布做出决策,并按决策结果退出。 |
| oloproof init | 生成项目骨架:一个示例系统、oloproof.yaml 和 release.yaml。 |
| oloproof inspect | 读取已存储的运行、用例、比较或诊断。 |
| oloproof job | 一个托管作业的结果,按其产生的运行的门控结果退出。 |
| oloproof labels export | 将用例写入 CSV 供人工标注:一个盲法随机样本,或待评审的用例。 |
| oloproof labels import | 将标注文件中每一行已填写的内容都记录为标注,否则一行都不记录。 |
| oloproof login | 在浏览器中批准,将此终端连接到一个工作区。 |
| oloproof plan | 要对这次运行或比较未能决定的内容做出决策,需要什么。 |
| oloproof prefer | 两次运行中哪一次回答得更好,由一个成对评判器按两种顺序分别询问得出。 |
| oloproof push | 将一次运行的证据发送到工作区。 |
| oloproof review | 在终端中逐个标注用例,每给出一个判定就立即存储。 |
| oloproof run | 针对系统执行每个用例并存储证据。 |
| oloproof signoff | 记录在门控被阻止的情况下仍然发布,需两位批准人和一份书面理由。 |
| oloproof usage | 本项目消耗了什么,根据其自身的证据度量。 |
退出码
每条命令都使用相同的退出码。CI 门控 列出了每个退出码的含义,以及当多个门控被阻止时它们的报告顺序。