图形

其他 社区

技能解读

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

相关文件

Python 包装器/重新导出:src/faebryk/core/graph.py Zig 图核心:src/faebryk/core/zig/src/graph/graph.zig Zig → Python 包装器:src/faebryk/core/zig/src/python/graph/graph_py.zig 生成的类型存根:src/faebryk/core/zig/gen/graph/graph.pyi

家属(呼叫站点)

src/faebryk/core/node.py(FabLL:节点/特征是图形支持的)src/atopile/compiler/gentypegraph.py(编译器通过图形 API 构造类型图/实例)src/faebryk/core/graph_render.py(图形可视化)

心智模型

NodeReference / EdgeReference:Zig 中的全局后备存储中的类似值句柄 (UUID)。 GraphView:这些引用的成员资格+邻接视图(每个视图竞技场+地图+位集)。 BoundNode / BoundEdge:用于遍历助手的“引用+拥有GraphView指针”包装器。

核心不变量(请勿违反)

没有直接构造函数:GraphView()、NodeReference()、EdgeReference()不应该被调用;使用公开的工厂方法。 GraphView.create() NodeReference.create(attrs) EdgeReference.create(source=..., target=..., edge_type=..., attrs) 显式清理:GraphView.create() 在 C 分配器上分配 Zig 边图;它只能由GraphView.destroy()释放。

调试

GraphView.__repr__() 从 Zig 打印GraphView(id=..., |V|=..., |E|=...)。图包装器有一个压力测试:python -m faebryk.core.graph(运行test_graph_garbage_collection)。

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

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

输出预览 graph.preview
from faebryk.core.graph import GraphView

g = GraphView.create()
try:
    _ = g.create_and_insert_node()
finally:
    g.destroy()

讨论

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