Refactor collection of header files. Refactor C++ data type modelling. Extend generator script test suite.

This rather large MR introduces a number of changes to header file collection, C++ type modelling and the lang.cpp API, and the generator script test suite.

Header file collection

This MR simplifies and clarifies the way information about required header files is modelled and collected by the SFG.

• Remove required_headers properties from AugExpr and SfgVar
• Introduce HeaderFile typeclass to model header files
• For variables, attach all header information to their data type; introduce CppType and the cpptype utility to simplify creating C++ type classes and specifying their associated headers
• Have DependentExpression track required headers in the same way as variables; introduce includes() query to collect header files form all ExprLike alternatives
• Update ir.call_tree nodes to allow dynamic tracking of headers
• Update composer to transfer header information from AugExprs to the IR where required
• Update header collection to include headers for constructor and function parameters

C++ types and API Mirror

We clean up and refactor the C++ API mirror in accordance to the above changes.

• Deprecate all std_<field type>_ref factory functions in favor of <>.from_field() static methods
• Refactor C++ STL AugExpr classes to use the cpptype utility
• Refactor exposition of STL classes through lang.cpp.std

Generator Script Test Suite

The generator script test suite is heavily refactored and extended to become the primary testing driver for pystencils-sfg.

• Introduce a YAML index file to define and configure all generator script tests
• Remove static output checking against files in expected folder in favor of regex-based checks
• Introduce test harnesses that are compiled against generated code and executed to check correctness dynamically

src/pystencilssfg/lang/cpp/std_mdspan.py

@@ -29,6 +29,7 @@ class StdMdspan(SrcField):
         extents: tuple[int | str, ...],
         extents_type: PsType = PsUnsignedIntegerType(64),
         ref: bool = False,
+        const: bool = False,
         experimental: bool = True,
     ):
         T = create_type(T)
@@ -39,9 +40,9 @@ class StdMdspan(SrcField):
         )
 
         if experimental:
-            dtype = self._template_experimental(T=T, extents=extents_str)
+            dtype = self._template_experimental(T=T, extents=extents_str, const=const)
         else:
-            dtype = self._template(T=T, extents=extents_str)
+            dtype = self._template(T=T, extents=extents_str, const=const)
 
         if ref:
             dtype = Ref(dtype)
@@ -73,7 +74,7 @@ class StdMdspan(SrcField):
 
     @staticmethod
     def from_field(
-        field: Field, extents_type: PsType = PsUnsignedIntegerType(64), ref: bool = False
+        field: Field, extents_type: PsType = PsUnsignedIntegerType(64), ref: bool = False, const: bool = False,
     ):
         """Creates a `std::mdspan` instance for a given pystencils field."""
         from pystencils.field import layout_string_to_tuple
@@ -98,6 +99,7 @@ class StdMdspan(SrcField):
             tuple(extents),
             extents_type=extents_type,
             ref=ref,
+            const=const
         ).var(field.name)