Composer API Extensions and How-To Guide

Composer API

This MR brings a first batch of extensions to the composer API, working toward #12

• constexpr, [[attributes]], static on functions / methods
• manually specified function parameter lists

Documentation

Extend documentation (toward #10 ):

• Introduce a monkeypatch module for running the SourceFileGenerator from MyST-notebooks and immediately printing the output into the markdown
• Installation Guide
• Getting Started Guide
• How-To Guide for the Composer
• Separate code generator configuration guide
• Clean up various remaining errors in the documentation and docstrings
• Configure documentation CI task to fail if Sphinx emits warnings

src/pystencilssfg/emission/file_printer.py

@@ -154,7 +154,10 @@ class SfgFilePrinter:
                 return code
 
             case SfgClassBody(cls, vblocks):
-                code = f"{cls.class_keyword} {cls.name} {{\n"
+                code = f"{cls.class_keyword} {cls.name}"
+                if cls.base_classes:
+                    code += " : " + ", ".join(cls.base_classes)
+                code += " {\n"
                 vblocks_str = [self._visibility_block(b) for b in vblocks]
                 code += "\n\n".join(vblocks_str)
                 code += "\n};\n"