Struct rama::graceful::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§
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,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)§impl<T> Conv for T
impl<T> Conv for T
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
§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> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
§fn and<S, P, B, E>(self, other: P) -> And<T, P>
fn and<S, P, B, E>(self, other: P) -> And<T, P>
Policy
that returns Action::Follow
only if self
and other
return
Action::Follow
. Read more§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.