Skip to main content

JitEffectMachine

Struct JitEffectMachine 

Source
pub struct JitEffectMachine { /* private fields */ }
Expand description

High-level JIT effect machine.

Compiles a CoreExpr (Haskell effect program) into native code via Cranelift and runs it as a coroutine: the machine yields effect requests, the caller dispatches them through an HList of EffectHandlers, and resumes with responses.

let (expr, table) = haskell_inline! { target = "main", include = "haskell", r#"..."# };
let mut vm = JitEffectMachine::compile(&expr, &table, 1 << 20)?;
vm.run(&table, &mut frunk::hlist![MyHandler], &())?;

Owns the compiled code, nursery (GC heap), and freer-simple constructor tags. The nursery size (in bytes) controls how much heap is available before GC triggers.

Implementations§

Source§

impl JitEffectMachine

Source

pub fn compile( expr: &CoreExpr, table: &DataConTable, nursery_size: usize, ) -> Result<Self, JitError>

Compile a CoreExpr for JIT execution.

Source

pub fn run<U, H: DispatchEffect<U>>( &mut self, table: &DataConTable, handlers: &mut H, user: &U, ) -> Result<Value, JitError>

Run to completion, dispatching effects through the handler HList.

Source

pub fn run_pure(&mut self) -> Result<Value, JitError>

Run a pure (non-effectful) program to completion.

Skips freer-simple effect dispatch entirely — calls the compiled function and converts the raw heap result directly to a Value. Use this for programs that don’t use an Eff wrapper.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<Choices> CoproductSubsetter<CNil, HNil> for Choices

Source§

type Remainder = Choices

Source§

fn subset( self, ) -> Result<CNil, <Choices as CoproductSubsetter<CNil, HNil>>::Remainder>

Extract a subset of the possible types in a coproduct (or get the remaining possibilities) Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U, I> LiftInto<U, I> for T
where U: LiftFrom<T, I>,

Source§

fn lift_into(self) -> U

Performs the indexed conversion.
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<Source> Sculptor<HNil, HNil> for Source

Source§

type Remainder = Source

Source§

fn sculpt(self) -> (HNil, <Source as Sculptor<HNil, HNil>>::Remainder)

Consumes the current HList and returns an HList with the requested shape. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.