1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216
use super::{call_macro_with_all_host_functions, Env, EnvBase, Symbol};
use super::{
AddressObject, Bool, BytesObject, I128Object, I256Object, I64Object, MapObject, Object, RawVal,
Status, StringObject, SymbolObject, U128Object, U256Object, U32Val, U64Object, U64Val,
VecObject, Void,
};
use core::{any, convert::Infallible};
/// A dummy implementation of the [Env] trait that fails with `unimplemented!()` in
/// all functions. Useful for certain testing scenarios.
#[derive(Clone, Default)]
pub struct UnimplementedEnv;
impl EnvBase for UnimplementedEnv {
type Error = Infallible;
#[cfg(feature = "testutils")]
fn escalate_error_to_panic(&self, _e: Self::Error) -> ! {
unimplemented!()
}
fn as_mut_any(&mut self) -> &mut dyn any::Any {
self
}
fn check_same_env(&self, _other: &Self) {}
fn deep_clone(&self) -> Self {
Self
}
fn bytes_copy_from_slice(
&self,
_b: BytesObject,
_b_pos: U32Val,
_slice: &[u8],
) -> Result<BytesObject, Self::Error> {
unimplemented!()
}
fn bytes_copy_to_slice(
&self,
_b: BytesObject,
_b_pos: U32Val,
_slice: &mut [u8],
) -> Result<(), Self::Error> {
unimplemented!()
}
fn string_copy_to_slice(
&self,
_b: StringObject,
_b_pos: U32Val,
_slice: &mut [u8],
) -> Result<(), Self::Error> {
unimplemented!()
}
fn symbol_copy_to_slice(
&self,
_b: SymbolObject,
_b_pos: U32Val,
_slice: &mut [u8],
) -> Result<(), Self::Error> {
unimplemented!()
}
fn bytes_new_from_slice(&self, _slice: &[u8]) -> Result<BytesObject, Self::Error> {
unimplemented!()
}
fn string_new_from_slice(&self, _s: &str) -> Result<crate::StringObject, Self::Error> {
unimplemented!()
}
fn symbol_new_from_slice(&self, _s: &str) -> Result<crate::SymbolObject, Self::Error> {
unimplemented!()
}
fn map_new_from_slices(
&self,
_keys: &[&str],
_vals: &[RawVal],
) -> Result<MapObject, Self::Error> {
unimplemented!()
}
fn map_unpack_to_slice(
&self,
_map: MapObject,
_keys: &[&str],
_vals: &mut [RawVal],
) -> Result<Void, Self::Error> {
unimplemented!()
}
fn vec_new_from_slice(&self, _vals: &[RawVal]) -> Result<VecObject, Self::Error> {
unimplemented!()
}
fn vec_unpack_to_slice(
&self,
_vec: VecObject,
_vals: &mut [RawVal],
) -> Result<Void, Self::Error> {
unimplemented!()
}
fn symbol_index_in_strs(&self, _key: Symbol, _strs: &[&str]) -> Result<U32Val, Self::Error> {
unimplemented!()
}
fn log_static_fmt_val(&self, _fmt: &'static str, _v: RawVal) -> Result<(), Self::Error> {
unimplemented!()
}
fn log_static_fmt_static_str(
&self,
_fmt: &'static str,
_s: &'static str,
) -> Result<(), Self::Error> {
unimplemented!()
}
fn log_static_fmt_val_static_str(
&self,
_fmt: &'static str,
_v: RawVal,
_s: &'static str,
) -> Result<(), Self::Error> {
unimplemented!()
}
fn log_static_fmt_general(
&self,
_fmt: &'static str,
_vals: &[RawVal],
_strs: &[&'static str],
) -> Result<(), Self::Error> {
unimplemented!()
}
}
// This is a helper macro used only by generate_env_unimplemented below. It
// consumes a token-tree of the form:
//
// {fn $fn_id:ident $args:tt -> $ret:ty}
//
// and produces the the corresponding method declaration to be used in the Env
// trait.
macro_rules! host_function_helper {
{fn $fn_id:ident($($arg:ident:$type:ty),*) -> $ret:ty}
=>
{
fn $fn_id(&self, $(_:$type),*) -> Result<$ret, Self::Error> {
unimplemented!()
}
};
}
// This is a callback macro that pattern-matches the token-tree passed by the
// x-macro (call_macro_with_all_host_functions) and produces a suite of method
// declarations, which it places in the body of the declaration of the
// UnimplementedEnv trait.
macro_rules! generate_env_unimplemented {
{
$(
// This outer pattern matches a single 'mod' block of the token-tree
// passed from the x-macro to this macro. It is embedded in a `$()*`
// pattern-repetition matcher so that it will match all provided
// 'mod' blocks provided.
$(#[$mod_attr:meta])*
mod $mod_id:ident $mod_str:literal
{
$(
// This inner pattern matches a single function description
// inside a 'mod' block in the token-tree passed from the
// x-macro to this macro. It is embedded in a `$()*`
// pattern-repetition matcher so that it will match all such
// descriptions.
$(#[$fn_attr:meta])*
{ $fn_str:literal, fn $fn_id:ident $args:tt -> $ret:ty }
)*
}
)*
}
=> // The part of the macro above this line is a matcher; below is its expansion.
{
// This macro expands to a single item: the UnimplementedEnv struct used
// to define a type that implements the Env trait with all functions
// unimplemented, intended for use in tests that need an Env that has no
// implementation.
impl Env for UnimplementedEnv
{
$(
$(
// This invokes the host_function_helper! macro above
// passing only the relevant parts of the declaration
// matched by the inner pattern above. It is embedded in two
// nested `$()*` pattern-repetition expanders that
// correspond to the pattern-repetition matchers in the
// match section, but we ignore the structure of the 'mod'
// block repetition-level from the outer pattern in the
// expansion, flattening all functions from all 'mod' blocks
// into the Env trait.
host_function_helper!{fn $fn_id $args -> $ret}
)*
)*
}
};
}
// Invoke the x-macro passing generate_env_unimplemented as its callback macro.
call_macro_with_all_host_functions! { generate_env_unimplemented }