- GitHub repository
- Cargo package
- Minimum supported Rust version: 1.39 or later
- Async actors.
- Actor communication in a local context.
- Using Futures for asynchronous message handling.
- Typed messages (No
Anytype). Generic messages are allowed.
use xactor::*;
#[message(result = "String")]
struct ToUppercase(String);
struct MyActor;
impl Actor for MyActor {}
#[async_trait::async_trait]
impl Handler<ToUppercase> for MyActor {
async fn handle(&mut self, _ctx: &Context<Self>, msg: ToUppercase) -> String {
msg.0.to_uppercase()
}
}
#[xactor::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(())
}| Wait for response | Send only | |
|---|---|---|
| Actix | 1548 ms | 14 ms |
| Xactor | 930 ms | 18 ms |
Xactor require async-trait on useland
With cargo add installed run:
$ cargo add xactor
$ cargo add async-traitWe also provide a set of "tokio-runtime" features instead of async-std.
to use it you need activate feautre: runtime-tokio and desable default.
You can edit your Cargo.toml has following:
xactor = { version = "x.x.x", features = ["runtime-tokio"], default-features = false }