Struct rustyscript::Runtime
source · pub struct Runtime(/* private fields */);
Expand description
Represents a configured runtime ready to run modules
Implementations§
source§impl Runtime
impl Runtime
sourcepub const EMPTY_ARGS: &'static FunctionArguments = _
pub const EMPTY_ARGS: &'static FunctionArguments = _
The lack of any arguments - used to simplify calling functions Prevents you from needing to specify the type using ::<serde_json::Value>
sourcepub fn new(options: RuntimeOptions) -> Result<Self, Error>
pub fn new(options: RuntimeOptions) -> Result<Self, Error>
Creates a new instance of the runtime with the provided options.
§Arguments
options
- ARuntimeOptions
struct that specifies the configuration options for the runtime.
§Returns
A Result
containing either the initialized runtime instance on success (Ok
) or an error on failure (Err
).
§Example
use rustyscript::{ json_args, Runtime, RuntimeOptions, Module };
use std::time::Duration;
// Creates a runtime that will attempt to run function load() on start
// And which will time-out after 50ms
let mut runtime = Runtime::new(RuntimeOptions {
default_entrypoint: Some("load".to_string()),
timeout: Duration::from_millis(50),
..Default::default()
})?;
let module = Module::new("test.js", "
export const load = () => {
return 'Hello World!';
}
");
let module_handle = runtime.load_module(&module)?;
let value: String = runtime.call_entrypoint(&module_handle, json_args!())?;
assert_eq!("Hello World!", value);
sourcepub fn deno_runtime(&mut self) -> &mut JsRuntime
pub fn deno_runtime(&mut self) -> &mut JsRuntime
Access the underlying deno runtime instance directly
sourcepub fn options(&self) -> &RuntimeOptions
pub fn options(&self) -> &RuntimeOptions
Access the options used to create this runtime
sourcepub fn arg<A>(value: A) -> Result<Value, Error>where
A: Serialize,
pub fn arg<A>(value: A) -> Result<Value, Error>where
A: Serialize,
Encode an argument as a json value for use as a function argument
use rustyscript::{ Runtime, RuntimeOptions, Module };
use serde::Serialize;
use std::time::Duration;
let module = Module::new("test.js", "
function load(obj) {
console.log(`Hello world: a=${obj.a}, b=${obj.b}`);
}
rustyscript.register_entrypoint(load);
");
#[derive(Serialize)]
struct MyStruct {a: usize, b: usize}
Runtime::execute_module(
&module, vec![],
Default::default(),
&[
Runtime::arg(MyStruct{a: 1, b: 2})?,
]
)?;
sourcepub fn into_arg<A>(value: A) -> Value
pub fn into_arg<A>(value: A) -> Value
Encode a primitive as a json value for use as a function argument
Only for types with Into<Value>
. For other types, use Runtime::arg
use rustyscript::{ Runtime, RuntimeOptions, Module };
use std::time::Duration;
let module = Module::new("test.js", "
function load(a, b) {
console.log(`Hello world: a=${a}, b=${b}`);
}
rustyscript.register_entrypoint(load);
");
Runtime::execute_module(
&module, vec![],
Default::default(),
&[
Runtime::into_arg("test"),
Runtime::into_arg(5),
]
)?;
sourcepub fn take<T>(&mut self) -> Option<T>where
T: 'static,
pub fn take<T>(&mut self) -> Option<T>where
T: 'static,
Remove and return a value from the state, if one exists
use rustyscript::{ Runtime };
let mut runtime = Runtime::new(Default::default())?;
runtime.put("test".to_string())?;
let value: String = runtime.take().unwrap();
assert_eq!(value, "test");
sourcepub fn put<T>(&mut self, value: T) -> Result<(), Error>where
T: 'static,
pub fn put<T>(&mut self, value: T) -> Result<(), Error>where
T: 'static,
Add a value to the state Only one value of each type is stored - additional calls to put overwrite the old value
use rustyscript::{ Runtime };
let mut runtime = Runtime::new(Default::default())?;
runtime.put("test".to_string())?;
let value: String = runtime.take().unwrap();
assert_eq!(value, "test");
sourcepub fn register_function(
&mut self,
name: &str,
callback: RsFunction
) -> Result<(), Error>
pub fn register_function( &mut self, name: &str, callback: RsFunction ) -> Result<(), Error>
Register a rust function to be callable from JS
use rustyscript::{ Runtime, Module, serde_json::Value };
let module = Module::new("test.js", " rustyscript.functions.foo(); ");
let mut runtime = Runtime::new(Default::default())?;
runtime.register_function("foo", |args, _state| {
if let Some(value) = args.get(0) {
println!("called with: {}", value);
}
Ok(Value::Null)
})?;
sourcepub fn call_stored_function<T>(
&mut self,
module_context: &ModuleHandle,
function: &JsFunction<'_>,
args: &FunctionArguments
) -> Result<T, Error>where
T: DeserializeOwned,
pub fn call_stored_function<T>(
&mut self,
module_context: &ModuleHandle,
function: &JsFunction<'_>,
args: &FunctionArguments
) -> Result<T, Error>where
T: DeserializeOwned,
Calls a stored javascript function and deserializes its return value.
§Arguments
function
- A The function object
§Returns
A Result
containing the deserialized result of the function call (T
)
or an error (Error
) if the function cannot be found, if there are issues with
calling the function, or if the result cannot be deserialized.
sourcepub fn call_function<T>(
&mut self,
module_context: &ModuleHandle,
name: &str,
args: &FunctionArguments
) -> Result<T, Error>where
T: DeserializeOwned,
pub fn call_function<T>(
&mut self,
module_context: &ModuleHandle,
name: &str,
args: &FunctionArguments
) -> Result<T, Error>where
T: DeserializeOwned,
Calls a javascript function within the Deno runtime by its name and deserializes its return value.
§Arguments
name
- A string representing the name of the javascript function to call.
§Returns
A Result
containing the deserialized result of the function call (T
)
or an error (Error
) if the function cannot be found, if there are issues with
calling the function, or if the result cannot be deserialized.
§Example
use rustyscript::{ json_args, Runtime, Module, Error };
let mut runtime = Runtime::new(Default::default())?;
let module = Module::new("/path/to/module.js", "export function f() { return 2; };");
let module = runtime.load_module(&module)?;
let value: usize = runtime.call_function(&module, "f", json_args!())?;
sourcepub fn get_value<T>(
&mut self,
module_context: &ModuleHandle,
name: &str
) -> Result<T, Error>where
T: DeserializeOwned,
pub fn get_value<T>(
&mut self,
module_context: &ModuleHandle,
name: &str
) -> Result<T, Error>where
T: DeserializeOwned,
Get a value from a runtime instance
§Arguments
name
- A string representing the name of the value to find
§Returns
A Result
containing the deserialized result or an error (Error
) if the
value cannot be found, if there are issues with, or if the result cannot be
deserialized.
§Example
use rustyscript::{ Runtime, Module, Error };
let mut runtime = Runtime::new(Default::default())?;
let module = Module::new("/path/to/module.js", "globalThis.my_value = 2;");
let module = runtime.load_module(&module)?;
let value: usize = runtime.get_value(&module, "my_value")?;
sourcepub fn load_module(&mut self, module: &Module) -> Result<ModuleHandle, Error>
pub fn load_module(&mut self, module: &Module) -> Result<ModuleHandle, Error>
Executes the given module, and returns a handle allowing you to extract values And call functions
§Arguments
module
- AModule
object containing the module’s filename and contents.
§Returns
A Result
containing a handle for the loaded module
or an error (Error
) if there are issues with loading modules, executing the
module, or if the result cannot be deserialized.
§Example
// Create a module with filename and contents
use rustyscript::{Runtime, Module, Error};
let mut runtime = Runtime::new(Default::default())?;
let module = Module::new("test.js", "rustyscript.register_entrypoint(() => 'test')");
runtime.load_module(&module);
sourcepub fn load_modules(
&mut self,
module: &Module,
side_modules: Vec<&Module>
) -> Result<ModuleHandle, Error>
pub fn load_modules( &mut self, module: &Module, side_modules: Vec<&Module> ) -> Result<ModuleHandle, Error>
Executes the given module, and returns a handle allowing you to extract values And call functions.
This will load ‘module’ as the main module, and the others as side-modules. Only one main module can be loaded per runtime
§Arguments
module
- AModule
object containing the module’s filename and contents.side_modules
- A set of additional modules to be loaded into memory for use
§Returns
A Result
containing a handle for the loaded module
or an error (Error
) if there are issues with loading modules, executing the
module, or if the result cannot be deserialized.
§Example
// Create a module with filename and contents
use rustyscript::{Runtime, Module, Error};
let mut runtime = Runtime::new(Default::default())?;
let module = Module::new("test.js", "rustyscript.register_entrypoint(() => 'test')");
runtime.load_modules(&module, vec![]);
sourcepub fn call_entrypoint<T>(
&mut self,
module_context: &ModuleHandle,
args: &FunctionArguments
) -> Result<T, Error>where
T: DeserializeOwned,
pub fn call_entrypoint<T>(
&mut self,
module_context: &ModuleHandle,
args: &FunctionArguments
) -> Result<T, Error>where
T: DeserializeOwned,
Executes the entrypoint function of a module within the Deno runtime.
§Arguments
module_context
- A handle returned by loading a module into the runtime
§Returns
A Result
containing the deserialized result of the entrypoint execution (T
)
if successful, or an error (Error
) if the entrypoint is missing, the execution fails,
or the result cannot be deserialized.
§Example
use rustyscript::{json_args, Runtime, Module, Error};
let mut runtime = Runtime::new(Default::default())?;
let module = Module::new("test.js", "rustyscript.register_entrypoint(() => 'test')");
let module = runtime.load_module(&module)?;
// Run the entrypoint and handle the result
let value: String = runtime.call_entrypoint(&module, json_args!())?;
sourcepub fn execute_module<T>(
module: &Module,
side_modules: Vec<&Module>,
runtime_options: RuntimeOptions,
entrypoint_args: &FunctionArguments
) -> Result<T, Error>where
T: DeserializeOwned,
pub fn execute_module<T>(
module: &Module,
side_modules: Vec<&Module>,
runtime_options: RuntimeOptions,
entrypoint_args: &FunctionArguments
) -> Result<T, Error>where
T: DeserializeOwned,
Loads a module into a new runtime, executes the entry function and returns the
result of the module’s execution, deserialized into the specified Rust type (T
).
§Arguments
module
- AModule
object containing the module’s filename and contents.side_modules
- A set of additional modules to be loaded into memory for useruntime_options
- Options for the creation of the runtimeentrypoint_args
- Arguments to pass to the entrypoint function
§Returns
A Result
containing the deserialized result of the entrypoint execution (T
)
if successful, or an error (Error
) if the entrypoint is missing, the execution fails,
or the result cannot be deserialized.
§Example
// Create a module with filename and contents
use rustyscript::{json_args, Runtime, Module, Error};
let module = Module::new("test.js", "rustyscript.register_entrypoint(() => 2)");
let value: usize = Runtime::execute_module(&module, vec![], Default::default(), json_args!())?;
Auto Trait Implementations§
impl Freeze for Runtime
impl !RefUnwindSafe for Runtime
impl !Send for Runtime
impl !Sync for Runtime
impl Unpin for Runtime
impl !UnwindSafe for Runtime
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> FmtForward for T
impl<T> FmtForward for T
source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read moresource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read moresource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R ) -> R
source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.source§impl<T> Tap for T
impl<T> Tap for T
source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read moresource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read moresource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read moresource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read moresource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read moresource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read moresource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.