Struct PyGenerator 

pub struct PyGenerator { /* private fields */ }

Python code generator implementing the CodeGenerator trait.

Implementations

impl PyGenerator

pub fn new() -> Self

Creates a new Python code generator.

Trait Implementations

impl CodeGenerator for PyGenerator

fn generate_project( &self, modules: &[(&AIRModule, &Path)], ) -> Result<GeneratedCode, CodegenError>

Emit a per-module native import tree (spec §20.6.1; DQ19 resolved): each module the entry program reaches through a real use is emitted to its own Python file, and cross-module references resolve through real Python imports (from core.option import or_else). This is the sole bock build output path.

Output-path mapping is keyed on each module’s declared path, not its on-disk source path, so the file layout and the import path agree: module core.option ⇒ core/option.py and from core.option import …. The entry module (the one declaring main, else the last in dependency order) is always emitted as main.py so the run model (python3 main.py from the build root) is stable; Python adds the script’s directory to sys.path, and core resolves as a PEP 420 namespace package (no __init__.py needed).

The four runtime preludes (Optional, Result, Ordering, concurrency) are emitted once into a shared _bock_runtime.py (see RUNTIME_MODULE_PY); every module that references one imports it (from _bock_runtime import *). A single shared definition keeps the tagged runtime classes identical across files so cross-module isinstance checks succeed.

fn generate_tests( &self, modules: &[(&AIRModule, &Path)], framework: &str, ) -> Result<TestArtifacts, CodegenError>

Transpile @test functions into a test_bock.py file (S7).

framework: "unittest" emits a unittest.TestCase subclass with self.assertEqual/assertTrue/…; anything else (default "pytest") emits module-level def test_xxx(): with bare assert — both discovered by pytest and python -m unittest. Functions under test are imported by name from their emitted modules; the Optional/Result predicate assertions import the runtime tag classes from _bock_runtime.

fn target(&self) -> &TargetProfile

Returns the target profile for this generator.

fn generate_module( &self, module: &AIRModule, ) -> Result<GeneratedCode, CodegenError>

Generates target code from a fully-lowered AIR module.

fn entry_invocation(&self, main_is_async: bool) -> Option<String>

Returns the source-code snippet that invokes the user’s main function as the entry point for this target, or None if the target has a native entry-point convention (Rust fn main, Go func main) that runs without a synthetic call.

fn needs_ai_synthesis(&self, node: &AIRNode) -> bool

Returns true when the given AIR node should go through Tier 1 AI synthesis (§17.2, Q3 amended).

impl Debug for PyGenerator

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PyGenerator

fn default() -> Self

Returns the “default value” for a type.