qubit-executor 0.3.4

Executor abstractions, task handles, and basic executor implementations for Qubit Rust libraries
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
30
31

/*******************************************************************************
 *
 *    Copyright (c) 2025 - 2026 Haixing Hu.
 *
 *    SPDX-License-Identifier: Apache-2.0
 *
 *    Licensed under the Apache License, Version 2.0.
 *
 ******************************************************************************/
use super::{
    cancel_result::CancelResult,
    task_result_handle::TaskResultHandle,
    task_status::TaskStatus,
};

/// Extension interface for handles that expose active task tracking.
pub trait TrackedTaskHandle<R, E>: TaskResultHandle<R, E> {
    /// Returns the currently observed task status.
    ///
    /// # Returns
    ///
    /// The current pending, running, or terminal task status.
    fn status(&self) -> TaskStatus;

    /// Attempts to cancel the task before it starts.
    ///
    /// # Returns
    ///
    /// A precise cancellation result describing whether cancellation won.
    fn cancel(&self) -> CancelResult;
}