qubit-clock 0.11.0

Injectable wall and monotonic clocks with deterministic timers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

// =============================================================================
//    Copyright (c) 2025 - 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Defines errors caused by an unavailable ambient Tokio runtime.

use thiserror::Error;
use tokio::runtime::TryCurrentError;

/// Describes why a Tokio-backed type cannot capture the current runtime.
///
/// This error occurs only in `try_current` constructors. Once constructed, a
/// Tokio clock or timer uses its retained runtime handle and does not depend on
/// the caller's ambient runtime context. The enum is non-exhaustive; callers
/// must retain a fallback arm when matching it.
#[non_exhaustive]
#[derive(Debug, Error)]
pub enum TokioRuntimeError {
    /// No Tokio runtime is entered on the current thread.
    #[error("no Tokio runtime is entered: {source}")]
    NotEntered {
        /// Runtime lookup error reported by Tokio.
        #[source]
        source: TryCurrentError,
    },
}