m2isar.frontends.coredsl2.source_semantics ========================================== .. py:module:: m2isar.frontends.coredsl2.source_semantics .. autoapi-nested-parse:: Source semantic validation before simplification and model lowering. Keeps ISA parameter values separate for each root ISA and preserves block scope. Currently models integers, arrays, address spaces and function signatures; unknown composite/pointer/intrinsic types are explicitly deferred. Attributes ---------- .. autoapisummary:: m2isar.frontends.coredsl2.source_semantics.logger Classes ------- .. autoapisummary:: m2isar.frontends.coredsl2.source_semantics.DslSymbol m2isar.frontends.coredsl2.source_semantics.SemanticValidator Functions --------- .. autoapisummary:: m2isar.frontends.coredsl2.source_semantics.reference m2isar.frontends.coredsl2.source_semantics.invalid_elaboration_summaries m2isar.frontends.coredsl2.source_semantics.validate_semantics Module Contents --------------- .. py:data:: logger .. py:class:: DslSymbol Source validator view of a declared name, typed with a DslType. Not to be confused with ``arch.Symbol``: a DslSymbol exists before and alongside the model. When it is built from an existing model object (``arch.Symbol`` or ``arch.Parameter``), ``model`` refers to that object. .. py:attribute:: declaration :type: object :value: None .. py:attribute:: declarator :type: object :value: None .. py:attribute:: ty :type: m2isar.frontends.coredsl2.source_types.DslType :value: None .. py:attribute:: storage :type: str :value: 'local' .. py:attribute:: const :type: bool :value: False .. py:attribute:: value_expression :type: object :value: None .. py:attribute:: function :type: object :value: None .. py:attribute:: known_value :type: int :value: None .. py:attribute:: enum_predecessor :type: object :value: None .. py:attribute:: enum_offset :type: int :value: 0 .. py:attribute:: enum_definition :type: object :value: None .. py:attribute:: model :type: object :value: None .. py:function:: reference(ctx) .. py:class:: SemanticValidator(tree, warnings_info, parameter_values=None) Bases: :py:obj:`m2isar.frontends.coredsl2.parser_gen.CoreDSL2Visitor`, :py:obj:`m2isar.warnings.WarningsManager`, :py:obj:`m2isar.frontends.coredsl2.source_validator.ScopeStack` Lexical scopes in ``self.scopes``: name -> entity dicts, innermost last. .. py:attribute:: error .. py:attribute:: parameter_values .. py:attribute:: definitions .. py:attribute:: scopes :value: [] .. py:attribute:: symbols .. py:attribute:: reference_symbols .. py:attribute:: values_in_progress .. py:attribute:: types_in_progress .. py:attribute:: function :value: None .. py:attribute:: partial :value: False .. py:attribute:: checked .. py:attribute:: elaborating :value: False .. py:attribute:: enum_definitions .. py:attribute:: enum_members .. py:attribute:: enum_types .. py:attribute:: enum_named_types .. py:attribute:: composite_definitions .. py:attribute:: composite_members .. py:attribute:: composite_types .. py:method:: warning(ctx, name, message) .. py:method:: lookup(name) .. py:method:: evaluate(ctx, required=False) .. py:method:: specified_type(ctx) .. py:method:: symbol_type(symbol) .. py:method:: enum_type(definition) .. py:method:: contributors(root) .. py:method:: composite_type(definition) .. py:method:: reference_scope(root) Resolve references in their defining ISA, independently of values. .. py:method:: build_symbols(contributors) .. py:method:: visitDescription_content(ctx) .. py:method:: validate_root(root, errors) .. py:method:: visitSection_functions(ctx) .. py:method:: visitSection_instructions(ctx) .. py:method:: visitSection_always(ctx) .. py:method:: validate_isa_assignments(contributors) .. py:method:: validate_duplicates(root, contributors) .. py:method:: validate_parameter_results(root) .. py:method:: composite_type_cycle(symbol, active) .. py:method:: parameter_cycle(symbol, active) .. py:method:: validate_initializer(initializer, target, isa=False) .. py:method:: validate_alias(symbol) .. py:method:: alias_source(alias, expression) .. py:method:: check_conversion(ctx, source, target, issue) .. py:method:: parameter_references(ctx) .. py:method:: function_signature(function) .. py:method:: visitFunction_definition(ctx) .. py:method:: visitBlock(ctx) .. py:method:: visitDeclaration(ctx) .. py:method:: visitInstruction(ctx) .. py:method:: visitAttribute(ctx) .. py:method:: visitExpression_statement(ctx) .. py:method:: check_statement_expression(expression, report_context) .. py:method:: visitProcedure_call(ctx) .. py:method:: visitReturn_statement(ctx) .. py:method:: scalar_condition(expression) .. py:method:: check_statement_parts(parts) .. py:method:: visitIf_statement(ctx) .. py:method:: visitWhile_statement(ctx) .. py:attribute:: visitDo_statement .. py:method:: visitFor_statement(ctx) .. py:method:: visitFor_condition(ctx) .. py:method:: visitSwitch_statement(ctx) .. py:method:: bit_size(ty) :staticmethod: .. py:method:: intrinsic_value(ctx, constant=False, argument_type=None) .. py:method:: intrinsic_type(ctx) .. py:method:: cast_type(ctx) Retain explicit target types and independent errors after child failures. .. py:method:: call_type(ctx) .. py:method:: recover_expression_type(expression, errors) .. py:method:: expression_type(ctx) .. py:method:: unary_type(ctx, operand, op, modifying=False) .. py:method:: conditional_type(ctx) .. py:method:: assignment_target(ctx) .. py:method:: binary_type(ctx, left, right) .. py:method:: index_type(ctx) .. py:function:: invalid_elaboration_summaries(tree, parameter_values=None) Collect proven invalid values/types without replacing the primary error. Unknown and indeterminate results are deliberately distinct from exceptions proving an invalid elaboration. Warnings are disabled during this collection. .. py:function:: validate_semantics(tree, warnings_info, parameter_values=None)