Struct ShutdownGuard
pub struct ShutdownGuard(/* private fields */);
Expand description
A guard, linked to a Shutdown
struct,
prevents the Shutdown::shutdown
future from completing.
Can be cloned to create multiple ShutdownGuard
s
and can be downgraded to a WeakShutdownGuard
to
no longer prevent the Shutdown::shutdown
future from completing.
Implementations§
§impl ShutdownGuard
impl ShutdownGuard
pub async fn cancelled(&self)
pub async fn cancelled(&self)
Returns a Future that gets fulfilled when cancellation (shutdown) is requested and the delay (if any) duration has been awaited.
Use Self::shutdown_signal_triggered
for tasks that do not
require this opt-in delay buffer duration.
The future will complete immediately if the token is already cancelled when this method is called.
§Cancel safety
This method is cancel safe.
§Panics
This method panics if the iternal mutex is poisoned while being used.
pub async fn shutdown_signal_triggered(&self)
pub async fn shutdown_signal_triggered(&self)
Returns a Future that gets fulfilled when cancellation (shutdown) is requested.
Use Self::cancelled
if you want to make sure the future
only completes when the buffer delay has been awaited.
In case no delay has been configured for the parent Shutdown
,
this function will be equal in behaviour to Self::cancelled
.
The future will complete immediately if the token is already cancelled when this method is called.
§Cancel safety
This method is cancel safe.
§Panics
This method panics if the iternal mutex is poisoned while being used.
pub fn spawn_task<T>(&self, task: T) -> JoinHandle<<T as Future>::Output> ⓘ
pub fn spawn_task<T>(&self, task: T) -> JoinHandle<<T as Future>::Output> ⓘ
Returns a [crate::sync::JoinHandle
] that can be awaited on
to wait for the spawned task to complete. See
[crate::sync::spawn
] for more information.
pub fn into_spawn_task<T>(self, task: T) -> JoinHandle<<T as Future>::Output> ⓘ
pub fn into_spawn_task<T>(self, task: T) -> JoinHandle<<T as Future>::Output> ⓘ
Returns a Tokio [crate::sync::JoinHandle
] that can be awaited on
to wait for the spawned task (future) to complete. See
[crate::sync::spawn
] for more information.
In contrast to ShutdownGuard::spawn_task
this method consumes the guard,
ensuring the guard is dropped once the task future is fulfilled.
ShutdownGuard::spawn_task
: crate::ShutdownGuard::spawn_task
pub fn spawn_task_fn<F, T>(&self, task: F) -> JoinHandle<<T as Future>::Output> ⓘ
pub fn spawn_task_fn<F, T>(&self, task: F) -> JoinHandle<<T as Future>::Output> ⓘ
Returns a Tokio [crate::sync::JoinHandle
] that can be awaited on
to wait for the spawned task (fn) to complete. See
[crate::sync::spawn
] for more information.
pub fn into_spawn_task_fn<F, T>(
self,
task: F,
) -> JoinHandle<<T as Future>::Output> ⓘ
pub fn into_spawn_task_fn<F, T>( self, task: F, ) -> JoinHandle<<T as Future>::Output> ⓘ
Returns a Tokio [crate::sync::JoinHandle
] that can be awaited on
to wait for the spawned task (fn) to complete. See
[crate::sync::spawn
] for more information.
In contrast to ShutdownGuard::spawn_task_fn
this method consumes the guard,
ensuring the guard is dropped once the task future is fulfilled.
ShutdownGuard::spawn_task_fn
: crate::ShutdownGuard::spawn_task_fn
pub fn downgrade(self) -> WeakShutdownGuard
pub fn downgrade(self) -> WeakShutdownGuard
Downgrades the guard to a WeakShutdownGuard
,
ensuring that the guard no longer prevents the
Shutdown::shutdown
future from completing.
pub fn clone_weak(&self) -> WeakShutdownGuard
pub fn clone_weak(&self) -> WeakShutdownGuard
Clones the guard as a WeakShutdownGuard
,
ensuring that the cloned guard does not prevent the
Shutdown::shutdown
future from completing.
Trait Implementations§
§impl Clone for ShutdownGuard
impl Clone for ShutdownGuard
§fn clone(&self) -> ShutdownGuard
fn clone(&self) -> ShutdownGuard
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more§impl Debug for ShutdownGuard
impl Debug for ShutdownGuard
§impl From<WeakShutdownGuard> for ShutdownGuard
impl From<WeakShutdownGuard> for ShutdownGuard
§fn from(weak_guard: WeakShutdownGuard) -> ShutdownGuard
fn from(weak_guard: WeakShutdownGuard) -> ShutdownGuard
Auto Trait Implementations§
impl Freeze for ShutdownGuard
impl RefUnwindSafe for ShutdownGuard
impl Send for ShutdownGuard
impl Sync for ShutdownGuard
impl Unpin for ShutdownGuard
impl UnwindSafe for ShutdownGuard
Blanket Implementations§
§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> FutureExt for T
impl<T> FutureExt for T
§fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
fn with_context(self, otel_cx: Context) -> WithContext<Self> ⓘ
§fn with_current_context(self) -> WithContext<Self> ⓘ
fn with_current_context(self) -> WithContext<Self> ⓘ
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
§fn and<P, B, E>(self, other: P) -> And<T, P>
fn and<P, B, E>(self, other: P) -> And<T, P>
Policy
that returns Action::Follow
only if self
and other
return
Action::Follow
. Read more