[PCB Print][Added] Run table dependencies on-the-fly

- Added more info about how drill_pairs are generated
- Removed dead code in pre_include_table.py

Author: set-soft

CHANGELOG.md

@@ -29,6 +29,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   user defined CSSs might need some adjusts
 - Now when an output runs another outputs as dependencies the name of the
   created output is displayed.
+- When using `pcb_print` and including tables you no longer need to run the
+  output that generates the CSV first, it gets generated on-the-fly
 
 
 ## [1.9.0] - 2026-05-12

docs/samples/generic_plot.kibot.yaml

@@ -3609,6 +3609,9 @@ outputs:
           # You can also use it to generate pages with drill maps, in this case use `drill_pairs` here.
           # Note that in this case the `repeat_for_layer` should be some drawing layer, which might contain
           # a group used to insert the drill table (like in the `include_table` preflight).
+          # Note that the drill table needs an output that generates one or more CSV files and the group in the
+          # PCB must be named `kibot_table_OUTPUT_FOR_CSV_DRILLS`. See the `print_drill_table.kibot.yaml` example
+          # in the repo.
           # The drill map needs KiCad 7 or newer
           repeat_layers:
             # [string=''] Color used for this layer.

docs/source/Changelog.rst

@@ -55,6 +55,9 @@ Changed
    complex and user defined CSSs might need some adjusts
 -  Now when an output runs another outputs as dependencies the name of
    the created output is displayed.
+-  When using ``pcb_print`` and including tables you no longer need to
+   run the output that generates the CSV first, it gets generated
+   on-the-fly
 
 [1.9.0] - 2026-05-12
 --------------------

docs/source/configuration/outputs/PagesOptions.rst

@@ -37,6 +37,9 @@ PagesOptions parameters
    You can also use it to generate pages with drill maps, in this case use `drill_pairs` here. |br|
    Note that in this case the `repeat_for_layer` should be some drawing layer, which might contain
    a group used to insert the drill table (like in the `include_table` preflight). |br|
+   Note that the drill table needs an output that generates one or more CSV files and the group in the
+   PCB must be named `kibot_table_OUTPUT_FOR_CSV_DRILLS`. See the `print_drill_table.kibot.yaml` example
+   in the repo. |br|
    The drill map needs KiCad 7 or newer.
 -  ``sheet`` :index:`: <pair: output - pcb_print - options - pages; sheet>` [:ref:`string <string>`] (default: ``'Assembly'``) Text to use for the `SHEET` in the title block.
    Pattern (%*) and text variables are expanded. |br|

kibot/out_pcb_print.py

@@ -289,6 +289,9 @@ def __init__(self):
                 You can also use it to generate pages with drill maps, in this case use `drill_pairs` here.
                 Note that in this case the `repeat_for_layer` should be some drawing layer, which might contain
                 a group used to insert the drill table (like in the `include_table` preflight).
+                Note that the drill table needs an output that generates one or more CSV files and the group in the
+                PCB must be named `kibot_table_OUTPUT_FOR_CSV_DRILLS`. See the `print_drill_table.kibot.yaml` example
+                in the repo.
                 The drill map needs KiCad 7 or newer """
             self.repeat_inherit = True
             """ If we will inherit the options of the layer we are replacing.
@@ -1556,7 +1559,7 @@ def generate_output(self, output):
 
         # Update all tables
         if GS.ki7 and self._include_table_output:
-            update_table(self._include_table, self)
+            update_table(self._include_table, self, allow_run=True)
 
         # Generate the output, page by page
         pages = []
@@ -1566,7 +1569,7 @@ def generate_output(self, output):
                     g_drill_map = PCB_GROUP(GS.board)
                     self.add_drill_map_drawing(p, g_drill_map)
                     if GS.ki7 and self._include_table_output:
-                        update_table(self._include_table, self, p._drill_pair_index, True)
+                        update_table(self._include_table, self, p._drill_pair_index, True, allow_run=True)
             # Make visible only the layers we need
             # This is very important when scaling, otherwise the results are controlled by the .kicad_prl (See #407)
             if self.individual_page_scaling:

kibot/pre_include_table.py

@@ -15,7 +15,7 @@
                                      draw_marker, get_marker_best_pen_size,
                                      GR_TEXT_HJUSTIFY_LEFT, GR_TEXT_HJUSTIFY_RIGHT,
                                      GR_TEXT_HJUSTIFY_CENTER)
-from .kiplot import load_board, get_output_targets, look_for_output
+from .kiplot import load_board, get_output_targets, look_for_output, run_output
 from .misc import W_NOMATCHGRP
 from .optionable import Optionable
 from .registrable import RegOutput
@@ -265,11 +265,9 @@ def measure_table(cols, out, bold_headers, font=None):
         c.width = c.max_len/tot_len
 
 
-def update_table(ops, parent, force_index=-1, only_drill_tables=False):
+def update_table(ops, parent, force_index=-1, only_drill_tables=False, allow_run=False):
     logger.debug('Starting include table preflight')
     load_board()
-    csv_files = []
-    csv_name = []
     out_to_csv_mapping = {}
 
     logger.debug('- Analyzing requested outputs')
@@ -284,12 +282,9 @@ def update_table(ops, parent, force_index=-1, only_drill_tables=False):
         targets, _, o = get_output_targets(out.name, parent)
 
         csv_targets = [file for file in targets if file.endswith('.csv')]
-        for file in csv_targets:
-            csv_files.append(file)
-        for file in csv_targets:
-            file_name = os.path.basename(file)
-            name_without_ext = os.path.splitext(file_name)[0]
-            csv_name.append(name_without_ext)
+        # Run the output if any of the files is missing and we are allowed to run them
+        if any(not os.path.isfile(f) for f in csv_targets) and allow_run:
+            run_output(csv)
         out_to_csv_mapping[out.name] = (out, csv_targets, o.type)
         logger.debug(f'  - {out.name} -> {csv_targets}')