pub struct SnapshotBuilder { /* private fields */ }
snapshot_builder
only.Expand description
A more restricted version of the Runtime
struct that is used to create a snapshot of the runtime state
This runtime should ONLY be used to create a snapshot, and not for normal use
Snapshots can be used to massively decrease the startup time of a Runtime instance (15ms -> 3ms) by pre-loading extensions and modules into the runtime state before it is created. A snapshot can be used on any runtime with the same set of extensions and options as the runtime that created it.
This struct is only available when the snapshot_builder
feature is enabled
Once you’ve set up the runtime, you can call into_snapshot
to get the snapshot
You should save it to a file and load it with include_bytes!
in order to use it
in the RuntimeOptions
struct’s startup_snapshot
field
§Example
use rustyscript::{SnapshotBuilder, Module, Error};
use std::fs;
let module = Module::new("example.js", "export function example() { return 42; }");
let snapshot = SnapshotBuilder::new(Default::default())?
.with_module(&module)?
.finish();
// Save the snapshot to a file
fs::write("snapshot.bin", snapshot)?;
// To use the snapshot, load it with `include_bytes!` into the `RuntimeOptions` struct:
// const STARTUP_SNAPSHOT: &[u8] = include_bytes!("snapshot.bin");
// RuntimeOptions {
// startup_snapshot: Some(STARTUP_SNAPSHOT),
// ..Default::default()
// };
Implementations§
Source§impl SnapshotBuilder
impl SnapshotBuilder
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);
§Errors
Can fail if the tokio runtime cannot be created, Or if the deno runtime initialization fails (usually issues with extensions)
Sourcepub fn with_tokio_runtime(
options: RuntimeOptions,
tokio: Rc<Runtime>,
) -> Result<Self, Error>
pub fn with_tokio_runtime( options: RuntimeOptions, tokio: Rc<Runtime>, ) -> Result<Self, Error>
Creates a new instance of the runtime with the provided options and a pre-configured tokio runtime.
See crate::Runtime::new
for more information.
§Errors
Can fail if the deno runtime initialization fails (usually issues with extensions)
Sourcepub fn with_tokio_runtime_handle(
options: RuntimeOptions,
handle: Handle,
) -> Result<Self, Error>
pub fn with_tokio_runtime_handle( options: RuntimeOptions, handle: Handle, ) -> Result<Self, Error>
Creates a new instance of the runtime with the provided options and a borrowed tokio runtime handle.
See [Runtime::new
] for more information.
§Errors
Can fail if the deno runtime initialization fails (usually issues with extensions)
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 tokio_runtime(&self) -> TokioRuntime
pub fn tokio_runtime(&self) -> TokioRuntime
Access the underlying tokio runtime used for blocking operations
Sourcepub fn heap_exhausted_token(&self) -> CancellationToken
pub fn heap_exhausted_token(&self) -> CancellationToken
Returns the heap exhausted token for the runtime Used to detect when the runtime has run out of memory
Sourcepub fn into_tokio_runtime(self) -> TokioRuntime
pub fn into_tokio_runtime(self) -> TokioRuntime
Destroy the v8 runtime, releasing all resources Then the internal tokio runtime will be returned
Sourcepub fn set_current_dir(
&mut self,
path: impl AsRef<Path>,
) -> Result<&Path, Error>
pub fn set_current_dir( &mut self, path: impl AsRef<Path>, ) -> Result<&Path, Error>
Set the current working directory for the runtime This is used to resolve relative paths in the module loader
The runtime will begin with the current working directory of the process
§Errors
Can fail if the given path is not valid
Sourcepub fn current_dir(&self) -> &Path
pub fn current_dir(&self) -> &Path
Get the current working directory for the runtime This is used to resolve relative paths in the module loader
The runtime will begin with the current working directory of the process
Sourcepub fn advance_event_loop(
&mut self,
options: PollEventLoopOptions,
) -> Result<bool, Error>
pub fn advance_event_loop( &mut self, options: PollEventLoopOptions, ) -> Result<bool, Error>
Advance the JS event loop by a single tick
See crate::Runtime::await_event_loop
for fully running the event loop
Returns true if the event loop has pending work, or false if it has completed
§Arguments
options
- Options for the event loop polling, seedeno_core::PollEventLoopOptions
§Errors
Can fail if a runtime error occurs during the event loop’s execution
Sourcepub async fn await_event_loop(
&mut self,
options: PollEventLoopOptions,
timeout: Option<Duration>,
) -> Result<(), Error>
pub async fn await_event_loop( &mut self, options: PollEventLoopOptions, timeout: Option<Duration>, ) -> Result<(), Error>
Run the JS event loop to completion, or until a timeout is reached
Required when using the _immediate
variants of functions
§Arguments
options
- Options for the event loop polling, seedeno_core::PollEventLoopOptions
timeout
- Optional timeout for the event loop
§Errors
Can fail if a runtime error occurs during the event loop’s execution
Sourcepub fn block_on_event_loop(
&mut self,
options: PollEventLoopOptions,
timeout: Option<Duration>,
) -> Result<(), Error>
pub fn block_on_event_loop( &mut self, options: PollEventLoopOptions, timeout: Option<Duration>, ) -> Result<(), Error>
Run the JS event loop to completion, or until a timeout is reached
Required when using the _immediate
variants of functions
This is the blocking variant of crate::Runtime::await_event_loop
§Arguments
options
- Options for the event loop polling, seedeno_core::PollEventLoopOptions
timeout
- Optional timeout for the event loop
§Errors
Can fail if a runtime error occurs during the event loop’s execution
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
§Errors
Can fail if the inner state cannot be borrowed mutably
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 eval<T>(&mut self, expr: impl ToString) -> Result<T, Error>where
T: DeserializeOwned,
pub fn eval<T>(&mut self, expr: impl ToString) -> Result<T, Error>where
T: DeserializeOwned,
Evaluate a piece of non-ECMAScript-module JavaScript code
The expression is evaluated in the global context, so changes persist
Blocks on promise resolution, and runs the event loop to completion
Asynchronous code is supported, partially
- Top-level await is not supported
- The event loop will be run to completion after the expression is evaluated
For top-level await support, use one of:
call_function_async
call_stored_function_async
load_module_async
load_modules_async
Or any of the _immmediate
variants, paired with crate::js_value::Promise
§Arguments
expr
- A string representing the JavaScript expression to evaluate
§Returns
A Result
containing the deserialized result of the expression (T
)
or an error (Error
) if the expression cannot be evaluated or if the
result cannot be deserialized.
§Errors
Can fail if the expression cannot be evaluated, or if the result cannot be deserialized into the requested type
See crate::Runtime::eval
for an example
Sourcepub async fn eval_async<T>(&mut self, expr: impl ToString) -> Result<T, Error>where
T: DeserializeOwned,
pub async fn eval_async<T>(&mut self, expr: impl ToString) -> Result<T, Error>where
T: DeserializeOwned,
Evaluate a piece of non-ECMAScript-module JavaScript code
The expression is evaluated in the global context, so changes persist
Awaits promise resolution, and runs the event loop to completion
Asynchronous code is supported, partially
- Top-level await is not supported
- The event loop will be run to completion after the expression is evaluated
For top-level await support, use one of:
call_function_async
call_stored_function_async
load_module_async
load_modules_async
Or any of the _immmediate
variants, paired with crate::js_value::Promise
§Arguments
expr
- A string representing the JavaScript expression to evaluate
§Returns
A Result
containing the deserialized result of the expression (T
)
or an error (Error
) if the expression cannot be evaluated or if the
result cannot be deserialized.
§Errors
Can fail if the expression cannot be evaluated, or if the result cannot be deserialized into the requested type
§Example
For an example, see crate::Runtime::eval
Sourcepub async fn eval_immediate<T>(
&mut self,
expr: impl ToString,
) -> Result<T, Error>where
T: DeserializeOwned,
pub async fn eval_immediate<T>(
&mut self,
expr: impl ToString,
) -> Result<T, Error>where
T: DeserializeOwned,
Evaluate a piece of non-ECMAScript-module JavaScript code
The expression is evaluated in the global context, so changes persist
Does not await promise resolution, or run the event loop
Promises can be returned by specifying the return type as crate::js_value::Promise
The event loop should be run using crate::Runtime::await_event_loop
Note that this function needs to be async because calls to setTimeout
must be evaluated from within an async runtime.
Asynchronous code is supported, partially
- Top-level await is not supported
For top-level await support, use one of:
call_function_async
call_stored_function_async
load_module_async
load_modules_async
Or any of the _immmediate
variants, paired with crate::js_value::Promise
§Arguments
expr
- A string representing the JavaScript expression to evaluate
§Returns
A Result
containing the deserialized result of the expression (T
)
or an error (Error
) if the expression cannot be evaluated or if the
result cannot be deserialized.
§Errors
Can fail if the expression cannot be evaluated, or if the result cannot be deserialized into the requested type
§Example
For an example, see crate::Runtime::eval
Sourcepub async fn call_function_async<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
args: &impl Serialize,
) -> Result<T, Error>where
T: DeserializeOwned,
pub async fn call_function_async<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
args: &impl Serialize,
) -> Result<T, Error>where
T: DeserializeOwned,
Calls a javascript function within the Deno runtime by its name and deserializes its return value. Returns a future that resolves when:
- The event loop is resolved, and
- If the value is a promise, the promise is resolved
Note that synchronous functions are run synchronously. Returned promises will be run asynchronously, however.
See crate::Runtime::call_function
for an example
§Arguments
module_context
- Optional handle to a module to search - if None, or if the search fails, the global context is usedname
- A string representing the name of the javascript function to call.args
- The arguments to pass to the function
§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.
§Errors
Fails if the function cannot be found, if there are issues with calling the function, Or if the result cannot be deserialized into the requested type
Sourcepub fn call_function<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
args: &impl Serialize,
) -> Result<T, Error>where
T: DeserializeOwned,
pub fn call_function<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
args: &impl Serialize,
) -> Result<T, Error>where
T: DeserializeOwned,
Calls a javascript function within the Deno runtime by its name and deserializes its return value. Blocks until:
- The event loop is resolved, and
- If the value is a promise, the promise is resolved
§Arguments
module_context
- Optional handle to a module to search - if None, or if the search fails, the global context is usedname
- A string representing the name of the javascript function to call.args
- The arguments to pass to the function
§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.
§Errors
Fails if the function cannot be found, if there are issues with calling the function, Or if the result cannot be deserialized into the requested type
§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(Some(&module), "f", json_args!())?;
Sourcepub fn call_function_immediate<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
args: &impl Serialize,
) -> Result<T, Error>where
T: DeserializeOwned,
pub fn call_function_immediate<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
args: &impl Serialize,
) -> Result<T, Error>where
T: DeserializeOwned,
Calls a javascript function within the Deno runtime by its name and deserializes its return value.
Will not attempt to resolve promises, or run the event loop
Promises can be returned by specifying the return type as crate::js_value::Promise
The event loop should be run using crate::Runtime::await_event_loop
§Arguments
module_context
- Optional handle to a module to search - if None, or if the search fails, the global context is usedname
- A string representing the name of the javascript function to call.args
- The arguments to pass to the function
§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.
§Errors
Fails if the function cannot be found, if there are issues with calling the function, Or if the result cannot be deserialized into the requested type
§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_immediate(Some(&module), "f", json_args!())?;
Sourcepub fn get_value<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
) -> Result<T, Error>where
T: DeserializeOwned,
pub fn get_value<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
) -> Result<T, Error>where
T: DeserializeOwned,
Get a value from a runtime instance Blocks until:
- The event loop is resolved, and
- If the value is a promise, the promise is resolved
§Arguments
module_context
- Optional handle to a module to search - if None, or if the search fails, the global context is usedname
- 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,
Or if the result cannot be deserialized into the requested type
§Errors
Can fail if the value cannot be found, 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(Some(&module), "my_value")?;
Sourcepub async fn get_value_async<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
) -> Result<T, Error>where
T: DeserializeOwned,
pub async fn get_value_async<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
) -> Result<T, Error>where
T: DeserializeOwned,
Get a value from a runtime instance Returns a future that resolves when:
- The event loop is resolved, and
- If the value is a promise, the promise is resolved
See crate::Runtime::get_value
for an example
§Arguments
module_context
- Optional handle to a module to search - if None, or if the search fails, the global context is usedname
- 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,
Or if the result cannot be deserialized into the requested type
§Errors
Can fail if the value cannot be found, or if the result cannot be deserialized.
Sourcepub fn get_value_immediate<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
) -> Result<T, Error>where
T: DeserializeOwned,
pub fn get_value_immediate<T>(
&mut self,
module_context: Option<&ModuleHandle>,
name: &str,
) -> Result<T, Error>where
T: DeserializeOwned,
Get a value from a runtime instance
Will not attempt to resolve promises, or run the event loop
Promises can be returned by specifying the return type as crate::js_value::Promise
The event loop should be run using crate::Runtime::await_event_loop
§Arguments
module_context
- Optional handle to a module to search - if None, or if the search fails, the global context is usedname
- 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,
Or if the result cannot be deserialized into the requested type
§Errors
Can fail if the value cannot be found, 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_immediate(Some(&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
Blocks until the module has been executed AND the event loop has fully resolved
See crate::Runtime::load_module_async
for a non-blocking variant, or use with async
background tasks
§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 or executing the module
§Errors
Can fail if the module cannot be loaded, or execution fails
§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", "export default () => 'test'");
runtime.load_module(&module);
Sourcepub async fn load_module_async(
&mut self,
module: &Module,
) -> Result<ModuleHandle, Error>
pub async fn load_module_async( &mut self, module: &Module, ) -> Result<ModuleHandle, Error>
Executes the given module, and returns a handle allowing you to extract values And call functions
Returns a future that resolves to the handle for the loaded module
Makes no attempt to fully resolve the event loop - call crate::Runtime::await_event_loop
to resolve background tasks and async listeners
§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 or executing the module
§Errors
Can fail if the module cannot be loaded, or execution fails
See crate::Runtime::load_module
for an example
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.
Blocks until all modules have been executed AND the event loop has fully resolved
See crate::Runtime::load_module_async
for a non-blocking variant, or use with async
background tasks
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 or executing the module
§Errors
Can fail if the module cannot be loaded, or execution fails
§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", "export default () => 'test'");
runtime.load_modules(&module, vec![]);
Sourcepub async fn load_modules_async(
&mut self,
module: &Module,
side_modules: Vec<&Module>,
) -> Result<ModuleHandle, Error>
pub async fn load_modules_async( &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.
Returns a future that resolves to the handle for the loaded module
Makes no attempt to resolve the event loop - call crate::Runtime::await_event_loop
to
resolve background tasks and async listeners
This will load ‘module’ as the main module, and the others as side-modules. Only one main module can be loaded per runtime
See crate::Runtime::load_modules
for an example
§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 main module, or the last side-module
or an error (Error
) if there are issues with loading or executing the modules
§Errors
Can fail if the modules cannot be loaded, or execution fails
Sourcepub fn with_module(self, module: &Module) -> Result<Self, Error>
pub fn with_module(self, module: &Module) -> Result<Self, Error>
Executes the given module, on the runtime, making it available to be imported by other modules in this runtime, and those that will use the snapshot
This is a blocking operation, and will run the event loop to completion
For a non-blocking variant, see SnapshotBuilder::load_module_async
§Arguments
module
- AModule
object containing the module’s filename and contents.
§Errors
Can fail if the module cannot be loaded, or execution fails
Sourcepub fn with_expression(self, expr: &str) -> Result<Self, Error>
pub fn with_expression(self, expr: &str) -> Result<Self, Error>
Executes a piece of non-ECMAScript-module JavaScript code on the runtime This code can be used to set up the runtime state before creating the snapshot
This is a blocking operation, and will run the event loop to completion
§Arguments
expr
- A string representing the JavaScript expression to evaluate
§Errors
Can fail if the expression cannot be evaluated, or if the result cannot be deserialized
Sourcepub fn finish(self) -> Box<[u8]>
pub fn finish(self) -> Box<[u8]>
Consumes the runtime and returns a snapshot of the runtime state
This is only available when the snapshot_builder
feature is enabled
and will return a Box<[u8]>
representing the snapshot
To use the snapshot, provide it, as a static slice, in RuntimeOptions::startup_snapshot
Therefore, in order to use this snapshot, make sure you write it to a file and load it with
include_bytes!
WARNING: In order to use the snapshot, make sure the runtime using it is provided the same extensions and options as the original runtime.
Auto Trait Implementations§
impl Freeze for SnapshotBuilder
impl !Send for SnapshotBuilder
impl !Sync for SnapshotBuilder
impl !RefUnwindSafe for SnapshotBuilder
impl Unpin for SnapshotBuilder
impl !UnwindSafe for SnapshotBuilder
Blanket Implementations§
Source§impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedExplicit<'a, E> for Twhere
T: 'a,
Source§impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
impl<'a, T, E> AsTaggedImplicit<'a, E> for Twhere
T: 'a,
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> CheckedAs for T
impl<T> CheckedAs for T
Source§fn checked_as<Dst>(self) -> Option<Dst>where
T: CheckedCast<Dst>,
fn checked_as<Dst>(self) -> Option<Dst>where
T: CheckedCast<Dst>,
Source§impl<Src, Dst> CheckedCastFrom<Src> for Dstwhere
Src: CheckedCast<Dst>,
impl<Src, Dst> CheckedCastFrom<Src> for Dstwhere
Src: CheckedCast<Dst>,
Source§fn checked_cast_from(src: Src) -> Option<Dst>
fn checked_cast_from(src: Src) -> Option<Dst>
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> FutureExt for T
impl<T> FutureExt for T
Source§fn with_context(self, otel_cx: Context) -> WithContext<Self>
fn with_context(self, otel_cx: Context) -> WithContext<Self>
Source§fn with_current_context(self) -> WithContext<Self>
fn with_current_context(self) -> WithContext<Self>
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> IntoRequest<T> for T
impl<T> IntoRequest<T> for T
Source§fn into_request(self) -> Request<T>
fn into_request(self) -> Request<T>
T
in a tonic::Request
Source§impl<T> OverflowingAs for T
impl<T> OverflowingAs for T
Source§fn overflowing_as<Dst>(self) -> (Dst, bool)where
T: OverflowingCast<Dst>,
fn overflowing_as<Dst>(self) -> (Dst, bool)where
T: OverflowingCast<Dst>,
Source§impl<Src, Dst> OverflowingCastFrom<Src> for Dstwhere
Src: OverflowingCast<Dst>,
impl<Src, Dst> OverflowingCastFrom<Src> for Dstwhere
Src: OverflowingCast<Dst>,
Source§fn overflowing_cast_from(src: Src) -> (Dst, bool)
fn overflowing_cast_from(src: Src) -> (Dst, bool)
Source§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> Pointable for T
impl<T> Pointable for T
Source§impl<T> SaturatingAs for T
impl<T> SaturatingAs for T
Source§fn saturating_as<Dst>(self) -> Dstwhere
T: SaturatingCast<Dst>,
fn saturating_as<Dst>(self) -> Dstwhere
T: SaturatingCast<Dst>,
Source§impl<Src, Dst> SaturatingCastFrom<Src> for Dstwhere
Src: SaturatingCast<Dst>,
impl<Src, Dst> SaturatingCastFrom<Src> for Dstwhere
Src: SaturatingCast<Dst>,
Source§fn saturating_cast_from(src: Src) -> Dst
fn saturating_cast_from(src: Src) -> Dst
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.