12 releases (7 breaking)

0.10.0 Aug 13, 2024
0.9.0 May 31, 2024
0.8.3 Feb 28, 2023
0.8.2 Sep 7, 2022
0.4.1 Mar 4, 2021

#122 in Concurrency

Download history 5/week @ 2024-06-24 13/week @ 2024-07-01 20/week @ 2024-07-29 137/week @ 2024-08-12 7/week @ 2024-08-19 7/week @ 2024-08-26 4/week @ 2024-09-09 17/week @ 2024-09-16 45/week @ 2024-09-23 21/week @ 2024-09-30

87 downloads per month
Used in downtown

MIT license

70KB
1K SLoC

tonari-actor

Crates.io Documentation

This crate aims to provide a minimalist and high-performance actor framework for Rust with significantly less complexity than other frameworks like Actix.

In this framework, each Actor is its own OS-level thread. This makes debugging noticeably simpler, and is suitably performant when the number of actors is less than or equal to the number of CPU threads.

Example

use tonari_actor::{Actor, Context, System};

struct TestActor {}

impl Actor for TestActor {
    type Error = ();
    type Message = usize;

    fn name() -> &'static str {
        "TestActor"
    }

    fn handle(&mut self, _context: &Context<Self>, message: Self::Message) -> Result<(), ()> {
        println!("message: {}", message);

        Ok(())
    }
}

fn main() {
    let mut system = System::new("default");

    // will spin up a new thread running this actor
    let addr = system.spawn(TestActor {}).unwrap();

    // send messages to actors to spin off work...
    addr.send(1usize).unwrap();

    // ask the actors to finish and join the threads.
    system.shutdown().unwrap();
}

Dependencies

  • cargo
  • rustc

Build

$ cargo build --release

Testing

$ cargo test

Code Format

The formatting options currently use nightly-only options.

$ cargo +nightly fmt

Code Linting

$ cargo clippy

Dependencies

~1.6–7MB
~32K SLoC