aas-core-codegen 0.0.22__tar.gz → 0.0.24__tar.gz

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/AUTHORS

@@ -7,3 +7,4 @@ Marko Ristin (marko@ristin.ch, marko.ristin@gmail.com, rist@zhaw.ch) for Zurich
 Sebastian Heppner (s.heppner@iat.rwth-aachen.de) for RWTH Aachen
 Markus Böhm (Markus.Boehm@conplement.de) for conplement AG
 Tobias Langer (Tobias.Langer@conplement.de) for conplement AG
+Aaron Zielstorff (aaron.zielstorff@iese.fraunhofer.de) for Fraunhofer Institute for Experimental Software Engineering (IESE)

{aas_core_codegen-0.0.22/aas_core_codegen.egg-info → aas_core_codegen-0.0.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aas-core-codegen
-Version: 0.0.22
+Version: 0.0.24
 Summary: Generate implementations and schemas based on an AAS meta-model.
 Author-email: Marko Ristin <marko@ristin.ch>, Nico Braunisch <nico.braunisch@tu-dresden.de>
 License: MIT
@@ -20,8 +20,9 @@ Requires-Dist: asttokens<3,>=2.0.8
 Requires-Dist: icontract<3,>=2.7.3
 Requires-Dist: sortedcontainers<3,>=2.4.0
 Requires-Dist: docutils==0.22.3
-Requires-Dist: more-itertools<9,>=8
+Requires-Dist: more-itertools==10.8.0
 Requires-Dist: greenery==4.1.0
+Requires-Dist: typing_extensions>=4.0
 Dynamic: license-file
 
 ****************
@@ -165,7 +166,7 @@ Call the generator with the appropriate target:
 
     usage: aas-core-codegen [-h] --model_path MODEL_PATH --snippets_dir
                             SNIPPETS_DIR --output_dir OUTPUT_DIR --target
-                            {csharp,cpp,golang,java,jsonschema,python,typescript,rdf_shacl,xsd,jsonld_context,protobuf,python_protobuf,opcua}
+                            {cpp,csharp,golang,java,jsonschema,python,typescript,xsd}
                             [--cache_model] [--version]
 
     Generate implementations and schemas based on an AAS meta-model.
@@ -179,7 +180,7 @@ Call the generator with the appropriate target:
                             specific code snippets
       --output_dir OUTPUT_DIR
                             path to the generated code
-      --target {csharp,cpp,golang,java,jsonschema,python,typescript,rdf_shacl,xsd,jsonld_context,protobuf,python_protobuf,opcua}
+      --target {cpp,csharp,golang,java,jsonschema,python,typescript,xsd}
                             target language or schema
       --cache_model         If set, cache the parsed meta-model in the temporary
                             directory of your OS. This makes the repeated runs

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/README.rst

@@ -139,7 +139,7 @@ Call the generator with the appropriate target:
 
     usage: aas-core-codegen [-h] --model_path MODEL_PATH --snippets_dir
                             SNIPPETS_DIR --output_dir OUTPUT_DIR --target
-                            {csharp,cpp,golang,java,jsonschema,python,typescript,rdf_shacl,xsd,jsonld_context,protobuf,python_protobuf,opcua}
+                            {cpp,csharp,golang,java,jsonschema,python,typescript,xsd}
                             [--cache_model] [--version]
 
     Generate implementations and schemas based on an AAS meta-model.
@@ -153,7 +153,7 @@ Call the generator with the appropriate target:
                             specific code snippets
       --output_dir OUTPUT_DIR
                             path to the generated code
-      --target {csharp,cpp,golang,java,jsonschema,python,typescript,rdf_shacl,xsd,jsonld_context,protobuf,python_protobuf,opcua}
+      --target {cpp,csharp,golang,java,jsonschema,python,typescript,xsd}
                             target language or schema
       --cache_model         If set, cache the parsed meta-model in the temporary
                             directory of your OS. This makes the repeated runs

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/__init__.py

@@ -1,6 +1,6 @@
 """Generate implementations and schemas based on an AAS meta-model."""
 
-__version__ = "0.0.22"
+__version__ = "0.0.24"
 __author__ = "Marko Ristin, Nico Braunisch"
 __license__ = "License :: OSI Approved :: MIT License"
 __status__ = "Production/Stable"

aas_core_codegen-0.0.24/aas_core_codegen/cpp/__init__.py

@@ -0,0 +1 @@
+"""Generate C++ code based on the meta-model."""

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/common.py

@@ -631,7 +631,7 @@ def generate_include_prefix_path(library_namespace: Stripped) -> Stripped:
 
 def generate_namespace_opening(library_namespace: Stripped) -> Stripped:
     """
-    Generate the code to open the nested library namespace.
+    Generate code to open the nested library namespace.
 
     >>> generate_namespace_opening(Stripped("some::name::space"))
     'namespace some {\\nnamespace name {\\nnamespace space {'
@@ -642,7 +642,7 @@ def generate_namespace_opening(library_namespace: Stripped) -> Stripped:
 
 def generate_namespace_closing(library_namespace: Stripped) -> Stripped:
     """
-    Generate the code to close the nested library namespace.
+    Generate code to close the nested library namespace.
 
     >>> generate_namespace_closing(Stripped("some::name::space"))
     '}  // namespace space\\n}  // namespace name\\n}  // namespace some'

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/lib/_generate_common.py

@@ -1,4 +1,4 @@
-"""Generate code of common functions used across other modules."""
+"""Generate code of common functionality."""
 
 # pylint: disable=line-too-long
 
@@ -151,7 +151,7 @@ def _generate_concatenate_implementations_for_2_parts_and_above() -> List[Stripp
 )
 # fmt: on
 def generate_header(library_namespace: Stripped) -> str:
-    """Generate header of common functions used across other modules."""
+    """Generate header of common functionality."""
     namespace = Stripped(f"{library_namespace}")
 
     include_guard_var = cpp_common.include_guard_var(namespace)
@@ -486,7 +486,7 @@ std::wstring Utf8ToWstring(const std::string& utf8_text);"""
 )
 # fmt: on
 def generate_implementation(library_namespace: Stripped) -> str:
-    """Generate implementation of common functions used across other modules."""
+    """Generate implementation of common functionality."""
     namespace = Stripped(f"{library_namespace}::{cpp_common.COMMON_NAMESPACE}")
 
     include_prefix_path = cpp_common.generate_include_prefix_path(library_namespace)

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/lib/_generate_constants.py

@@ -1,4 +1,4 @@
-"""Generate code of constants based on the constants of the meta-model."""
+"""Generate code to define the constants of the meta-model."""
 import io
 from typing import (
     Optional,
@@ -375,7 +375,7 @@ def generate_header(
     symbol_table: intermediate.SymbolTable,
     library_namespace: Stripped,
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
-    """Generate header of constants based on the constants of the meta-model."""
+    """Generate header to define the constants of the meta-model."""
     errors = []  # type: List[Error]
 
     namespace = Stripped(f"{library_namespace}::{cpp_common.CONSTANTS_NAMESPACE}")
@@ -486,7 +486,7 @@ def generate_implementation(
     symbol_table: intermediate.SymbolTable,
     library_namespace: Stripped,
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
-    """Generate implementation of constants based on the constants of the meta-model."""
+    """Generate implementation to define the constants of the meta-model."""
     errors = []  # type: List[Error]
 
     namespace = Stripped(f"{library_namespace}::constants")

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/lib/_generate_enhancing.py

@@ -1,4 +1,4 @@
-"""Generate code for wrapping model classes with custom enhancements."""
+"""Generate code for enhancing model classes."""
 
 import io
 from typing import Tuple, Optional, List, Sequence
@@ -886,7 +886,7 @@ def generate_header(
     symbol_table: intermediate.SymbolTable,
     library_namespace: Stripped,
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
-    """Generate header for wrapping model classes with custom enhancements."""
+    """Generate header for enhancing model classes."""
     namespace = Stripped(f"{library_namespace}::enhancing")
 
     include_guard_var = cpp_common.include_guard_var(namespace)

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/lib/_generate_jsonization.py

@@ -1,4 +1,4 @@
-"""Generate code for de/serialization of instances from and to JSON."""
+"""Generate code for JSON de/serialization."""
 
 import io
 import itertools
@@ -69,7 +69,7 @@ common::expected<
 def generate_header(
     symbol_table: intermediate.SymbolTable, library_namespace: Stripped
 ) -> str:
-    """Generate header for de/serialization of instances from and to JSON."""
+    """Generate header for JSON de/serialization."""
     namespace = Stripped(f"{library_namespace}::{cpp_common.JSONIZATION_NAMESPACE}")
 
     include_guard_var = cpp_common.include_guard_var(namespace)
@@ -2091,7 +2091,7 @@ if (error.has_value()) {{
 }}
 
 result[{json_prop_name_literal}] = std::move(
-{I}{serialized_var}
+{I}{serialized_var}.value()
 );"""
         )
     elif primitive_type is intermediate.PrimitiveType.FLOAT:
@@ -2121,7 +2121,7 @@ result[{json_prop_name_literal}] = stringification::Base64Encode(
 
 
 def _generate_serialize_property(prop: intermediate.Property) -> Stripped:
-    """Generate the code snippet to serialize the property ``prop``."""
+    """Generate code snippet to serialize the property ``prop``."""
     type_anno = intermediate.beneath_optional(prop.type_annotation)
 
     code = None  # type: Optional[Stripped]
@@ -2483,7 +2483,7 @@ def generate_implementation(
     spec_impls: specific_implementations.SpecificImplementations,
     library_namespace: Stripped,
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
-    """Generate implementation for de/serialization of instances from and to JSON."""
+    """Generate implementation for JSON de/serialization."""
     namespace = Stripped(f"{library_namespace}::{cpp_common.JSONIZATION_NAMESPACE}")
 
     include_prefix_path = cpp_common.generate_include_prefix_path(library_namespace)

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/lib/_generate_stringification.py

@@ -1,4 +1,4 @@
-"""Generate code to de/stringify enumerations and primitives."""
+"""Generate code for string de/serialization of enumerations."""
 
 import io
 from typing import List
@@ -831,7 +831,7 @@ common::expected<
 def generate_header(
     symbol_table: intermediate.SymbolTable, library_namespace: Stripped
 ) -> str:
-    """Generate header to de/stringify enumerations and primitives."""
+    """Generate header for string de/serialization of enumerations."""
     namespace = Stripped(f"{library_namespace}::stringification")
 
     include_guard_var = cpp_common.include_guard_var(namespace)
@@ -905,7 +905,7 @@ namespace stringification {"""
 def generate_implementation(
     symbol_table: intermediate.SymbolTable, library_namespace: Stripped
 ) -> str:
-    """Generate implementation to de/stringify enumerations and primitives."""
+    """Generate implementation for string de/serialization of enumerations."""
     namespace = Stripped(f"{library_namespace}::stringification")
 
     include_prefix_path = cpp_common.generate_include_prefix_path(library_namespace)

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/lib/_generate_visitation.py

@@ -268,7 +268,7 @@ switch (that->model_type()) {{
 def _generate_mutating_abstract_visitor_implementation(
     symbol_table: intermediate.SymbolTable,
 ) -> List[Stripped]:
-    """Generate C++ implementation of the visitor's method(s)."""
+    """Generate implementation of the visitor's method(s)."""
     switch_stmt = _generate_dispatching_visit_switch_statement(
         symbol_table=symbol_table
     )
@@ -422,7 +422,7 @@ def _generate_pass_through_visit_body_for_class(
 def _generate_mutating_pass_through_visitor_implementation(
     symbol_table: intermediate.SymbolTable,
 ) -> List[Stripped]:
-    """Generate C++ implementation of the visitor's method(s)."""
+    """Generate implementation of the visitor's method(s)."""
     blocks = [
         Stripped("// region PassThroughVisitor"),
     ]

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/lib/_generate_wstringification.py

@@ -1,4 +1,4 @@
-"""Generate code to de/wstringify enumerations and primitives."""
+"""Generate code for wstring de/serialization of enumerations."""
 
 import io
 from typing import List
@@ -467,7 +467,7 @@ std::wstring to_wstring(
 def generate_header(
     symbol_table: intermediate.SymbolTable, library_namespace: Stripped
 ) -> str:
-    """Generate header to de/wstringify enumerations and primitives."""
+    """Generate header for wstring de/serialization of enumerations."""
     namespace = Stripped(f"{library_namespace}::wstringification")
 
     include_guard_var = cpp_common.include_guard_var(namespace)
@@ -543,7 +543,7 @@ namespace wstringification {"""
 def generate_implementation(
     symbol_table: intermediate.SymbolTable, library_namespace: Stripped
 ) -> str:
-    """Generate implementation to de/wstringify enumerations and primitives."""
+    """Generate implementation for wstring de/serialization of enumerations."""
     namespace = Stripped(f"{library_namespace}::wstringification")
 
     include_prefix_path = cpp_common.generate_include_prefix_path(library_namespace)

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/lib/_generate_xmlization.py

@@ -1,4 +1,4 @@
-"""Generate code for de/serialization of instances from XML."""
+"""Generate code for XML de/serialization."""
 
 import io
 from typing import List, Tuple, Optional, Sequence
@@ -88,7 +88,7 @@ common::expected<
 def generate_header(
     symbol_table: intermediate.SymbolTable, library_namespace: Stripped
 ) -> str:
-    """Generate header for de/serialization of instances from XML."""
+    """Generate header for XML de/serialization."""
     namespace = Stripped(f"{library_namespace}::{cpp_common.XMLIZATION_NAMESPACE}")
 
     include_guard_var = cpp_common.include_guard_var(namespace)
@@ -4440,7 +4440,7 @@ if (writer.error().has_value()) {{
 def _generate_serialize_instance(
     cls: intermediate.ClassUnion, var_name: Identifier
 ) -> Stripped:
-    """Generate the code to serialize an instance at ``var_name``."""
+    """Generate code to serialize an instance at ``var_name``."""
     serialize_function: Identifier
     if len(cls.concrete_descendants) == 0:
         serialize_function = cpp_naming.function_name(
@@ -4511,7 +4511,7 @@ for (size_t i = 0; i < {var_name}.size(); ++i) {{
 
 
 def _generate_serialize_property(prop: intermediate.Property) -> Stripped:
-    """Generate the code to serialize a property."""
+    """Generate code to serialize a property."""
     blocks = []  # type: List[Stripped]
 
     getter_name = cpp_naming.getter_name(prop.name)
@@ -5138,7 +5138,7 @@ def generate_implementation(
     spec_impls: specific_implementations.SpecificImplementations,
     library_namespace: Stripped,
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
-    """Generate implementation for de/serialization of instances from XML."""
+    """Generate implementation for XML de/serialization."""
     namespace = Stripped(f"{library_namespace}::{cpp_common.XMLIZATION_NAMESPACE}")
 
     include_prefix_path = cpp_common.generate_include_prefix_path(library_namespace)

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/main.py

@@ -1,14 +1,15 @@
-"""Generate C++ code to handle models based on the meta-model."""
+"""Generate C++ code based on the meta-model."""
+
 import pathlib
 from typing import TextIO, Sequence, Tuple, Callable, Optional, List
 
-from aas_core_codegen import run, intermediate, specific_implementations
+from aas_core_codegen import run, intermediate, specific_implementations, cpp
 from aas_core_codegen.common import Stripped, Error
 from aas_core_codegen.cpp import lib as cpp_lib, tests as cpp_tests
 
 
 def execute(context: run.Context, stdout: TextIO, stderr: TextIO) -> int:
-    """Generate the code."""
+    """Generate code."""
     verified_ir_table, errors = cpp_lib.verify_for_types(
         symbol_table=context.symbol_table
     )
@@ -512,3 +513,6 @@ def execute(context: run.Context, stdout: TextIO, stderr: TextIO) -> int:
 
     stdout.write(f"Code generated to: {context.output_dir}\n")
     return 0
+
+
+assert cpp.__doc__ == __doc__

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/tests/_generate_common.py

@@ -573,37 +573,6 @@ std::wstring TraceMark(
 {I}const std::wstring model_type = aas::wstringification::to_wstring(
 {II}that.model_type()
 {I});
-
-{I}if ({library_namespace}::types::IsIdentifiable(that)) {{
-{II}const auto& identifiable(
-{III}dynamic_cast<const aas::types::IIdentifiable&>(that)
-{II});
-
-{II}return aas::common::Concat(
-{III}model_type,
-{III}L" with ID ",
-{III}identifiable.id()
-{II});
-{I}}}
-
-{I}if ({library_namespace}::types::IsReferable(that)) {{
-{II}const auto& referable(
-{III}dynamic_cast<const aas::types::IReferable&>(that)
-{II});
-
-{II}if (referable.id_short().has_value()) {{
-{III}return aas::common::Concat(
-{IIII}model_type,
-{IIII}L" with ID-short ",
-{IIII}*(referable.id_short())
-{III});
-{II}}}
-{II}return aas::common::Concat(
-{III}model_type,
-{III}L" with unspecified ID-short"
-{II});
-{I}}}
-
 {I}return model_type;
 }}"""
         ),

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/tests/_generate_test_jsonization_of_concrete_classes.py

@@ -1,4 +1,4 @@
-"""Generate code to test the jsonization of concrete classes."""
+"""Generate code to test the JSON de/serialization of concrete classes."""
 
 import io
 from typing import List
@@ -30,7 +30,7 @@ from aas_core_codegen.cpp.common import (
 def generate_implementation(
     symbol_table: intermediate.SymbolTable, library_namespace: Stripped
 ) -> str:
-    """Generate implementation to test the jsonization of concrete classes."""
+    """Generate implementation to test the JSON de/serialization of concrete classes."""
     include_prefix_path = cpp_common.generate_include_prefix_path(library_namespace)
 
     blocks = [

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/tests/_generate_test_verification.py

@@ -1,4 +1,4 @@
-"""Generate code to test the verification of the pos. and neg. cases."""
+"""Generate code to test the verification of pos. and neg. cases."""
 
 import io
 from typing import List
@@ -30,7 +30,7 @@ from aas_core_codegen.cpp.common import (
 def generate_implementation(
     symbol_table: intermediate.SymbolTable, library_namespace: Stripped
 ) -> str:
-    """Generate implementation to test the verification of the pos. and neg. cases."""
+    """Generate implementation to test the verification of pos. and neg. cases."""
     include_prefix_path = cpp_common.generate_include_prefix_path(library_namespace)
 
     blocks = [

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/tests/_generate_test_xmlization_of_concrete_classes.py

@@ -1,4 +1,4 @@
-"""Generate code to test the XML de-serialization of concrete classes."""
+"""Generate code to test the XML de/serialization of concrete classes."""
 import io
 from typing import List
 
@@ -28,7 +28,7 @@ from aas_core_codegen.cpp.common import (
 def generate_implementation(
     symbol_table: intermediate.SymbolTable, library_namespace: Stripped
 ) -> str:
-    """Generate implementation to test the XML de-serialization of concrete classes."""
+    """Generate implementation to test the XML de/serialization of concrete classes."""
     include_prefix_path = cpp_common.generate_include_prefix_path(library_namespace)
 
     blocks = [

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/transpilation.py

@@ -332,7 +332,7 @@ class Transpiler(
     def _transform_enumeration_literal(
         self, enumeration_name: Identifier, literal_name: Identifier
     ) -> Stripped:
-        """Generate the code to represent an enumeration literal."""
+        """Generate code to represent an enumeration literal."""
         cpp_enum_name = cpp_naming.enum_name(enumeration_name)
         cpp_literal_name = cpp_naming.enum_literal_name(literal_name)
         if self._types_namespace is not None:

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/cpp/yielding.py

@@ -137,7 +137,7 @@ def generate_execute_body(
     flow: Sequence[yielding_flow.Node], state_member: Identifier
 ) -> Stripped:
     """
-    Generate the code of the ``Execute()`` method which executes the flow with yields.
+    Generate code of the ``Execute()`` method which executes the flow with yields.
 
     The member that holds the state to be executed is indicated by ``state_member``.
     Both the state member and the ``Execute()`` method are usually private.

aas_core_codegen-0.0.24/aas_core_codegen/csharp/__init__.py

@@ -0,0 +1 @@
+"""Generate C# code based on the meta-model."""

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/csharp/lib/_generate_constants.py

@@ -1,4 +1,5 @@
-"""Generate the C# constants corresponding to the constants of the meta-model."""
+"""Generate code to define the constants of the meta-model."""
+
 import io
 import textwrap
 from typing import (
@@ -276,7 +277,7 @@ def generate(
     namespace: csharp_common.NamespaceIdentifier,
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
     """
-    Generate the C# code of the constants based on the symbol table.
+    Generate code to define the constants of the meta-model.
 
     The ``namespace`` defines the AAS C# namespace.
     """
@@ -401,3 +402,7 @@ namespace {namespace}
     out.write("\n")
 
     return out.getvalue(), None
+
+
+assert generate.__doc__ is not None
+assert generate.__doc__.strip().startswith(__doc__)

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/csharp/lib/_generate_copying.py

@@ -1,4 +1,4 @@
-"""Generate C# code for copying in memory based on the intermediate representation."""
+"""Generate code for copying instances in memory."""
 
 import io
 import textwrap
@@ -367,7 +367,7 @@ def generate(
     spec_impls: specific_implementations.SpecificImplementations,
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
     """
-    Generate the C# code for copying instances in memory.
+    Generate code for copying instances in memory.
 
     The ``namespace`` defines the AAS C# namespace.
     """
@@ -498,3 +498,7 @@ namespace {namespace}
     writer.write("\n")
 
     return writer.getvalue(), None
+
+
+assert generate.__doc__ is not None
+assert generate.__doc__.strip().startswith(__doc__.strip())

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/csharp/lib/_generate_enhancing.py

@@ -1,4 +1,4 @@
-"""Generate C# code for enhancing model classes."""
+"""Generate code for enhancing model classes."""
 
 import io
 import textwrap
@@ -442,7 +442,7 @@ def generate(
     spec_impls: specific_implementations.SpecificImplementations,
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
     """
-    Generate the C# code for enhancing model classes with custom wraps.
+    Generate code for enhancing model classes.
 
     The ``namespace`` defines the AAS C# namespace.
     """
@@ -665,3 +665,7 @@ namespace {namespace}
     out.write("\n")
 
     return out.getvalue(), None
+
+
+assert generate.__doc__ is not None
+assert generate.__doc__.strip().startswith(__doc__.strip())

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/csharp/lib/_generate_jsonization.py

@@ -1,4 +1,4 @@
-"""Generate C# code for JSON-ization based on the intermediate representation."""
+"""Generate code for JSON de/serialization."""
 
 import io
 import textwrap
@@ -1509,7 +1509,7 @@ def generate(
     spec_impls: specific_implementations.SpecificImplementations,
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
     """
-    Generate the C# code for the general serialization.
+    Generate code for JSON de/serialization.
 
     The ``namespace`` defines the AAS C# namespace.
     """
@@ -1628,3 +1628,7 @@ using System.Collections.Generic;  // can't alias"""
     writer.write("\n")
 
     return writer.getvalue(), None
+
+
+assert generate.__doc__ is not None
+assert generate.__doc__.strip().startswith(__doc__.strip())

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/csharp/lib/_generate_reporting.py

@@ -1,4 +1,4 @@
-"""Generate C# code for reporting errors by including the code directly."""
+"""Generate code for reporting errors."""
 
 import io
 import textwrap
@@ -31,7 +31,7 @@ from aas_core_codegen.csharp.common import (
 # fmt: on
 def generate(namespace: csharp_common.NamespaceIdentifier) -> str:
     """
-    Generate the C# code for reporting errors.
+    Generate code for reporting errors.
 
     The ``namespace`` defines the AAS C# namespace.
     """
@@ -264,3 +264,7 @@ using System.Collections.Generic;  // can't alias"""
     writer.write("\n")
 
     return writer.getvalue()
+
+
+assert generate.__doc__ is not None
+assert generate.__doc__.strip().startswith(__doc__.strip())

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/csharp/lib/_generate_stringification.py

@@ -1,4 +1,4 @@
-"""Generate C# code for de/serialization based on the intermediate representation."""
+"""Generate code for string de/serialization of enumerations."""
 
 import io
 import textwrap
@@ -176,7 +176,7 @@ def generate(
     symbol_table: intermediate.SymbolTable, namespace: csharp_common.NamespaceIdentifier
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
     """
-    Generate the C# code for the general serialization.
+    Generate code for string de/serialization of enumerations.
 
     The ``namespace`` defines the AAS C# namespace.
     """
@@ -241,3 +241,7 @@ namespace {namespace}
     out.write("\n")
 
     return out.getvalue(), None
+
+
+assert generate.__doc__ is not None
+assert generate.__doc__.strip().startswith(__doc__.strip())

{aas_core_codegen-0.0.22 → aas_core_codegen-0.0.24}/aas_core_codegen/csharp/lib/_generate_types.py

@@ -1,4 +1,4 @@
-"""Generate the C# data structures from the intermediate representation."""
+"""Generate code of the data structures representing the meta-model."""
 import io
 import textwrap
 from typing import (
@@ -267,7 +267,7 @@ def verify(
 def _generate_enum(
     enum: intermediate.Enumeration,
 ) -> Tuple[Optional[Stripped], Optional[Error]]:
-    """Generate the C# code for the enum."""
+    """Generate code for the enum."""
     writer = io.StringIO()
 
     if enum.description is not None:
@@ -334,7 +334,7 @@ def _generate_enum(
 def _generate_interface(
     cls: intermediate.ClassUnion,
 ) -> Tuple[Optional[Stripped], Optional[Error]]:
-    """Generate C# interface for the given class ``cls``."""
+    """Generate interface for the given class ``cls``."""
     writer = io.StringIO()
 
     if cls.description is not None:
@@ -731,7 +731,7 @@ public IEnumerable<IClass> Descend()
 
 
 def _generate_default_value(default: intermediate.Default) -> Stripped:
-    """Generate the C# code representing the default value of an argument."""
+    """Generate code representing the default value of an argument."""
     code = None  # type: Optional[str]
 
     if default is not None:
@@ -871,7 +871,7 @@ def _generate_class(
     cls: intermediate.ConcreteClass,
     spec_impls: specific_implementations.SpecificImplementations,
 ) -> Tuple[Optional[Stripped], Optional[Error]]:
-    """Generate C# code for the given concrete class ``cls``."""
+    """Generate code for the given concrete class ``cls``."""
     # Code blocks to be later joined by double newlines and indented once
     blocks = []  # type: List[Stripped]
 
@@ -1152,7 +1152,7 @@ def generate(
     spec_impls: specific_implementations.SpecificImplementations,
 ) -> Tuple[Optional[str], Optional[List[Error]]]:
     """
-    Generate the C# code of the structures based on the symbol table.
+    Generate code of the data structures representing the meta-model.
 
     The ``namespace`` defines the AAS C# namespace.
     """
@@ -1339,3 +1339,6 @@ namespace {namespace}
 
 
 # endregion
+
+assert generate.__doc__ is not None
+assert generate.__doc__.strip().startswith(__doc__.strip())