feat(factorio-cycle-calculator): Improve Codegen Workflow Via Mise Task

.gitattributes

@@ -3,3 +3,4 @@
 OneDotNet/srcs/private/app/OxfordWordlistExtractor/*.html linguist-vendored
 OneDotNet/tests/OxfordDictExtractor.Tests/examples/*.html linguist-vendored
 src/private/app/supermemo-mcp/references/*.ahk linguist-vendored
+src/private/app/factorio-cycle-calculator/src/factorio_cycle_calculator/generated/* linguist-generated

.mise.toml

@@ -1,3 +1,11 @@
+experimental_monorepo_root = true
+
+[settings]
+experimental = true
+
+[monorepo]
+config_roots = ["src/private/app/factorio-cycle-calculator"]
+
 [tools]
 # Runtimes
 dotnet = "10"

src/private/app/factorio-cycle-calculator/.mise.toml

@@ -0,0 +1,35 @@
+[tasks."schema:generate"]
+description = "Generate Python models from the JSON schema."
+run = [
+  """
+  uv run \
+  --project src/private/app/factorio-cycle-calculator \
+  --package factorio-cycle-calculator \
+  --group dev \
+  datamodel-codegen \
+  --url https://raw.githubusercontent.com/jacquev6/factorio-data-raw-json-schema/refs/heads/main/factorio-data-raw-json-schema.full.json \
+  --output src/factorio_cycle_calculator/generated/data_raw_models.py \
+  --input-file-type jsonschema \
+  --output-model-type dataclasses.dataclass \
+  --target-python-version 3.12 \
+  --formatters ruff-format""",
+  """
+  uv run \
+  --project src/private/app/factorio-cycle-calculator \
+  --package factorio-cycle-calculator \
+  --group dev \
+  ruff check \
+  --fix \
+  --exit-zero \
+  --quiet \
+  src/factorio_cycle_calculator/generated/data_raw_models.py""",
+  """
+  uv run \
+  --project src/private/app/factorio-cycle-calculator \
+  --package factorio-cycle-calculator \
+  --group dev \
+  ruff format \
+  --quiet \
+  src/factorio_cycle_calculator/generated/data_raw_models.py""",
+]
+outputs = ["src/factorio_cycle_calculator/generated/data_raw_models.py"]

src/private/app/factorio-cycle-calculator/README.md

@@ -20,6 +20,18 @@ An initial Streamlit prototype is available in `app.py`. It focuses on the
 advanced oil processing chain and uses Google OR-Tools to compute machine
 counts given a petroleum gas demand and the chosen machine/effect settings.
 
-Run the app with:
+Run the app after installation with the script entry point:
 
-- `uv run --project src/private/app/factorio-cycle-calculator streamlit run app.py`
+- `uv run --project src/private/app/factorio-cycle-calculator factorio-cycle-calculator`
+
+## Schema and generated models
+
+The generated models live in
+`src/factorio_cycle_calculator/generated/data_raw_models.py`.
+
+Model generation is driven entirely by a mise task that pulls the schema from
+the upstream URL and does not store a local JSON schema file.
+
+Generate models:
+
+- `mise //src/private/app/factorio-cycle-calculator:schema:generate`

src/private/app/factorio-cycle-calculator/pyproject.toml

@@ -1,3 +1,7 @@
+[build-system]
+requires = ["hatchling>=1.24.2"]
+build-backend = "hatchling.build"
+
 [project]
 name = "factorio-cycle-calculator"
 version = "0.0.0-dev"
@@ -9,5 +13,24 @@ license = "GPL-3.0-or-later"
 classifiers = ["Private :: Do Not Upload"]
 dependencies = ["ortools>=9.11.4210", "pillow>=10.3.0", "streamlit>=1.42.0"]
 
+[project.scripts]
+factorio-cycle-calculator = "factorio_cycle_calculator.__main__:main"
+
 [dependency-groups]
-dev = ["datamodel-code-generator[ruff]>=0.53.0"]
+dev = ["datamodel-code-generator[debug,ruff,http]>=0.53.0"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/factorio_cycle_calculator"]
+
+[tool.datamodel-codegen]
+input = "https://raw.githubusercontent.com/jacquev6/factorio-data-raw-json-schema/refs/heads/main/factorio-data-raw-json-schema.full.json"
+input-file-type = "jsonschema"
+output = "src/factorio_cycle_calculator/generated/data_raw_models.py"
+output-model-type = "dataclasses.dataclass"
+target-python-version = "3.12"
+
+[tool.ruff]
+extend = "../../../../pyproject.toml"
+
+[tool.ruff.lint.per-file-ignores]
+"src/factorio_cycle_calculator/generated/data_raw_models.py" = ["D", "N815"]

src/private/app/factorio-cycle-calculator/src/factorio_cycle_calculator/__main__.py

@@ -0,0 +1,29 @@
+"""Run the Streamlit app via the package entry point."""
+
+from __future__ import annotations
+
+import sys
+from importlib import import_module
+from pathlib import Path
+
+from streamlit.web.cli import main as streamlit_main
+
+
+def main(argv: list[str] | None = None) -> None:
+    """Launch the Streamlit application."""
+    module = import_module("factorio_cycle_calculator.app")
+    app_path = Path(module.__file__).resolve()
+    new_argv = ["streamlit", "run", str(app_path)]
+    if argv is not None:
+        new_argv.extend(argv)
+
+    old_argv = sys.argv
+    try:
+        sys.argv = new_argv
+        streamlit_main()
+    finally:
+        sys.argv = old_argv
+
+
+if __name__ == "__main__":
+    main()

src/private/app/factorio-cycle-calculator/app.py → src/private/app/factorio-cycle-calculator/src/factorio_cycle_calculator/app.py

@@ -2,12 +2,10 @@
 
 from __future__ import annotations
 
-import importlib
 import io
 import json
 import os
 import re
-import sys
 from collections.abc import Mapping, Sequence
 from dataclasses import MISSING, dataclass, fields, is_dataclass
 from pathlib import Path
@@ -58,20 +56,14 @@ class ModulePrototype(_GeneratedModel):
     class RecipePrototype(_GeneratedModel):
         """Type-checking stub for recipes."""
 else:
-    _generated_path = (
-        Path(__file__).resolve().parent / "generated" / "data_raw_models.py"
-    )
-    if not _generated_path.exists():
-        raise GeneratedModelsImportError(
-            _generated_path,
-            reason="Generated models not found",
-        )
-    _generated_root = _generated_path.parent.parent
-    if str(_generated_root) not in sys.path:
-        sys.path.insert(0, str(_generated_root))
     try:
-        _module = importlib.import_module("generated.data_raw_models")
+        from factorio_cycle_calculator.generated import (
+            data_raw_models as _module,
+        )
     except Exception as exc:
+        _generated_path = (
+            Path(__file__).resolve().parent / "generated" / "data_raw_models.py"
+        )
         raise GeneratedModelsImportError(
             _generated_path,
             reason="Failed to import generated models",