2 releases

0.0.1 Apr 21, 2024
0.0.0 Feb 26, 2024

#65 in #actor-framework

Download history 153/week @ 2024-02-24 16/week @ 2024-03-02 7/week @ 2024-03-09 9/week @ 2024-03-30 171/week @ 2024-04-20 4/week @ 2024-04-27

175 downloads per month

MIT/Apache

17KB
408 lines

Shakespeare

Version Build release date codecov Licence Downloads

Shakespeare is an actor framework written in Rust that focuses on ergonomics and extensibility while maintaining high performance.

Its most significant features include:

  • Polymorphic actors - actors' interfaces are a first-class consideration in shakespeare, and allowing code to work over dynamically chosen actors is a primary use case.
  • Rich interfaces - a single interface for an actor can support any number of methods with no more boilerplate than the equivalent trait definition.
  • Static validation - the majority of functionality is implemented by procedural macros, minimizing direct runtime overhead and offering more visibility to the optimizer without sacrificing static type checking at any point.
  • Interoperability - linking actors into the wider ecosystem of async code is designed to be easy.

Example

use tokio::sync::mpsc::*;

#[shakespeare::actor]
mod Actor {
    struct ActorState {
        sender: UnboundedSender<usize>,
    }
    #[shakespeare::performance(canonical)]
    impl BasicRole for ActorState {
        fn speak(&mut self, val: usize) {
            self.sender.send(val).unwrap();
        }
    }
}

#[tokio::test]
async fn main() {
    let (sender, mut recv) = tokio::sync::mpsc::unbounded_channel();
    let state = ActorState { sender };
    let shakespeare::ActorSpawn { actor, .. } = ActorState::start(state);
    actor.speak(42).await.expect("Error sending");
    assert_eq!(recv.recv().await.unwrap(), 42);
}

Licence

Licensed under either of Apache Licence, Version 2.0 or MIT licence at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 licence, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~4–11MB
~108K SLoC