Struct PluginRuntime 

pub struct PluginRuntime { /* private fields */ }

Runtime owner for one immutable plan and its root scope.

Implementations

impl PluginRuntime

pub fn attach_active_playback( &self, correlation: PluginActivePlaybackCorrelation, ) -> Result<PluginPlaybackAttachment, PluginPlaybackError>

Attaches the first active playback scope for this runtime.

pub fn attach_next_prewarm( &self, correlation: PluginNextPrewarmCorrelation, ) -> Result<PluginPlaybackAttachment, PluginPlaybackError>

Attaches the only allowed next-item prewarm scope.

pub fn authorize_playback_authority( &self, attachment: &PluginPlaybackAttachment, authority: PluginPlaybackAuthority, ) -> Result<(), PluginPlaybackError>

Rejects active-only effects from prewarm or stale attachments.

pub fn promote_next_prewarm( &self, prewarm: &PluginPlaybackAttachment, correlation: PluginActivePlaybackCorrelation, timeout: Duration, ) -> Result<PluginPlaybackTransitionReport, PluginPlaybackError>

Promotes the current next prewarm after an authoritative activation.

pub fn replace_active_playback( &self, correlation: PluginActivePlaybackCorrelation, timeout: Duration, ) -> Result<PluginPlaybackTransitionReport, PluginPlaybackError>

Replaces active playback and settles any obsolete next prewarm first.

pub fn cancel_next_prewarm( &self, prewarm: &PluginPlaybackAttachment, timeout: Duration, ) -> Result<PluginScopeCloseReport, PluginPlaybackError>

Cancels the exact next prewarm attachment and rejects stale callers.

impl PluginRuntime

pub fn new(plan: PluginPlan) -> Self

pub fn plan(&self) -> &PluginPlan

pub fn root_scope(&self) -> PluginScope

pub fn shutdown( &self, timeout: Duration, ) -> Result<PluginScopeCloseReport, PluginScopeError>

Closes the root with one total deadline shared by the complete scope tree.

An already draining root is marked Quarantined so shutdown never waits on an unbounded concurrent close.

Trait Implementations

impl Drop for PluginRuntime

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.