皮齐格

工程开发 社区

技能解读

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

相关文件

Python 端加载器/构建胶水:src/faebryk/core/zig/__init__.py(ZIG_NORECOMPILE、ZIG_RELEASEMODE、锁定、存根同步) Zig 构建 + 存根生成:src/faebryk/core/zig/build.zig(构建扩展 + 运行 .pyi 生成器) 核心 pyzig 实用程序:

家属(呼叫站点)

图绑定:src/faebryk/core/zig/src/python/graph/* Sexp 绑定:src/faebryk/core/zig/src/python/sexp/* TypeGraph 绑定:src/faebryk/core/zig/src/python/faebryk/*(和朋友)

核心概念

直接绑定:pyzig 直接调用 CPython C-API(无 cffi/ctypes)。包装类型:大多数公开的 Zig 结构通过 wrap_in_python(...) / wrap_in_python_simple(...) 成为 Python 堆类型。全局类型注册表:防止为相同的 Zig 类型 (type_registry) 重新创建 Python PyTypeObject。没有直接的__init__(默认情况下):许多“参考”类型并不意味着由用户构建; pyzig 经常安装一个引发的 init。

开发流程

编辑 Zig:绑定助手:src/faebryk/core/zig/src/pyzig/* 模块包装器:src/faebryk/core/zig/src/python/ 重建本机模块:ato dev compile(导入 faebryk.core.zig;可编辑安装导入时编译)

测试

冒烟测试通常通过下游模块进行:python -m faebryk.core.graph(GraphView 分配/清理压力)ato dev test --llm test/core/solver(图形+通过许多子系统进行绑定的大量用户)

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

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

输出预览 pyzig.preview
ato dev compile
python -c "import faebryk.core.zig; import faebryk.core.graph"

讨论

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