#thread #context #golang #scope #scoped #cooperative #crossbeam

ctx-thread

Cooperative, scoped threads based on crossbeam and golang’s context package

2 releases

0.1.1 Oct 22, 2020
0.1.0 Oct 22, 2020

#656 in Concurrency


Used in possum-db

Custom license

22KB
235 lines

tests Actions Status Cargo Documentation

Context-thread

Threads that run within a context.

Most of the time, threads that outlive the parent thread are considered a code smell. ctx-thread ensures that all threads are joined before returning from the scope. Child threads have access to the Context object, which they can use to poll the status of the thread group. If one of the threads panics, the context is cancelled.

Scope

This library is based on the crossbeam's scoped threads:

use ctx_thread::scope;

let people = vec![
    "Alice".to_string(),
    "Bob".to_string(),
    "Carol".to_string(),
];

scope(|ctx| {
    for person in &people {
        ctx.spawn(move |_| {
            println!("Hello, {}", person);
        });
    }
}).unwrap();

Context

Aside from referring to the outer scope, threads may check the extra methods and return if necessary:

use ctx_thread::scope;


scope(|ctx| {
    ctx.spawn(|ctx| {
        while ctx.active() {
            // do work
        }
    });

    ctx.spawn(|ctx| {
        ctx.cancel();
    });
}).unwrap();

Note that these context based cancellations are a form of cooperative scheduling. Threads can still block even if a context expires.

Dependencies

~115KB