m2isar.frontends.coredsl2.source_semantics

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

logger

Classes

DslSymbol

Source validator view of a declared name, typed with a DslType.

SemanticValidator

Lexical scopes in self.scopes: name -> entity dicts, innermost last.

Functions

reference(ctx)

invalid_elaboration_summaries(tree[, parameter_values])

Collect proven invalid values/types without replacing the primary error.

validate_semantics(tree, warnings_info[, parameter_values])

Module Contents

logger[source]
class DslSymbol[source]

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.

declaration: object = None[source]
declarator: object = None[source]
ty: m2isar.frontends.coredsl2.source_types.DslType = None[source]
storage: str = 'local'[source]
const: bool = False[source]
value_expression: object = None[source]
function: object = None[source]
known_value: int = None[source]
enum_predecessor: object = None[source]
enum_offset: int = 0[source]
enum_definition: object = None[source]
model: object = None[source]
reference(ctx)[source]
class SemanticValidator(tree, warnings_info, parameter_values=None)[source]

Bases: m2isar.frontends.coredsl2.parser_gen.CoreDSL2Visitor, m2isar.warnings.WarningsManager, m2isar.frontends.coredsl2.source_validator.ScopeStack

Lexical scopes in self.scopes: name -> entity dicts, innermost last.

error[source]
parameter_values[source]
definitions[source]
scopes = [][source]
symbols[source]
reference_symbols[source]
values_in_progress[source]
types_in_progress[source]
function = None[source]
partial = False[source]
checked[source]
elaborating = False[source]
enum_definitions[source]
enum_members[source]
enum_types[source]
enum_named_types[source]
composite_definitions[source]
composite_members[source]
composite_types[source]
warning(ctx, name, message)[source]
lookup(name)[source]
evaluate(ctx, required=False)[source]
specified_type(ctx)[source]
symbol_type(symbol)[source]
enum_type(definition)[source]
contributors(root)[source]
composite_type(definition)[source]
reference_scope(root)[source]

Resolve references in their defining ISA, independently of values.

build_symbols(contributors)[source]
visitDescription_content(ctx)[source]
validate_root(root, errors)[source]
visitSection_functions(ctx)[source]
visitSection_instructions(ctx)[source]
visitSection_always(ctx)[source]
validate_isa_assignments(contributors)[source]
validate_duplicates(root, contributors)[source]
validate_parameter_results(root)[source]
composite_type_cycle(symbol, active)[source]
parameter_cycle(symbol, active)[source]
validate_initializer(initializer, target, isa=False)[source]
validate_alias(symbol)[source]
alias_source(alias, expression)[source]
check_conversion(ctx, source, target, issue)[source]
parameter_references(ctx)[source]
function_signature(function)[source]
visitFunction_definition(ctx)[source]
visitBlock(ctx)[source]
visitDeclaration(ctx)[source]
visitInstruction(ctx)[source]
visitAttribute(ctx)[source]
visitExpression_statement(ctx)[source]
check_statement_expression(expression, report_context)[source]
visitProcedure_call(ctx)[source]
visitReturn_statement(ctx)[source]
scalar_condition(expression)[source]
check_statement_parts(parts)[source]
visitIf_statement(ctx)[source]
visitWhile_statement(ctx)[source]
visitDo_statement[source]
visitFor_statement(ctx)[source]
visitFor_condition(ctx)[source]
visitSwitch_statement(ctx)[source]
static bit_size(ty)[source]
intrinsic_value(ctx, constant=False, argument_type=None)[source]
intrinsic_type(ctx)[source]
cast_type(ctx)[source]

Retain explicit target types and independent errors after child failures.

call_type(ctx)[source]
recover_expression_type(expression, errors)[source]
expression_type(ctx)[source]
unary_type(ctx, operand, op, modifying=False)[source]
conditional_type(ctx)[source]
assignment_target(ctx)[source]
binary_type(ctx, left, right)[source]
index_type(ctx)[source]
invalid_elaboration_summaries(tree, parameter_values=None)[source]

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.

validate_semantics(tree, warnings_info, parameter_values=None)[source]