Struct ExecutionContext 

pub struct ExecutionContext {
    pub engine_id: u64,
    pub capabilities: Capabilities,
    /* private fields */
}

Execution context passed to host functions.

Fields

engine_id: u64

Engine ID for tracking.

capabilities: Capabilities

Capabilities available to the script.

Implementations

impl ExecutionContext

pub fn new( engine_id: u64, capabilities: Capabilities, limits: Limits, sandbox: Sandbox, ) -> Self

Create a new execution context.

pub fn has_capability(&self, cap: Capability) -> bool

Check if a capability is granted.

pub fn require_capability(&self, cap: Capability) -> Result<()>

Require a capability, returning an error if not granted.

pub fn sandbox(&self) -> &Sandbox

Get the sandbox for permission checks.

pub fn record_instructions(&self, count: u64) -> Result<()>

Record instruction execution and check limits.

pub fn record_memory(&self, bytes: usize) -> Result<()>

Record memory usage and check limits.

pub fn record_output(&self, bytes: usize) -> Result<()>

Record output and check limits.

pub fn record_fs_op(&self) -> Result<()>

Record filesystem operation and check limits.

pub fn record_net_op(&self) -> Result<()>

Record network operation and check limits.

pub fn check_timeout(&self) -> Result<()>

Check timeout and return error if exceeded.

pub fn elapsed(&self) -> Duration

Get elapsed time since execution started.

pub fn is_cancelled(&self) -> bool

Check if execution has been cancelled.

pub fn cancel(&self)

Cancel execution.

pub fn set_custom(&self, key: impl Into<String>, value: Value)

Set custom context data.

pub fn get_custom(&self, key: &str) -> Option<Value>

Get custom context data.

pub fn reset(&self, limits: Limits)

Reset the context for a new execution.

Trait Implementations

impl Debug for ExecutionContext

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

Formats the value using the given formatter.