ascolt 0.1.7

Async runtime-agnostic actor framework
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
52
53

## Ascolt

[![crates.io version](https://img.shields.io/crates/v/ascolt.svg)](https://crates.io/crates/ascolt)
[![docs.rs docs](https://docs.rs/ascolt/badge.svg)](https://docs.rs/ascolt)
[![CI build](https://github.com/sterrlia/ascolt/actions/workflows/rust.yml/badge.svg)](https://github.com/sterrlia/ascolt/actions)
[![Dependency Status](https://deps.rs/crate/ascolt/latest/status.svg)](https://deps.rs/crate/ascolt)
![Minimum Supported Rust Version](https://img.shields.io/badge/rustc-1.85.1+-ab6000.svg)

Async runtime-agnostic actor framework

### Features
+ Clean type-safe syntax
+ Async support
+ Both unbounded and bounded channels supported
+ Handler errors can trigger actor stop, forced stop, or restart (behavior is customizable)
+ No heavy macros
+ No unsafe code

### Examples
``` rust
let first_actor = FirstActor {};
let (first_actor_tx, first_actor_rx) = create_channel(100);
let second_actor = SecondActor { first_actor_tx };
let (second_actor_tx, second_actor_rx) = create_channel(100);

// if using tokio runtime
tokio::spawn(start_actor(actor, first_actor_rx));
tokio::spawn(start_actor(second_actor, second_actor_rx));

first_actor_tx.tell(SomeRequest { number: 3 })
    .await?; // fire-and-forget

let result = second_actor_tx
    .ask(SecondActorCalcRequest(10))
    .await?; // request-response

println!("Result: {}", result.0);
```

More examples located at examples directory.

## What can be added
- Panic isolation
- Backpressure management
- Supervisor for controlling multiple actors
- Dependency graph (e.g., automatically shut down actors when the actors they depend on stop)
- Actor communication over the network

### Alternatives
- [Kameo](https://github.com/tqwewe/kameo)
- [Coerce](https://github.com/LeonHartley/Coerce-rs)
- [Ractor](https://github.com/slawlor/ractor)
- [Actix](https://github.com/actix/actix)