Adding `actify` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add actify

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

actify = "0.7.2"

The actify library will be automatically available globally. Read the actify library documentation.

Back to the crate overview.

Readme

Actify

Note that this crate is under construction. Although used in production, work is done on making an intuitive API, documententation and remaining features. For the time being, this does not follow semantic versioning!

Actify is an actor model built on Tokio that allows annotating any regular implementation block of your own type with the actify! macro.

Benefits

By generating the boilerplate code for you, a few key benefits are provided:

Async actor model build on Tokio and channels, which can keep arbitrary owned data types.
Atomic access and mutation of underlying data through clonable handles.
Typed arguments and return values on the methods from your actor, exposed through each handle.
No need to manually define message structs or enums!
Generic methods like get() and set() even without using the macro.

Example

Consider the following example, in which you want to turn your custom Greeter into an actor:

use actify::{Handle, actify};

#[derive(Clone, std::fmt::Debug)]
struct Greeter {}

#[actify]
impl Greeter {
    fn say_hi(&self, name: String) -> String {
        format!("hi {}", name)
    }
}

#[tokio::main]
async fn main() {
// An actify handle is created and initialized with the Greeter struct
let handle = Handle::new(Greeter {});

// The say_hi method is made available on its handle through the actify! macro
let greeting = handle.say_hi("Alfred".to_string()).await.unwrap();

// The method is executed remotely on the initialized Greeter and returned through the handle
assert_eq!(greeting, "hi Alfred".to_string())
}

Adding actify library as a dependency

Adding `actify` library as a dependency