lifetime-thread

Crates.iolifetime-thread
lib.rslifetime-thread
version0.3.0
sourcesrc
created_at2020-08-15 09:15:01.457994
updated_at2021-01-10 05:31:12.314077
descriptionA thread with a lifetime. Divide a value into master and slave. After the lifetime of the master value ends, the slave value will not be accessible.
homepage
repositoryhttps://github.com/liangyongrui/lifetime-thread
max_upload_size
id276928
size25,238
Liang Yongrui (liangyongrui)

documentation

README

Lifetime Thread

A lock-free thread with a lifetime. Divide a value into master and slave. After the lifetime of the master value ends, the slave value will not be accessible.

Crates.io version Download docs.rs docs ci

Introduction

A lock-free thread with a lifetime. Divide a value into master and slave. After the lifetime of the master value ends, the slave value will not be accessible.

scenes to be used:

  • An operation needs to be performed in the background, but the lifetime is not static
  • ...

Basic usage

use std::{thread, time::Duration};

#[test]
fn it_works() {
    let s = "xxx";
    let outer = lifetime_thread::spawn(s, |inner| {
        println!("begin");
        while let Some(t) = inner.get() {
            println!("ok! {}", t);
            assert_eq!(*t, "xxx");
            thread::sleep(Duration::from_millis(1));
        }
        println!("over")
    });
    thread::sleep(Duration::from_millis(10));
    assert_eq!(*outer, "xxx")
}

#[tokio::test]
async fn async_works() {
    let s = "xxx";
    let outer = lifetime_thread::async_spawn(s, |inner| async move {
        println!("begin");
        while let Some(t) = inner.get() {
            println!("ok! {}", t);
            assert_eq!(*t, "xxx");
            tokio::time::sleep(Duration::from_millis(1)).await;
        }
        println!("over")
    });
    tokio::time::sleep(Duration::from_millis(10)).await;
    assert_eq!(*outer, "xxx");
    drop(outer);
}

output:

begin
ok! xxx
ok! xxx
...
...
ok! xxx
over

Features

  • Different runtime
    • sync (Multithreading): lifetime_thread::spawn
    • tokio: lifetime_thread::async_spawn

License

Licensed under either of

at your option.

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

Commit count: 8

cargo fmt