m2isar.frontends.coredsl2.source_validator ========================================== .. py:module:: m2isar.frontends.coredsl2.source_validator .. autoapi-nested-parse:: Validate source information that is lost when lowering to the metamodel. Rules follow the analyzer in the source bundle of MINRES CoreDSL 2.0.21. The semantic pass handles known integer/array types and scoped ISA parameters. Remaining elaboration and provider gaps are tracked in the parity map. Attributes ---------- .. autoapisummary:: m2isar.frontends.coredsl2.source_validator.logger m2isar.frontends.coredsl2.source_validator.ATTRIBUTES Classes ------- .. autoapisummary:: m2isar.frontends.coredsl2.source_validator.Diagnostics m2isar.frontends.coredsl2.source_validator.ScopeStack m2isar.frontends.coredsl2.source_validator.SourceValidator Functions --------- .. autoapisummary:: m2isar.frontends.coredsl2.source_validator.location m2isar.frontends.coredsl2.source_validator.unresolved m2isar.frontends.coredsl2.source_validator.in_progress m2isar.frontends.coredsl2.source_validator.dependencies m2isar.frontends.coredsl2.source_validator.contributors m2isar.frontends.coredsl2.source_validator.provided m2isar.frontends.coredsl2.source_validator.is_const m2isar.frontends.coredsl2.source_validator.is_alias m2isar.frontends.coredsl2.source_validator.return_terminated m2isar.frontends.coredsl2.source_validator.statement_expression m2isar.frontends.coredsl2.source_validator.validate_source m2isar.frontends.coredsl2.source_validator._validate_source Module Contents --------------- .. py:data:: logger .. py:data:: ATTRIBUTES .. py:function:: location(ctx) .. py:function:: unresolved(ctx, kind, name) The release's linking diagnostic for a name that does not resolve. .. py:class:: Diagnostics Bases: :py:obj:`list` Validation errors reported together: the first is raised, the rest are attached to it. .. py:method:: add(ctx, issue, message) .. py:method:: collect() Record a validation error raised in the block instead of propagating it. .. py:method:: raise_if_any() .. py:class:: ScopeStack Lexical scopes in ``self.scopes``: name -> entity dicts, innermost last. .. py:method:: scope(names=None) .. py:method:: only_scopes(scopes) Replace the whole scope stack for the block. .. py:function:: in_progress(active, key) Mark ``key`` active for the block; yield whether it already was (a cycle). .. py:function:: dependencies(definition) Names of the instruction sets a core or instruction set builds on. .. py:function:: contributors(definitions, root) ``root`` and every definition it builds on, each once, dependencies first. .. py:function:: provided(definitions, starts) ``starts`` and the definitions they build on, each once, in lookup precedence order. .. py:function:: is_const(declaration) .. py:function:: is_alias(type_specifier) .. py:function:: return_terminated(ctx) .. py:function:: statement_expression(ctx) .. py:class:: SourceValidator(warnings_info) Bases: :py:obj:`m2isar.frontends.coredsl2.parser_gen.CoreDSL2Visitor`, :py:obj:`m2isar.warnings.WarningsManager` .. py:attribute:: function :value: None .. py:attribute:: loop_depth :value: 0 .. py:attribute:: switch_depth :value: 0 .. py:method:: error(ctx, issue, message) :staticmethod: .. py:method:: warning(ctx, name, message) .. py:method:: constant(ctx) .. py:method:: visitInteger_type(ctx) .. py:method:: visitAttribute(ctx) .. py:method:: encoding_size(instruction) .. py:method:: _encoding_size(instruction) .. py:method:: visitInstruction(ctx) .. py:method:: visitFunction_definition(ctx) .. py:method:: visitParameter_declaration(ctx) .. py:method:: visitEnumerator(ctx) .. py:method:: visitDeclaration(ctx) .. py:method:: visitBlock(ctx) .. py:method:: visitReturn_statement(ctx) .. py:method:: visitBreak_statement(ctx) .. py:method:: visitContinue_statement(ctx) .. py:method:: visit_loop(ctx) .. py:attribute:: visitFor_statement .. py:attribute:: visitWhile_statement .. py:attribute:: visitDo_statement .. py:method:: visitSwitch_statement(ctx) .. py:method:: visitSpawn_statement(ctx) .. py:method:: visitExpression_statement(ctx) .. py:method:: visitFor_condition(ctx) .. py:method:: check_condition(expr) .. py:method:: visitIf_statement(ctx) .. py:function:: validate_source(tree, warnings_info, parameter_values=None) .. py:function:: _validate_source(tree, warnings_info, parameter_values=None)