Struct RunMatSession 

pub struct RunMatSession { /* private fields */ }

Host-agnostic RunMat execution session (parser + interpreter + optional JIT).

Implementations

impl RunMatSession

pub fn set_telemetry_sink(&mut self, sink: Option<Arc<dyn TelemetrySink>>)

pub fn set_telemetry_platform_info(&mut self, platform: TelemetryPlatformInfo)

pub fn telemetry_platform_info(&self) -> &TelemetryPlatformInfo

pub fn telemetry_run( &self, config: TelemetryRunConfig, ) -> Option<TelemetryRunGuard>

impl RunMatSession

pub fn new() -> Result<Self>

Create a new session

pub fn with_options(enable_jit: bool, verbose: bool) -> Result<Self>

Create a new session with specific options

pub fn with_snapshot<P: AsRef<Path>>( enable_jit: bool, verbose: bool, snapshot_path: Option<P>, ) -> Result<Self>

Create a new session with snapshot loading

pub fn with_snapshot_bytes( enable_jit: bool, verbose: bool, snapshot_bytes: Option<&[u8]>, ) -> Result<Self>

Create a session using snapshot bytes (already fetched from disk or network)

pub fn install_async_input_handler<F, Fut>(&mut self, handler: F)

where F: Fn(InputRequest) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<InputResponse, String>> + 'static,

Install an async stdin handler (Phase 2). This is the preferred input path for poll-driven execution (ExecuteFuture).

The handler is invoked when input() / pause() needs a line or keypress, and the returned future is awaited by the runtime.

pub fn clear_async_input_handler(&mut self)

pub fn telemetry_consent(&self) -> bool

pub fn set_telemetry_consent(&mut self, consent: bool)

pub fn telemetry_client_id(&self) -> Option<&str>

pub fn set_telemetry_client_id(&mut self, cid: Option<String>)

pub fn cancel_execution(&self)

Request cooperative cancellation for the currently running execution.

pub fn interrupt_handle(&self) -> Arc<AtomicBool>

Shared interrupt flag used by the VM to implement cooperative cancellation.

pub fn snapshot_info(&self) -> Option<String>

Get snapshot information

pub fn has_snapshot(&self) -> bool

Check if a snapshot is loaded

pub fn compile_fusion_plan( &mut self, input: &str, ) -> Result<Option<FusionPlanSnapshot>, RunError>

Compile the input and produce a fusion plan snapshot without executing.

pub async fn execute( &mut self, input: &str, ) -> Result<ExecutionResult, RunError>

Execute MATLAB/Octave code

pub async fn run(&mut self, input: &str) -> Result<ExecutionResult, RunError>

Parse, lower, compile, and execute input.

pub fn stats(&self) -> &ExecutionStats

Get execution statistics

pub fn reset_stats(&mut self)

Reset execution statistics

pub fn clear_variables(&mut self)

Clear all variables in the session context

pub async fn export_workspace_state( &mut self, mode: WorkspaceExportMode, ) -> Result<Option<Vec<u8>>>

pub fn import_workspace_state(&mut self, bytes: &[u8]) -> Result<()>

pub fn workspace_snapshot(&mut self) -> WorkspaceSnapshot

pub fn set_emit_fusion_plan(&mut self, enabled: bool)

Control whether fusion plan snapshots are emitted in ExecutionResult.

pub fn compat_mode(&self) -> CompatMode

Return the active language compatibility mode.

pub fn set_compat_mode(&mut self, mode: CompatMode)

Set the language compatibility mode (matlab or strict).

pub fn set_callstack_limit(&mut self, limit: usize)

pub fn set_error_namespace(&mut self, namespace: impl Into<String>)

pub fn set_source_name_override(&mut self, name: Option<String>)

pub async fn materialize_variable( &mut self, target: WorkspaceMaterializeTarget, options: WorkspaceMaterializeOptions, ) -> Result<MaterializedVariable>

Materialize a workspace variable for inspection (optionally identified by preview token).

pub fn get_variables(&self) -> &HashMap<String, Value>

Get a copy of current variables

pub fn configure_gc(&self, config: GcConfig) -> Result<()>

Configure garbage collector

pub fn gc_stats(&self) -> GcStats

Get GC statistics

pub fn show_system_info(&self)

Show detailed system information

Trait Implementations

impl Default for RunMatSession

fn default() -> Self

Returns the “default value” for a type.