feat(04-01): implement script_generator with install.ps1.j2 template

- Jinja2 Environment with FileSystemLoader, trim_blocks, lstrip_blocks - render_install() with _duplex_map (LongEdge->TwoSidedLongEdge, ShortEdge->TwoSidedShortEdge) - install.ps1.j2: WOW64 guard as first block (SCRPT-05) - install.ps1.j2: SYSTEM/admin detection + UAC self-elevation (SCRPT-04) - install.ps1.j2: pnputil two-step driver staging + Add-PrinterDriver (SCRPT-01) - install.ps1.j2: idempotent port creation (Get-PrinterPort check) - install.ps1.j2: idempotent printer creation (Get-Printer check) - install.ps1.j2: Set-PrintConfiguration with duplex/color/paper/collate - All 7 unit tests pass
2026-04-10 13:31:51 +02:00
parent b4f2c64161
commit 8193e9dbbd
2 changed files with 132 additions and 0 deletions
@@ -0,0 +1,65 @@
+"""Script generator module — renders PowerShell scripts from Jinja2 templates.
+
+Provides render_install() which produces a complete PowerShell install script
+containing WOW64 guard, UAC self-elevation, pnputil two-step driver staging,
+idempotent port/printer creation, and Set-PrintConfiguration with duplex mapping.
+"""
+from pathlib import Path
+
+from jinja2 import Environment, FileSystemLoader
+
+_SCRIPTS_DIR = Path(__file__).parent.parent / "templates" / "scripts"
+
+_env = Environment(
+    loader=FileSystemLoader(str(_SCRIPTS_DIR)),
+    trim_blocks=True,
+    lstrip_blocks=True,
+    keep_trailing_newline=True,
+)
+
+_duplex_map = {
+    "OneSided": "OneSided",
+    "LongEdge": "TwoSidedLongEdge",
+    "ShortEdge": "TwoSidedShortEdge",
+}
+
+
+def render_install(
+    printer_name: str,
+    ip_address: str,
+    port_name: str,
+    driver_name: str,
+    inf_filename: str,
+    duplex_mode: str,
+    color_mode: bool,
+    paper_size: str,
+    collate: bool,
+) -> str:
+    """Render install.ps1.j2 with the given printer configuration.
+
+    Args:
+        printer_name: Display name of the printer.
+        ip_address: IP address for the printer TCP/IP port.
+        port_name: Port name (e.g. "IP_192.168.1.10").
+        driver_name: Exact driver name as registered in Windows.
+        inf_filename: INF filename inside the drivers/ subfolder.
+        duplex_mode: One of "OneSided", "LongEdge", "ShortEdge" (model values).
+        color_mode: True for color printing, False for mono.
+        paper_size: Paper size string (e.g. "A4", "Letter").
+        collate: True to enable collation.
+
+    Returns:
+        Rendered PowerShell script as a string.
+    """
+    tpl = _env.get_template("install.ps1.j2")
+    return tpl.render(
+        printer_name=printer_name,
+        ip_address=ip_address,
+        port_name=port_name,
+        driver_name=driver_name,
+        inf_filename=inf_filename,
+        duplex_mode=_duplex_map.get(duplex_mode, duplex_mode),
+        color=str(color_mode).lower(),
+        paper_size=paper_size,
+        collate=str(collate).lower(),
+    )