14 unstable releases (3 breaking)

0.4.2 May 17, 2024
0.3.3 Mar 14, 2024
0.3.0 Dec 28, 2023
0.2.1 Aug 14, 2023
0.2.0 Jul 31, 2023

#193 in Concurrency

Download history 54/week @ 2024-02-25 174/week @ 2024-03-03 163/week @ 2024-03-10 57/week @ 2024-03-17 13/week @ 2024-03-24 43/week @ 2024-03-31 11/week @ 2024-04-07 3/week @ 2024-04-21 288/week @ 2024-05-05 171/week @ 2024-05-12 56/week @ 2024-05-19 8/week @ 2024-05-26 19/week @ 2024-06-02 74/week @ 2024-06-09

177 downloads per month

MIT license

59KB
1K SLoC

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.

Crates.io License Docs

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())
}

Dependencies

~3–10MB
~91K SLoC