Struct DebounceMutex 

pub struct DebounceMutex(/* private fields */);

An async Mutex type specialized for Perspective’s rendering, which debounces calls in addition to providing exclusivity. Calling Self::debounce resolves only after at least one complete evaluation of a call that began no earlier than this one — either by running the caller’s own future, or by coalescing onto the single parked trailing runner. At most TWO debounce evaluations are ever outstanding (one running, one parked); every additional concurrent caller resolves without queueing on the lock.

Implementations

impl DebounceMutex

pub fn is_held(&self) -> bool

true while a locked task is executing. Used by lock-acquiring public API methods to emit a debug-build warning when they are about to queue behind an in-flight run — legitimate for app callers, a guaranteed deadlock when reached synchronously from a plugin’s render (the render-callable contract on js::plugin forbids it).

pub async fn lock<T>(&self, f: impl Future<Output = T>) -> T

Lock like a normal Mutex.

pub async fn lock_with<T, F, Fut>(&self, f: F) -> T

where F: FnOnce(RenderGuard) -> Fut, Fut: Future<Output = T>,

Lock, passing a RenderGuard witness into the task builder. The task future is CONSTRUCTED after the lock is acquired — a guard can never exist outside a locked section.

pub async fn debounce( &self, f: impl Future<Output = ApiResult<()>>, ) -> ApiResult<()>

Lock and also debounce f, which should be cancellable.

pub async fn debounce_with<T, F, Fut>(&self, f: F) -> ApiResult<T>

where T: Default, F: FnOnce(RenderGuard) -> Fut, Fut: Future<Output = ApiResult<T>>,

Self::debounce with a RenderGuard witness (see

Trait Implementations

impl Clone for DebounceMutex

fn clone(&self) -> DebounceMutex

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for DebounceMutex

fn default() -> DebounceMutex

Returns the “default value” for a type.