#graceful-shutdown #shutdown #shutdown-signal #cancel #graceful #signal

cancellation-token

A Rust implementation of C#'s CancellationToken API

2 releases

0.1.1 Jul 23, 2024
0.1.0 Aug 20, 2023

#376 in Asynchronous

MIT/Apache

18KB
341 lines

cancellation-token-rs

Crates.io Docs.rs Actions Status

A Rust implementation of C#'s CancellationToken API.

Example

use cancellation_token::{CancellationToken, CancellationTokenSource, MayBeCanceled};

fn cancelable_function(ct: &CancellationToken) -> MayBeCanceled<u32> {
    for _ in 0..100 {
        ct.canceled()?; // Return from this function if canceled
        heavy_work();
    }
    Ok(100)
}
fn heavy_work() { }

fn main() {
    let cts = CancellationTokenSource::new();
    std::thread::scope(|s| {
        s.spawn(|| {
            std::thread::sleep(std::time::Duration::from_secs(2));
            cts.cancel();
        });
        if cancelable_function(&cts.token()).is_err() {
            println!("canceled");
        }
    });
}

License

This project is dual licensed under Apache-2.0/MIT. See the two LICENSE-* files for details.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.3–0.8MB
~18K SLoC