https://github.com/teaentitylab/rustluaactor
Lua Actor implementation for Rust (in sync/async modes)
https://github.com/teaentitylab/rustluaactor
actor-library actor-model async async-functions async-programming asynchronous asynchronous-programming asynctask lua lua-binding lua-bindings lua-library lua-script rust rust-bindings rust-crate rust-lang rust-language rust-library rustlang
Last synced: about 2 months ago
JSON representation
Lua Actor implementation for Rust (in sync/async modes)
- Host: GitHub
- URL: https://github.com/teaentitylab/rustluaactor
- Owner: TeaEntityLab
- License: mit
- Created: 2018-08-04T16:49:33.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2021-07-26T14:14:20.000Z (almost 4 years ago)
- Last Synced: 2025-03-23T23:15:49.524Z (2 months ago)
- Topics: actor-library, actor-model, async, async-functions, async-programming, asynchronous, asynchronous-programming, asynctask, lua, lua-binding, lua-bindings, lua-library, lua-script, rust, rust-bindings, rust-crate, rust-lang, rust-language, rust-library, rustlang
- Language: Rust
- Size: 44.9 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rustLuaActor
[](https://github.com/TeaEntityLab/rustLuaActor)
[](https://crates.io/crates/lua_actor)
[](https://travis-ci.org/TeaEntityLab/rustLuaActor)
[](https://docs.rs/lua_actor/)
[](https://github.com/TeaEntityLab/rustLuaActor)
[](https://github.com/TeaEntityLab/rustLuaActor)
[](https://github.com/TeaEntityLab/rustLuaActor)
Lua Actor implementation for Rust (in sync/async modes)
# Why
I love Lua scripting; however it's hard to communicate between Lua & Rust, specially in some async scenarios.
Thus I implemented rustLuaActor. I hope you would like it :)
# Features
* Actor (*`lua_actor::actor`*)
* An Lua actor (sync/async)
* You could run it on the specific handler (*`fp_rust::handler::HandlerThread`*)
# Dependencies
* [fp_rust](https://crates.io/crates/fp_rust)
* [rlua](https://crates.io/crates/rlua)
# Setup
*`Cargo.toml`*:
```
fp_rust="*"
rlua="*"
lua_actor="*"
```
# Contribution
Special Thanks to [poga's actix-lua](https://github.com/poga/actix-lua).
Most of *`LuaMessage`* parts are coded by him (except `Array` & reverse conversions).
# Usage
## Actor (sync/async)
Example:
```rust
extern crate rlua;
extern crate fp_rust;
extern crate lua_actor;
fn main() {
use rlua::{Variadic};
use lua_actor::{actor::Actor, message::LuaMessage};
fn test_actor(act: Actor) {
let _ = act.exec_nowait(
r#"
i = 1
"#,
None,
);
assert_eq!(Some(1), Option::from(act.get_global("i").ok().unwrap()));
let v = act.eval(
r#"
3
"#,
None,
);
assert_eq!(Some(3), Option::from(v.ok().unwrap()));
act.exec(
r#"
function testit (i)
return i + 1
end
"#,
None,
).ok().unwrap();
match act.call("testit", LuaMessage::from(1)) {
Ok(_v) => {
assert_eq!(Some(2), Option::from(_v));
}
Err(_err) => {
println!("{:?}", _err);
panic!(_err);
}
}
{
act.def_fn_with_name_nowait(|_, (list1, list2): (Vec, Vec)| {
// This function just checks whether two string lists are equal, and in an inefficient way.
// Lua callbacks return `rlua::Result`, an Ok value is a normal return, and an Err return
// turns into a Lua 'error'. Again, any type that is convertible to lua may be returned.
Ok(list1 == list2)
}, "check_equal").ok().unwrap();
act.def_fn_with_name_nowait(
|_, strings: Variadic| {
// (This is quadratic!, it's just an example!)
Ok(strings.iter().fold("".to_owned(), |a, b| a + b))
},
"join",
).ok()
.unwrap();
assert_eq!(
Option::::from(
act.eval(r#"check_equal({"a", "b", "c"}, {"a", "b", "c"})"#, None)
.ok()
.unwrap()
).unwrap(),
true
);
assert_eq!(
Option::::from(
act.eval(r#"check_equal({"a", "b", "c"}, {"d", "e", "f"})"#, None)
.ok()
.unwrap()
).unwrap(),
false
);
assert_eq!(
Option::::from(act.eval(r#"join("a", "b", "c")"#, None).ok().unwrap())
.unwrap(),
"abc"
);
}
act.set_global(
"arr1",
LuaMessage::from(vec![LuaMessage::from(1), LuaMessage::from(2)]),
).ok()
.unwrap();
let v = Option::>::from(act.get_global("arr1").ok().unwrap());
assert_eq!(LuaMessage::from(1), v.clone().unwrap()[0]);
assert_eq!(LuaMessage::from(2), v.clone().unwrap()[1]);
assert_eq!(2, v.clone().unwrap().len());
}
let _ = test_actor(Actor::new_with_handler(None));
let _ = test_actor(Actor::new());
}
```