https://github.com/sunli829/xactor
Xactor is a rust actors framework based on async-std
https://github.com/sunli829/xactor
actor actor-model async async-std rust rust-lang
Last synced: 10 months ago
JSON representation
Xactor is a rust actors framework based on async-std
- Host: GitHub
- URL: https://github.com/sunli829/xactor
- Owner: sunli829
- License: mit
- Created: 2020-02-18T06:37:40.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-06-08T01:00:17.000Z (over 3 years ago)
- Last Synced: 2025-03-28T12:04:32.194Z (11 months ago)
- Topics: actor, actor-model, async, async-std, rust, rust-lang
- Language: Rust
- Homepage:
- Size: 88.9 KB
- Stars: 216
- Watchers: 6
- Forks: 25
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Xactor is a rust actors framework based on async-std
## Documentation
* [GitHub repository](https://github.com/sunli829/xactor)
* [Cargo package](https://crates.io/crates/xactor)
* Minimum supported Rust version: 1.39 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 xactor::*;
#[message(result = "String")]
struct ToUppercase(String);
struct MyActor;
impl Actor for MyActor {}
#[async_trait::async_trait]
impl Handler for MyActor {
async fn handle(&mut self, _ctx: &mut Context, 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(())
}
```
## Performance
https://github.com/sunli829/xactor-benchmarks
## Installation
Xactor requires [async-trait](https://github.com/dtolnay/async-trait) on userland.
With [cargo add][cargo-add] installed, run:
```sh
$ cargo add xactor
$ cargo add async-trait
```
We also provide the [tokio](https://tokio.rs/) runtime instead of [async-std](https://async.rs/). To use it, you need to activate `runtime-tokio` and disable default features.
You can edit your `Cargo.toml` as follows:
```toml
xactor = { version = "x.x.x", features = ["runtime-tokio"], default-features = false }
```
[cargo-add]: https://github.com/killercup/cargo-edit
## References
* [Actix](https://github.com/actix/actix)
* [Async-std](https://github.com/async-rs/async-std)
* [Tokio](https://github.com/tokio-rs/tokio)