开发者

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

相关文件

CLI 命令: src/atopile/cli/dev.py ato dev compile(通过 import faebryk.core.zig 触发 Zig 构建) ato dev test --llm(使用参数运行 test/runner/main.py;支持基线/CI 报告助手) Zig 导入粘合:src/faebryk/core/zig/__init__.py(ZIG_NORECOMPILE、ZIG_RELEASEMODE) 配置标志实用程序: src/faebryk/libs/util.py(ConfigFlag、ConfigFlagInt、……)

家属(呼叫站点)

CI/CD:dev命令是 GitHub Actions 工作流程的主要界面。本地开发:开发者修改Zig代码后使用ato dev compile。

核心命令

ato dev compile:编译本机扩展(graph/typegraph/sexp 绑定)。 ato dev test --llm:运行编排的测试运行器(默认为-p test -p src);支持: -k 过滤器(-- -k ... 也可以通过直通参数工作) --baseline 比较(提交哈希或 HEAD~N 样式) --view / --open 从 GitHub Actions 获取并打开 test-report.html 工件(需要 gh命令行界面)

测试报告(JSON 作为事实来源)

本地测试运行写入:artifacts/test-report.json(单一事实来源;结果/持续时间/内存/基线比较状态+ stdout/stderr/日志/回溯;请参阅tests[].output_full)artifacts/test-report.html(人类仪表板;源自JSON;由FBRK_TEST_GENERATE_HTML=1控制)artifacts/test-report.llm.json(LLM友好;源自JSON;ANSI剥离日志)CI 上传两个工件(参见.github/workflows/pytest.yml):

ConfigFlags(如何使用+如何清点)

ConfigFlag 是存储库的“toggle-by-env-var”机制。环境变量名称是ConfigFlag(...)的第一个参数。用法:清点树中的所有 ConfigFlags(优先于尝试维护手动列表):当您想要在一个地方了解完整情况(类型/默认/描述 + 调用点计数)时,更喜欢使用ato dev flags。您将经常使用的高杠杆标志:

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@atopile · MIT
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 dev.preview
source .venv/bin/activate

ato dev compile
ato dev test --llm -k solver
ato dev test --llm --view HEAD --open
ato dev test --reuse --baseline HEAD~1
ato dev flags

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。