tasking 0.4.0

Simple tasking utility that automatically replaces tasks based on descriptors.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# Rust Tasking

Simple tasking utility that automatically replaces tasks based on descriptors.

> Currently only [tokio] implementation.

## Utilities

- `Task`: update by descriptor, abort on drop.
- `TaskHub`: update by a list of descriptors, using `Task` internally.

## Usage

```rust
#[derive(PartialEq, Clone, Debug)]
struct MyTaskDescriptor {
  data: String,
}

impl TaskDescriptor for MyTaskDescriptor {
  fn compare(&self, other: &Self) -> bool {
    self == other
  }
}

let task = Task::new(
  "example",
  |MyTaskDescriptor { data }, abort_receiver| async move {
    println!("task data: {data}");

    abort_receiver.await?;

    Ok(())
  },
  Default::default(),
);

task
  .update(MyTaskDescriptor {
    data: "foo".to_owned(),
  })
  .await;
```

Checkout [examples](examples) for usage.

## License

MIT License.

[tokio]: https://tokio.rs/