4 releases
0.0.4 | Jan 31, 2019 |
---|---|
0.0.3 | Jan 31, 2019 |
0.0.2 | Jan 31, 2019 |
0.0.1 | Jan 30, 2019 |
#6 in #duktape
21KB
417 lines
duktape-rs
Safe(er) rust wrapper for dukbind.
Work In Progress
This library is a work in progress and is currently limited in features.
What can it do?
At the moment, duktape-rs
-
Provides a safe* wrapper around dukbind (raw FFI bindings for duktape).
-
Provides manageable value returns that can be modified and passed back to the duktape context.
-
Supports heap pointers (for objects), including setting and getting properties of an object (as DukValue).
-
Can eval a &str and return the result (DukResult<DukValue, DukError>)
-
Supports handling (what I assume to be) most JS errors that crop up during eval minimally tested
*Safety not guaranteed
Where are the docs?
For some reason docs.rs has a problem with compiling dukbind and won't generate them :/ Check back another time for documentation Coming Soon™
Basics
extern crate duktape-rs;
use duktape-rs::DukContext;
fn main() {
// Create a new context
let mut ctx = DukContext::new();
// Eval 5+5
let val = ctx.eval_string("5+5").unwrap();
// Destroy the heap (do this when you are done using the context)
ctx.destroy();
// Compare the value as an i64 against 10
assert_eq!(val.as_i64().expect("Not an i64"), 10)
}
Objects
Objects in duktape are returned as heap pointers that have to be stored and returned as a wrapper around that pointer.
let mut ctx = DukContext::new();
let obj = ctx.eval_string("({ok: true})").unwrap().as_object().expect("Not an object");
let val = obj.get_prop("ok").unwrap().as_bool().expect("Not a bool");
println!("Value: {}", val); //-> Value: true
Dependencies
~13MB
~249K SLoC