Why

Credit where credit is due: Hannibal is a fork of the excellent Xactor which unfortunately received very little interest by its original maintainer recently.

Documentation

• GitHub repository
• Cargo package
• Minimum supported Rust version: 1.56 or later

Features

• Async actors.
• Actor communication in a local context.
• Using Futures for asynchronous message handling.
• Typed messages (No Any type). Generic messages are allowed.

Examples

```rust use hannibal::*;

[message(result = "String")]

struct ToUppercase(String);

struct MyActor;

impl Actor for MyActor {}

[asynctrait::asynctrait]

impl Handler for MyActor { async fn handle(&mut self, ctx: &mut Context, msg: ToUppercase) -> String { msg.0.touppercase() } }

[hannibal::main]

async fn main() -> Result<()> { // Start actor and get its address let mut addr = MyActor.start().await?;

// Send message `ToUppercase` to actor via addr
let res = addr.call(ToUppercase("lowercase".to_string())).await?;
assert_eq!(res, "LOWERCASE");
Ok(())

} ```

Installation

Hannibal requires async-trait on userland.

With cargo add installed, run:

sh $ cargo add hannibal $ cargo add async-trait

We also provide the tokio runtime instead of async-std. To use it, you need to activate runtime-tokio and disable default features.

You can edit your Cargo.toml as follows:

toml hannibal = { version = "x.x.x", features = ["runtime-tokio"], default-features = false }

References

• Actix
• Async-std
• Tokio
• Hannibal