Struct Runtime

pub struct Runtime<C> { /* private fields */ }

An instance of a policy with builtins and entrypoints resolved, but with no data provided yet

Implementations

impl Runtime<DefaultContext>

pub async fn new<T: Send + 'static>( store: impl AsContextMut<Data = T>, module: &Module, ) -> Result<Self>

Load a new WASM policy module into the given store, with the default evaluation context.

Errors

It will raise an error if one of the following condition is met:

• the provided wasmtime::Store isn’t an async one
• the wasmtime::Module was created with a different wasmtime::Engine than the wasmtime::Store
• the WASM module is not a valid OPA WASM compiled policy, and lacks some of the exported functions
• it failed to load the entrypoints or the builtins list

impl<C> Runtime<C>

pub async fn new_with_evaluation_context<T: Send + 'static>( store: impl AsContextMut<Data = T>, module: &Module, context: C, ) -> Result<Self>

where C: EvaluationContext,

Load a new WASM policy module into the given store, with a given evaluation context.

Errors

It will raise an error if one of the following condition is met:

• the provided wasmtime::Store isn’t an async one
• the wasmtime::Module was created with a different wasmtime::Engine than the wasmtime::Store
• the WASM module is not a valid OPA WASM compiled policy, and lacks some of the exported functions
• it failed to load the entrypoints or the builtins list

pub async fn without_data<T: Send>( self, store: impl AsContextMut<Data = T>, ) -> Result<Policy<C>>

Instanciate the policy with an empty data object

Errors

If it failed to load the empty data object in memory

pub async fn with_data<V: Serialize, T: Send>( self, store: impl AsContextMut<Data = T>, data: &V, ) -> Result<Policy<C>>

Instanciate the policy with the given data object

Errors

If it failed to serialize and load the data object

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

Get the default entrypoint of this module. May return None if no entrypoint with ID 0 was found

pub fn entrypoints(&self) -> HashSet<&str>

Get the list of entrypoints found in this module.

pub fn abi_version(&self) -> AbiVersion

Get the ABI version detected for this module

Trait Implementations

impl<C> Debug for Runtime<C>

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

Formats the value using the given formatter.