nkdsl.SymbolicCompilationContext

class SymbolicCompilationContext(*, operator, ir, options, metadata=None)

Holds per-compilation mutable state across pipeline stages.

The context is created by the compiler, mutated in-place by passes and lowerers, and finally read when packaging the compiled artifact.

Parameters:

• operator (Any) – Source symbolic operator.

• ir (SymbolicOperatorIR) – Symbolic operator IR extracted from the operator.

• options (SymbolicCompilerOptions) – Effective compiler options.

• metadata (Mapping[str, Any] | None) – Optional extra context metadata.

__init__(*, operator, ir, options, metadata=None)

Parameters:

• operator (Any)

• ir (SymbolicOperatorIR)

• options (SymbolicCompilerOptions)

• metadata (Mapping[str, Any] | None)

Return type:

None

Methods

__init__(*, operator, ir, options[, metadata])
add_pass_report(report)	Appends one pass report entry.
analysis(key, *[, default])	Returns one analysis payload or default.
require_analysis(key)	Returns a required analysis payload.
set_analysis(key, payload)	Stores one analysis payload.
set_metadata(key, value)	Stores one metadata value.
set_selected_backend(backend)	Stores selected backend name.
set_selected_lowerer(name)	Stores selected lowerer name.
summary()	Returns a summary dict for diagnostics and artifact packaging.

Attributes

analyses	Returns read-only analysis mapping.
ir	Returns the symbolic operator IR.
metadata	Returns context metadata mapping (read-only view).
operator	Returns the source symbolic operator.
options	Returns effective compiler options.
pass_reports	Returns pass reports in execution order.
selected_backend	Returns the selected backend name, when assigned.
selected_lowerer	Returns the selected lowerer name, when assigned.