Struct Universe

pub struct Universe { /* private fields */ }

Universe serves as the top-level context in which Actor can be spawned. It is not a singleton. A typical application will usually have only one universe hosting all of the actors but it is not a requirement.

In particular, unit test all have their own universe and hence can be executed in parallel.

Implementations

impl Universe

pub fn new() -> Universe

Creates a new universe.

pub fn kill(&self)

pub async fn simulate_time_shift(&self, duration: Duration)

Simulate advancing the time for unit tests.

It is not just about jumping the clock and triggering one round of messages: These message might have generated more messages for instance.

This simulation triggers progress step by step, and after each step, leaves 100ms for actors to schedule extra messages.

pub fn spawn_actor<A: Actor>(&self, actor: A) -> SpawnBuilder<A>

pub async fn send_exit_with_success<A: Actor>( &self, mailbox: &Mailbox<A>, ) -> Result<(), SendError>

Inform an actor to process pending message and then stop processing new messages and exit successfully.

Trait Implementations

impl Drop for Universe

fn drop(&mut self)

Executes the destructor for this type.