Struct Kinetik 

pub struct Kinetik { /* private fields */ }

Embedded Kinetik runtime.

Implementations

impl Kinetik

pub fn new() -> Self

Creates a new embedded runtime.

pub fn register_native<F>(&mut self, name: impl Into<String>, function: F)

where F: Fn(&[Value]) -> HostNativeResult + Send + Sync + 'static,

Registers a host-native function in the root environment.

pub fn insert_host<T>(&mut self, value: T) -> Value

where T: Any + Send + Sync + 'static,

Stores a host-owned object and returns an opaque script value for it.

pub fn remove_host(&mut self, value: &Value) -> Result<()>

Removes a host-owned object, making existing handles stale.

Errors

Returns a stale handle error when the value is not a live host handle.

pub fn with_host<T, R>( &self, value: &Value, read: impl FnOnce(&T) -> R, ) -> Result<R>

where T: Any + Send + Sync + 'static,

Accesses a host object through a closure without exposing raw references.

Errors

Returns a stale handle or type mismatch error when the handle is invalid.

pub fn with_host_mut<T, R>( &mut self, value: &Value, write: impl FnOnce(&mut T) -> R, ) -> Result<R>

where T: Any + Send + Sync + 'static,

Mutates a host object through a closure without exposing raw references.

Errors

Returns a stale handle or type mismatch error when the handle is invalid.

pub fn define_global(&mut self, name: impl Into<String>, value: Value)

Defines a global script value.

pub fn load_source( &mut self, name: impl Into<String>, text: impl Into<String>, ) -> Result<Value>

Loads, parses, and evaluates a Kinetik source string.

Errors

Returns parse diagnostics or a runtime error when script loading fails.

pub fn reload_source( &mut self, name: impl Into<String>, text: impl Into<String>, ) -> Result<ReloadReport>

Parses and reloads a Kinetik source string into the running runtime.

Parse errors are reported before the current runtime is mutated, so the previously loaded script functions remain callable after a bad edit.

Errors

Returns parse diagnostics or a runtime error when script reloading fails.

pub fn load_file(&mut self, path: impl AsRef<Path>) -> Result<Value>

Loads, parses, and evaluates a Kinetik script file.

Errors

Returns I/O, parse, or runtime errors when script loading fails.

pub fn call_function( &mut self, name: &str, args: &[Value], ) -> Result<Vec<Value>>

Calls a named script or native function.

Errors

Returns an error when the function is missing, not callable, or fails.

pub fn get(&self, name: &str) -> Option<Value>

Reads a global value from the embedded runtime.

pub fn drain_output(&mut self) -> impl Iterator<Item = String> + '_

Drains lines produced by the default standard-library print function.

Trait Implementations

impl Debug for Kinetik

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

Formats the value using the given formatter.

impl Default for Kinetik

fn default() -> Self

Returns the “default value” for a type.