actix-lua

A safe scripting environment for actix with the Lua Programming Language.

Synopsis

```rust extern crate actixlua; use actixlua::{LuaActorBuilder, LuaMessage};

fn main () { let addr = LuaActorBuilder::new() .onhandlewith_lua(r#"return ctx.msg + 42"#) .build() .unwrap() .start();

let res = add.send(LuaMessage:from(100));
// return: 142

} ```

Install

Add actix-lua to your Cargo.toml:

toml [dependencies] actix-lua = "0.3"

Message

Lua is a dynamic typed language. We use one message type LuaMessage to represent all kind of types of a message Lua can send/receive.

You can convert most of the primitive types to LuaMessage with LuaMessage::from().

Lua API

ctx.msg

The message sent to Lua actor.

ctx.notify(msg)

Send message msg to self.

ctx.notify_later(msg, seconds)

Send message msg to self after specified period of time.

local recipient = ctx.new_actor(script_path, [actor_name])

Create a new actor with given lua script. returns a recipient which can be used in ctx.send and ctx.do_send.

local result = ctx.send(recipient, msg)

Send message msg to `recipient asynchronously and wait for response.

Equivalent to actix::Recipient.send.

ctx.do_send(recipient, msg)

Send message msg to recipient.

Equivalent to actix::Recipient.do_send.

ctx.terminate()

Terminate actor execution.

License

The MIT License