auto commited

.hooks/kicad_cli_tools.py

@@ -11,7 +11,7 @@ from os import listdir
 from os.path import isfile, join
 
 KICAD_CLI_PATH = "kicad-cli"
-TEMP_FILE_PATH = "temp/"
+TEMP_FILE_PATH = "docs/"
 
 PCB_IMAGE_OUTPUT_PATH = "res/"
 
@@ -28,13 +28,20 @@ TEMP_DRC_REPORT_NAME = "_drc"
 TEMP_ERC_REPORT_NAME = "_erc"
 
 # quiet
-STDOUT=subprocess.DEVNULL
+KICAD_CLI_STDOUT=subprocess.DEVNULL
 # verbose
-# STDOUT=subprocess.STDOUT
+# KICAD_CLI_STDOUT=subprocess.STDOUT
 
 class OutputReportType(Enum):
     JSON = 1
-    RPT = 2
+    REPORT = 2
+
+    def get_file_extension(self) -> str:
+        match self:
+            case OutputReportType.JSON: return "json" 
+            case OutputReportType.REPORT: return "rpt"
+            # dont trust it
+            case _: return "txt"
 
 # this is a thin vale on the kicad cli tool
 class KicadProject:
@@ -49,16 +56,17 @@ class KicadProject:
     def erc_check(
         self, 
         report_format : OutputReportType = OutputReportType.JSON, 
-        return_report : bool = False
+        return_report : bool = False,
+        additional_args : str = ""
     ) -> None | dict | str:
         format_type = report_format.name.lower()
-        pcb_file_path = self.project_path / f"{self.project_name}.kicad_sch"
-        erc_report_path = Path(TEMP_FILE_PATH) / f"{self.project_name}{TEMP_ERC_REPORT_NAME}.{format_type}"
+        sch_file_path = self.project_path / f"{self.project_name}.kicad_sch"
+        erc_report_path = Path(TEMP_FILE_PATH) / f"{self.project_name}{TEMP_ERC_REPORT_NAME}.{report_format.get_file_extension()}"
         
         retcode = subprocess.call(
-            f'{KICAD_CLI_PATH} sch erc {pcb_file_path} --output {erc_report_path} --format {format_type}', 
+            f'{KICAD_CLI_PATH} sch erc {sch_file_path} --output {erc_report_path} --format {format_type} {additional_args}', 
             shell=True,
-            stdout=STDOUT
+            stdout=KICAD_CLI_STDOUT
         )
 
         if (retcode != 0):
@@ -77,17 +85,19 @@ class KicadProject:
     def drc_check(
         self, 
         report_format : OutputReportType = OutputReportType.JSON,
-        return_report : bool = False
+        return_report : bool = False,
+        additional_args : str = ""
     ) -> None | dict | str:
         format_type = report_format.name.lower()
         pcb_file_path = self.project_path / f"{self.project_name}.kicad_pcb"
-        drc_report_path = Path(TEMP_FILE_PATH) / f"{self.project_name}{TEMP_DRC_REPORT_NAME}.{format_type}"
+        drc_report_path = Path(TEMP_FILE_PATH) / f"{self.project_name}{TEMP_DRC_REPORT_NAME}.{report_format.get_file_extension()}"
+        print(f"{format_type=}, {drc_report_path=}")
         retcode = subprocess.call(
-            f'{KICAD_CLI_PATH} pcb drc {pcb_file_path} --output {drc_report_path} --format {format_type}', 
+            f'{KICAD_CLI_PATH} pcb drc {pcb_file_path} --output {drc_report_path} --format {format_type} {additional_args}', 
             shell=True,
-            stdout=STDOUT
+            stdout=KICAD_CLI_STDOUT
         )
-
+        print(f"{retcode=}")
         if (retcode != 0):
             print(f"drc check failed return code {retcode}")
             exit(1)
@@ -103,14 +113,15 @@ class KicadProject:
 
     def process_bom(
         self, 
-        return_csv : bool = False
+        return_csv : bool = False,
+        additional_args : str = ""
     ) -> None | list[list[str]]:
         sch_file_path = self.project_path / f"{self.project_name}.kicad_sch"
         bom_output_path = Path(BOM_OUTPUT_PATH) / f"{self.project_name}{BOM_REPORT_NAME}.csv"
         retcode = subprocess.call(
-            f'{KICAD_CLI_PATH} sch export bom {sch_file_path} --output {bom_output_path}', 
+            f'{KICAD_CLI_PATH} sch export bom {sch_file_path} --output {bom_output_path} {additional_args}', 
             shell=True,
-            stdout=STDOUT
+            stdout=KICAD_CLI_STDOUT
         )
 
         if (retcode != 0):
@@ -131,6 +142,7 @@ class KicadProject:
         background : str = "default",
         preset : str = "follow_pcb_editor",
         zoom : int = 2,
+        additional_args : str = ""
     ) -> None:
         """
             image_typ = "png" | "jpg"
@@ -140,9 +152,9 @@ class KicadProject:
         pcb_file_path = self.project_path / f"{self.project_name}.kicad_pcb"
         render_output_path = Path(PCB_IMAGE_OUTPUT_PATH) / f"{self.project_name}_render.{image_type}"
         retcode = subprocess.call(
-            f'{KICAD_CLI_PATH} pcb render {pcb_file_path} --output {render_output_path} --preset {preset} --zoom {zoom} ', 
+            f'{KICAD_CLI_PATH} pcb render {pcb_file_path} --output {render_output_path} --preset {preset} --zoom {zoom} {additional_args}', 
             shell=True,
-            stdout=STDOUT
+            stdout=KICAD_CLI_STDOUT
         )
 
         if (retcode != 0):
@@ -152,13 +164,13 @@ class KicadProject:
         self.created_files.append(render_output_path)
     
     # i am not giving you the pdf to output if you want to do that yourself go ahead
-    def create_schmatic_pdf(self) -> None:
+    def create_schmatic_pdf(self, additional_args="") -> None:
         sch_file_path = self.project_path / f"{self.project_name}.kicad_sch"
         sch_report_path = Path(SCHEMATIC_OUTPUT_PATH) / f"{self.project_name}{SCHEMATIC_FILE_SUFFIX}.pdf"
         retcode = subprocess.call(
-            f'{KICAD_CLI_PATH} sch export pdf {sch_file_path} --output {sch_report_path}', 
+            f'{KICAD_CLI_PATH} sch export pdf {sch_file_path} --output {sch_report_path} {additional_args}', 
             shell=True,
-            stdout=STDOUT
+            stdout=KICAD_CLI_STDOUT
         )
 
         if (retcode != 0):
@@ -167,13 +179,14 @@ class KicadProject:
         
         self.created_files.append(sch_report_path)
     
-    def create_pcb_pdf(self, layers : list[str] = ["F.Cu", "B.Cu"]) -> None:
+        
+    def create_pcb_pdf(self, layers : list[str] = ["F.Cu", "B.Cu"], additional_args : str = "") -> None:
         pcb_file_path = self.project_path / f"{self.project_name}.kicad_pcb"
         pcb_report_path = Path(PCB_PDF_OUTPUT_PATH) / f"{self.project_name}{PCB_PDF_FILE_SUFFIX}.pdf"
         retcode = subprocess.call(
-            f'{KICAD_CLI_PATH} pcb export pdf {pcb_file_path} --output {pcb_report_path} --layers {",".join(layers)}', 
+            f'{KICAD_CLI_PATH} pcb export pdf {pcb_file_path} --output {pcb_report_path} --layers {",".join(layers)} {additional_args}', 
             shell=True,
-            stdout=STDOUT
+            stdout=KICAD_CLI_STDOUT
         )
 
         if (retcode != 0):
@@ -189,13 +202,12 @@ def commit_files(files: list[Path], commit_message : str) -> None:
         ret_add = subprocess.call(f"git add {file}", shell=True)
         ret_commit = subprocess.call(f"git commit -m \"{commit_message}\"", shell=True)
 
-
 def main() -> None:
     # find all kicad project files to operate on
     for path in Path(".").rglob('*.kicad_pro'):
         k = KicadProject(path)
-        k.drc_check()
-        k.erc_check()
+        k.drc_check(report_format = OutputReportType.REPORT)
+        k.erc_check(report_format = OutputReportType.REPORT)
         k.process_bom()
         k.create_schmatic_pdf()
         k.get_image()

docs/test_drc.rpt

@@ -0,0 +1,13 @@
+** Drc report for test.kicad_pcb **
+** Created on 2026-02-18T17:38:29+1300 **
+
+** Found 1 DRC violations **
+[invalid_outline]: Board has malformed outline (no edges found on Edge.Cuts layer)
+    Local override; error
+    @(0.0000 mm, 0.0000 mm): PCB
+
+** Found 0 unconnected pads **
+
+** Found 0 Footprint errors **
+
+** End of Report **

docs/test_erc.rpt

@@ -0,0 +1,5 @@
+ERC report (2026-02-18T17:38:29+1300, Encoding UTF8)
+
+***** Sheet /
+
+ ** ERC messages: 0  Errors 0  Warnings 0

drc.json

@@ -1,26 +0,0 @@
-{
-    "$schema": "https://schemas.kicad.org/drc.v1.json",
-    "coordinate_units": "mm",
-    "date": "2025-12-31T01:11:53+1300",
-    "kicad_version": "9.0.6",
-    "schematic_parity": [],
-    "source": "test.kicad_pcb",
-    "unconnected_items": [],
-    "violations": [
-        {
-            "description": "Board has malformed outline (no edges found on Edge.Cuts layer)",
-            "items": [
-                {
-                    "description": "PCB",
-                    "pos": {
-                        "x": 0.0,
-                        "y": 0.0
-                    },
-                    "uuid": "7690956f-7cf1-4850-b24e-2c34f81a5616"
-                }
-            ],
-            "severity": "error",
-            "type": "invalid_outline"
-        }
-    ]
-}