1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

/*!
The [lunatic vm](https://lunatic.solutions/) is a system for creating actors from WebAssembly
modules. This `lunatic-runtime` library allows you to embed the `lunatic vm` inside your Rust
code.

> _The actor model in computer science is a mathematical model of concurrent computation that
treats actor as the universal primitive of concurrent computation. In response to a message it
receives, an actor can: make local decisions, create more actors, send more messages, and
determine how to respond to the next message received. Actors may modify their own private
state, but can only affect each other indirectly through messaging (removing the need for
lock-based synchronization)._
>
> Source: <https://en.wikipedia.org/wiki/Actor_model>

_**Note:** If you are looking to build actors in Rust and compile them to `lunatic` compatible
Wasm modules, checkout out the [lunatic crate](https://crates.io/crates/lunatic)_.

## Core Concepts

* [`Environment`] - defines the characteristics of Processes that are spawned into it. An
  [`Environment`] is created with an [`EnvConfig`] to tweak various settings, like maximum
  memory and compute usage.

* [`WasmProcess`](process::WasmProcess) - a handle to send signals and messages to spawned
  Wasm processes. It implements the [`Process`](process::Process) trait.

## Plugins

TODO

## WebAssembly module requirements

TODO
*/

pub(crate) mod api;
pub mod async_map;
mod config;
mod environment;
pub(crate) mod mailbox;
pub mod message;
pub(crate) mod module;
pub mod node;
pub mod plugin;
pub(crate) mod process;
pub mod registry;
pub(crate) mod state;

use async_std::sync::RwLock;
use lazy_static::lazy_static;

pub use config::EnvConfig;
pub use environment::Environment;
use node::Node;
pub use process::{spawn, Finished, Process, Signal, WasmProcess};

// Global node singleton.
lazy_static! {
    pub static ref NODE: RwLock<Option<Node>> = RwLock::new(None);
}