homlab-gen 0.1.1

Generate crossing-free subprojects for HomLab project JSON files.

HomLab.Gen

HomLab.Gen 用于读取 HomLab 项目 JSON，消除图中的交叉点，并生成所有可能的无交叉子图。

安装

开发安装：

python -m pip install -e .

构建发布包：

python -m pip install build
python -m build

构建产物会输出到 dist/。

命令行使用

安装后可以使用 homlab-gen：

homlab-gen path/to/project.json

默认输出：

• sub_diagram/：所有生成的子项目 JSON。
• erase.json：删除原交叉边并插入角点后的中间文件。
• progress.txt：生成进度。
• error.log：错误日志。

也可以显式指定这些路径：

homlab-gen path/to/project.json path/to/error.log --tmp path/to/erase.json --progress path/to/progress.txt

只清理旧的 sub_diagram/ 目录：

homlab-gen path/to/project.json --erase-only

兼容旧参数名：

homlab-gen path/to/project.json --dryrun

Python API

from homlab_gen import generate_subprojects

exit_code = generate_subprojects("path/to/project.json")

exit_code 为 0 表示成功，为 1 表示失败。失败原因会写入错误日志。

文档

更多细节放在 docs/：

• 命令行接口
• Python API
• 项目 JSON 约定
• 打包与发布

开发检查

python -m unittest
python -m build