Struct Session 

pub struct Session { /* private fields */ }

A session manages graph compilation and execution on a device.

Implementations

impl Session

pub fn new(device: Device) -> Self

Create a session for the given device at default (F32) precision.

Panics

Panics if the device is not available (missing feature flag).

pub fn new_with_precision(device: Device, precision: Precision) -> Self

Create a session targeting a specific numeric precision. Backends fall back to F32 if the requested precision isn’t supported.

pub fn with_policy(self, policy: PrecisionPolicy) -> Self

Builder: set a per-op precision policy. Applied as a graph rewrite before backend compile. Same mechanism works for AOT compile, JIT tracing, and proc-macro AOT — it’s a graph pass, not a runtime mode.

pub fn device(&self) -> Device

pub fn precision(&self) -> Precision

pub fn policy(&self) -> Option<&PrecisionPolicy>

pub fn compile(&self, graph: Graph) -> CompiledGraph

Compile a MIR graph through the fusion-first pipeline (GraphModule → LIR).

Prefer Self::compile_hir or Self::compile_module for new code. This entry wraps the graph as a MIR-stage GraphModule.

pub fn compile_graph(&self, graph: Graph) -> CompiledGraph

Explicit legacy alias — same as Self::compile.

pub fn compile_with( &self, graph: Graph, options: &CompileOptions, ) -> CompiledGraph

Compile with explicit options (full control over the pipeline). Most callers use compile() and configure the session via new_with_precision / with_policy. This escape hatch is for callers that need finer control (e.g., disable DCE for debugging).

pub fn compile_hir(&self, hir: HirModule) -> Result<CompiledGraph, LowerError>

Compile a fusion-first HIR module through HIR → MIR → LIR.

pub fn compile_hir_with( &self, hir: HirModule, options: &CompileOptions, ) -> Result<CompiledGraph, LowerError>

Compile HIR with explicit compile options.

pub fn compile_module( &self, module: GraphModule, ) -> Result<CompiledGraph, LowerError>

Compile a GraphModule (HIR/MIR/LIR stage) through the pipeline.

pub fn compile_module_with( &self, module: GraphModule, options: &CompileOptions, ) -> Result<CompiledGraph, LowerError>

Compile a GraphModule with explicit compile options.