waitx

waitx is a minimal synchronization utility for signaling readiness between threads using a lightweight flag, a condition variable, and optional backoff. It provides a flexible alternative to channels or more heavyweight synchronization primitives when you just need to wait for a single "ready" event.

Features

Waiter: blocks until a flag is set, using backoff + condition variable.
Notifier: sets the flag and notifies a waiting thread.
Setter: sets the flag without notifying.
Spectator: reads the state without modifying it.
Lightweight and no_std-compatible (with alloc).
Built on parking_lot and crossbeam-utils.

Usage

Add to your Cargo.toml:

[dependencies]

waitx = "0.1"

Example

use std::thread;
use waitx::Waiter;

let waiter = Waiter::default();
let notifier = waiter.notifier();

let handle = thread::spawn(move || {
    println!("Worker waiting...");
    waiter.wait();
    println!("Worker resumed!");
});

std::thread::sleep(std::time::Duration::from_millis(100));
notifier.notify();
handle.join().unwrap();

When to Use

Use waitx when you want a simple signaling mechanism:
One thread signals readiness, another waits.
A flag is reused multiple times with resets.
You want fine control over notification vs. just setting state.

Crate Goals