#thread #counter #condvar

thread-counter

A simple way of efficiently keeping track of active threads and waiting for them to exit

2 releases

0.1.1 Oct 10, 2024
0.1.0 Oct 8, 2024

#261 in Concurrency

Download history 267/week @ 2024-10-06 26/week @ 2024-10-13 1/week @ 2024-10-20

294 downloads per month

MIT/Apache

10KB
90 lines

Crates.io Version Crates.io License Crates.io Downloads (recent) Crates.io Size Maintenance

thread-counter

A lightweight, thread-safe library for counting and synchronizing concurrent operations.

This crate provides a ThreadCounter type that can be used to keep track of the number of active threads or operations, and to synchronize the completion of these operations. It's particularly useful for scenarios where you need to wait for a group of tasks to complete before proceeding.

Features

  • Thread-safe counting of active operations.
  • RAII-based automatic decrementing using Tickets.
  • Ability to wait for all operations to complete, with optional timeout.

Usage

Here's a basic example of how to use the ThreadCounter:

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

let counter = ThreadCounter::default();

// Spawn some threads
for _ in 0..5 {
	thread::spawn(move || {
		// Take a ticket, incrementing the counter.
		let ticket = counter.ticket();
		// Simulate some work
		thread::sleep(Duration::from_millis(100));
		// `ticket` is automatically dropped here, decrementing the counter
	});
}

// Wait for all threads to complete, timing out after 200ms.
counter.wait(Duration::from_millis(200));
println!("All threads have completed!");

Current version: 0.1.0

Some additional info here

License

thread-counter is dual-licensed under the MIT license and the Apache License (Version 2.0).

Dependencies

~0.4–5MB
~11K SLoC