Struct ProcedureContext 

#[non_exhaustive]
pub struct ProcedureContext<'a> {
    pub host: Option<&'a dyn ProcedureHost>,
    pub deadline: Option<Duration>,
    pub principal: Option<&'a Principal>,
    pub _marker: PhantomData<&'a ()>,
}

Per-call context passed to ProcedurePlugin::invoke.

Carries an optional host pointer (for in-tree built-ins that need snapshot / schema / algorithm access), an optional principal (for capability gating), and an optional wall-clock deadline. All fields are Option so pure procedures and unit tests can construct a context with ProcedureContext::default.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

host: Option<&'a dyn ProcedureHost>

Host services pointer; None in pure procedure tests.

deadline: Option<Duration>

Optional wall-clock deadline for the procedure invocation.

principal: Option<&'a Principal>

Authenticated principal, if any.

_marker: PhantomData<&'a ()>

Lifetime marker. The plugin ABI keeps 'a exposed so future fields (session / transaction) can borrow without a breaking change.

Implementations

impl<'a> ProcedureContext<'a>

pub fn new() -> Self

Construct a context with every field set to None.

pub fn with_host(self, host: &'a dyn ProcedureHost) -> Self

Attach a host pointer.

pub fn with_deadline(self, deadline: Duration) -> Self

Attach a wall-clock deadline.

pub fn with_principal(self, principal: &'a Principal) -> Self

Attach an authenticated principal.

Trait Implementations

impl Debug for ProcedureContext<'_>

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

Formats the value using the given formatter.

impl<'a> Default for ProcedureContext<'a>

fn default() -> ProcedureContext<'a>

Returns the “default value” for a type.