Struct CompilerWorkflow 

pub struct CompilerWorkflow { /* private fields */ }

Compiler optimization workflow built from completed compiler transforms.

Implementations

impl CompilerWorkflow

pub const fn new(config: CompileConfig) -> Self

Creates a compiler workflow from a complete configuration.

Target preparation is deferred until the first run. Use Self::try_new when construction should validate and prepare the complete target eagerly.

pub fn try_new(config: CompileConfig) -> Result<Self, CompilerError>

Creates a workflow and eagerly prepares all target-derived invariants.

pub const fn config(&self) -> &CompileConfig

Returns the workflow configuration.

pub fn run(&self, circuit: &Circuit) -> Result<CompileResult, CompilerError>

Runs the workflow over circuit and returns the rebuilt circuit plus execution metadata.

pub fn run_owned( &self, circuit: Circuit, ) -> Result<CompileResult, CompilerError>

Runs the workflow by consuming circuit.

This avoids the workflow’s defensive input clone when the caller already owns an isolated circuit value. The borrowed Self::run entry point remains the compatibility path for callers that need to retain their input.

pub fn run_with_rewrite_diagnostics( &self, circuit: &Circuit, ) -> Result<(CompileResult, KnowledgeRewriteDiagnostics), CompilerError>

Runs the workflow and also returns aggregate rewrite diagnostics.

This explicit entry point keeps benchmark-only attribution separate from CompileResult’s stable semantic equality and normal API.

pub fn run_owned_with_rewrite_diagnostics( &self, circuit: Circuit, ) -> Result<(CompileResult, KnowledgeRewriteDiagnostics), CompilerError>

Runs the workflow by consuming circuit and collects rewrite diagnostics for benchmark attribution.

This is the owned-input counterpart of Self::run_with_rewrite_diagnostics and avoids its defensive clone.