homlab-gen 0.1.1__tar.gz

homlab_gen-0.1.1/.gitignore

@@ -0,0 +1,218 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   you could uncomment the following to ignore the entire vscode folder
+.vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml

homlab_gen-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Homology Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

homlab_gen-0.1.1/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: homlab-gen
+Version: 0.1.1
+Summary: Generate crossing-free subprojects for HomLab project JSON files.
+Project-URL: Homepage, https://github.com/Homology-Lab/homlab_gen
+Project-URL: Documentation, https://github.com/Homology-Lab/homlab_gen/tree/main/docs
+Project-URL: Issues, https://github.com/Homology-Lab/homlab_gen/issues
+Author: HomLab.Gen contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: diagram,generator,graph,homlab
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.10
+Requires-Dist: filelock>=3.13
+Requires-Dist: homlab-solver
+Description-Content-Type: text/markdown
+
+# HomLab.Gen
+
+HomLab.Gen 用于读取 HomLab 项目 JSON，消除图中的交叉点，并生成所有可能的无交叉子图。
+
+## 安装
+
+开发安装：
+
+```bash
+python -m pip install -e .
+```
+
+构建发布包：
+
+```bash
+python -m pip install build
+python -m build
+```
+
+构建产物会输出到 `dist/`。
+
+## 命令行使用
+
+安装后可以使用 `homlab-gen`：
+
+```bash
+homlab-gen path/to/project.json
+```
+
+默认输出：
+
+- `sub_diagram/`：所有生成的子项目 JSON。
+- `erase.json`：删除原交叉边并插入角点后的中间文件。
+- `progress.txt`：生成进度。
+- `error.log`：错误日志。
+
+也可以显式指定这些路径：
+
+```bash
+homlab-gen path/to/project.json path/to/error.log --tmp path/to/erase.json --progress path/to/progress.txt
+```
+
+只清理旧的 `sub_diagram/` 目录：
+
+```bash
+homlab-gen path/to/project.json --erase-only
+```
+
+兼容旧参数名：
+
+```bash
+homlab-gen path/to/project.json --dryrun
+```
+
+## Python API
+
+```python
+from homlab_gen import generate_subprojects
+
+exit_code = generate_subprojects("path/to/project.json")
+```
+
+`exit_code` 为 `0` 表示成功，为 `1` 表示失败。失败原因会写入错误日志。
+
+## 文档
+
+更多细节放在 `docs/`：
+
+- [命令行接口](docs/cli.md)
+- [Python API](docs/api.md)
+- [项目 JSON 约定](docs/project-json.md)
+- [打包与发布](docs/packaging.md)
+
+## 开发检查
+
+```bash
+python -m unittest
+python -m build
+```

homlab_gen-0.1.1/README.md

@@ -0,0 +1,79 @@
+# HomLab.Gen
+
+HomLab.Gen 用于读取 HomLab 项目 JSON，消除图中的交叉点，并生成所有可能的无交叉子图。
+
+## 安装
+
+开发安装：
+
+```bash
+python -m pip install -e .
+```
+
+构建发布包：
+
+```bash
+python -m pip install build
+python -m build
+```
+
+构建产物会输出到 `dist/`。
+
+## 命令行使用
+
+安装后可以使用 `homlab-gen`：
+
+```bash
+homlab-gen path/to/project.json
+```
+
+默认输出：
+
+- `sub_diagram/`：所有生成的子项目 JSON。
+- `erase.json`：删除原交叉边并插入角点后的中间文件。
+- `progress.txt`：生成进度。
+- `error.log`：错误日志。
+
+也可以显式指定这些路径：
+
+```bash
+homlab-gen path/to/project.json path/to/error.log --tmp path/to/erase.json --progress path/to/progress.txt
+```
+
+只清理旧的 `sub_diagram/` 目录：
+
+```bash
+homlab-gen path/to/project.json --erase-only
+```
+
+兼容旧参数名：
+
+```bash
+homlab-gen path/to/project.json --dryrun
+```
+
+## Python API
+
+```python
+from homlab_gen import generate_subprojects
+
+exit_code = generate_subprojects("path/to/project.json")
+```
+
+`exit_code` 为 `0` 表示成功，为 `1` 表示失败。失败原因会写入错误日志。
+
+## 文档
+
+更多细节放在 `docs/`：
+
+- [命令行接口](docs/cli.md)
+- [Python API](docs/api.md)
+- [项目 JSON 约定](docs/project-json.md)
+- [打包与发布](docs/packaging.md)
+
+## 开发检查
+
+```bash
+python -m unittest
+python -m build
+```

homlab_gen-0.1.1/docs/api.md

@@ -0,0 +1,56 @@
+# Python API
+
+推荐使用顶层导出的 `generate_subprojects`：
+
+```python
+from homlab_gen import generate_subprojects
+
+code = generate_subprojects("project.json")
+```
+
+## `generate_subprojects`
+
+```python
+generate_subprojects(
+    filepath,
+    error_output_filepath=None,
+    tmp_filepath=None,
+    progress_filepath=None,
+    just_erase=False,
+) -> int
+```
+
+参数：
+
+- `filepath`：输入 HomLab 项目 JSON。
+- `error_output_filepath`：错误日志路径。默认是输入文件同级目录下的 `error.log`。
+- `tmp_filepath`：中间 JSON 路径。默认是输入文件同级目录下的 `erase.json`。
+- `progress_filepath`：进度文件路径。默认是输入文件同级目录下的 `progress.txt`。
+- `just_erase`：为 `True` 时只清理并重建 `sub_diagram/`。
+
+返回值：
+
+- `0`：成功。
+- `1`：失败。
+
+失败时会把详细 traceback 或业务错误写入错误日志。
+
+## 兼容入口
+
+历史上代码放在 `homlab_gen/main.py`。现在该文件仍然保留，可以继续：
+
+```bash
+python -m homlab_gen.main project.json error.log
+```
+
+新代码建议使用：
+
+```bash
+python -m homlab_gen project.json
+```
+
+或安装后使用：
+
+```bash
+homlab-gen project.json
+```

homlab_gen-0.1.1/docs/cli.md

@@ -0,0 +1,42 @@
+# 命令行接口
+
+安装项目后会得到 `homlab-gen` 命令。
+
+## 基本命令
+
+```bash
+homlab-gen input.json
+```
+
+这个命令会在 `input.json` 同级目录下创建或覆盖：
+
+- `sub_diagram/`
+- `erase.json`
+- `progress.txt`
+- `error.log`
+
+## 参数
+
+```text
+homlab-gen [-h] [--tmp TMP] [--progress PROGRESS] [--erase-only] [--quiet] [--version] input [error_log]
+```
+
+- `input`：HomLab 项目 JSON。
+- `error_log`：错误日志路径，默认是输入文件同级目录下的 `error.log`。
+- `--tmp`：中间 JSON 路径，默认是输入文件同级目录下的 `erase.json`。
+- `--progress`：进度文件路径，默认是输入文件同级目录下的 `progress.txt`。
+- `--erase-only`：只删除并重建 `sub_diagram/`，不执行生成。
+- `--dryrun`：`--erase-only` 的兼容别名。
+- `--quiet`：不输出成功提示。
+- `--version`：显示版本。
+
+## 退出码
+
+- `0`：执行成功。
+- `1`：执行失败。具体原因查看错误日志。
+
+## 注意事项
+
+每条边最多只能包含一个交叉点。如果同一条边上检测到多个交叉点，程序会停止并写入错误日志。
+
+当前为了避免生成数量爆炸，交叉点数量上限是 15。生成数量为 `2 ** 交叉点数量`。

homlab_gen-0.1.1/docs/packaging.md

@@ -0,0 +1,47 @@
+# 打包与发布
+
+项目使用标准 `pyproject.toml`，构建后会生成 wheel 和 sdist。
+
+## 本地开发安装
+
+```bash
+python -m pip install -e .
+```
+
+## 运行测试
+
+```bash
+python -m unittest
+```
+
+## 构建
+
+```bash
+python -m pip install build
+python -m build
+```
+
+构建产物：
+
+- `dist/homlab_gen-*.whl`
+- `dist/homlab_gen-*.tar.gz`
+
+## 安装构建产物
+
+```bash
+python -m pip install dist/homlab_gen-*.whl
+```
+
+## 入口
+
+包安装后会注册命令：
+
+```bash
+homlab-gen --help
+```
+
+也可以使用模块入口：
+
+```bash
+python -m homlab_gen --help
+```

homlab_gen-0.1.1/docs/project-json.md

@@ -0,0 +1,55 @@
+# 项目 JSON 约定
+
+HomLab.Gen 期望输入文件包含 HomLab 项目结构。程序会读取以下字段：
+
+- `type`
+- `n`
+- `sw`
+- `cx`
+- `cy`
+- `sc`
+- `r`
+- `bw`
+- `dpr`
+- `cpr`
+- `hs`
+- `ns`
+- `es`
+
+## 节点
+
+节点来自 `hs` 和 `ns`。每个非元数据键都需要包含：
+
+```json
+{
+  "x": 0,
+  "y": 0
+}
+```
+
+键名通常形如 `node_0000001`。以 `#` 开头的键会被视为元数据。
+
+## 边
+
+边来自 `es`。每条边需要包含：
+
+```json
+{
+  "id_1": "node_0000001",
+  "id_2": "node_0000002"
+}
+```
+
+键名通常形如 `edge_0000001`。以 `#` 开头的键会被视为元数据。
+
+## 生成过程
+
+程序会：
+
+1. 找出所有两两相交且不共享端点的边。
+2. 删除相交的旧边。
+3. 在每个交叉点周围创建四个新角点。
+4. 枚举每个交叉点的两种连接方式。
+5. 把每一种组合输出为 `sub_diagram/*.json`。
+
+如果有 `n` 个交叉点，会生成 `2 ** n` 个子项目。

homlab_gen-0.1.1/homlab_gen/__init__.py

@@ -0,0 +1,9 @@
+"""Generate crossing-free subprojects for HomLab project JSON files."""
+
+from __future__ import annotations
+
+from .core import gen_all_dir_idx, generate_subprojects
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__", "gen_all_dir_idx", "generate_subprojects"]

homlab_gen-0.1.1/homlab_gen/__main__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())