[Schematic][Added] Support for SHEETNAME, SHEETFILE and SHEETPATH in the title block

Author: set-soft

CHANGELOG.md

@@ -13,6 +13,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Some limited support for the VARIANT and VARIANT_DESC variables found
   in KiCad 10. They can be used for things like 3D and print_pcb even
   for KiCad 6.
+- Schematic:
+  - Support for SHEETNAME, SHEETFILE and SHEETPATH in the title block
 - Variants:
   - pre_transform filter to KiCad variants
 - E/DRC:

docs/source/Changelog.rst

@@ -27,6 +27,10 @@ Added
 -  Some limited support for the VARIANT and VARIANT_DESC variables found
    in KiCad 10. They can be used for things like 3D and print_pcb even
    for KiCad 6.
+-  Schematic:
+
+   -  Support for SHEETNAME, SHEETFILE and SHEETPATH in the title block
+
 -  Variants:
 
    -  pre_transform filter to KiCad variants

kibot/kicad/v6_sch.py

@@ -2416,29 +2416,33 @@ def _fill_missing_title_block(self):
     def _get_title_block(self, items):
         if not isinstance(items, list):
             raise SchError('The title block is not a list')
+        sheet_name = self.sheet_path_h.split('/')[-1]
+        if not sheet_name:
+            sheet_name = 'Root'
+        extra_vars = {'SHEETNAME': sheet_name, 'SHEETPATH': self.sheet_path_h, 'SHEETFILE': self.fname_rel}
         for item in items:
             if not isinstance(item, list) or len(item) < 2 or not isinstance(item[0], Symbol):
                 raise SchError('Wrong title block entry ({})'.format(item))
             i_type = item[0].value()
             if i_type == 'title':
                 self.title_ori = _check_str(item, 1, i_type)
-                self.title = GS.expand_text_variables(self.title_ori)
+                self.title = GS.expand_text_variables(self.title_ori, extra_vars=extra_vars)
             elif i_type == 'date':
                 self.date_ori = _check_str(item, 1, i_type)
-                self.date = GS.expand_text_variables(self.date_ori)
+                self.date = GS.expand_text_variables(self.date_ori, extra_vars=extra_vars)
             elif i_type == 'rev':
                 self.revision_ori = _check_str(item, 1, i_type)
-                self.revision = GS.expand_text_variables(self.revision_ori)
+                self.revision = GS.expand_text_variables(self.revision_ori, extra_vars=extra_vars)
             elif i_type == 'company':
                 self.company_ori = _check_str(item, 1, i_type)
-                self.company = GS.expand_text_variables(self.company_ori)
+                self.company = GS.expand_text_variables(self.company_ori, extra_vars=extra_vars)
             elif i_type == 'comment':
                 index = _check_integer(item, 1, i_type)
                 if index < 1 or index > 9:
                     raise SchError('Unsupported comment index {} in title block'.format(index))
                 value = _check_str(item, 2, i_type)
                 self.comment_ori[index-1] = value
-                self.comment[index-1] = GS.expand_text_variables(value)
+                self.comment[index-1] = GS.expand_text_variables(value, extra_vars=extra_vars)
             else:
                 raise SchError('Unsupported entry in title block ({})'.format(item))
         self._fill_missing_title_block()