pub struct TestExternalities<H>
where H: Hasher + 'static, H::Out: Codec + Ord,
{ pub backend: InMemoryBackend<H>, pub extensions: Extensions, pub state_version: StateVersion, /* private fields */ }
Expand description

Simple HashMap-based Externalities impl.

Fields§

§backend: InMemoryBackend<H>

Storage backend.

§extensions: Extensions

Extensions.

§state_version: StateVersion

State version to use during tests.

Implementations§

source§

impl<H> TestExternalities<H>
where H: Hasher + 'static, H::Out: Ord + 'static + Codec,

source

pub fn ext(&mut self) -> Ext<'_, H, InMemoryBackend<H>>

Get externalities implementation.

source

pub fn new(storage: Storage) -> Self

Create a new instance of TestExternalities with storage.

source

pub fn new_with_state_version( storage: Storage, state_version: StateVersion ) -> Self

Create a new instance of TestExternalities with storage for a given state version.

source

pub fn new_empty() -> Self

New empty test externalities.

source

pub fn new_with_code(code: &[u8], storage: Storage) -> Self

Create a new instance of TestExternalities with code and storage.

source

pub fn new_with_code_and_state( code: &[u8], storage: Storage, state_version: StateVersion ) -> Self

Create a new instance of TestExternalities with code and storage for a given state version.

source

pub fn overlayed_changes(&self) -> &OverlayedChanges<H>

Returns the overlayed changes.

source

pub fn persist_offchain_overlay(&mut self)

Move offchain changes from overlay to the persistent store.

source

pub fn offchain_db(&self) -> TestPersistentOffchainDB

A shared reference type around the offchain worker storage.

source

pub fn batch_insert<I>(&mut self, kvs: I)
where I: IntoIterator<Item = (StorageKey, StorageValue)>,

Batch insert key/values into backend

source

pub fn insert(&mut self, k: StorageKey, v: StorageValue)

Insert key/value into backend

source

pub fn insert_child(&mut self, c: ChildInfo, k: StorageKey, v: StorageValue)

Insert key/value into backend.

This only supports inserting keys in child tries.

source

pub fn register_extension<E: Any + Extension>(&mut self, ext: E)

Registers the given extension for this instance.

source

pub fn from_raw_snapshot( raw_storage: Vec<(Vec<u8>, (Vec<u8>, i32))>, storage_root: H::Out, state_version: StateVersion ) -> Self

Sets raw storage key/values and a root.

This can be used as a fast way to restore the storage state from a backup because the trie does not need to be computed.

source

pub fn into_raw_snapshot(self) -> (Vec<(Vec<u8>, (Vec<u8>, i32))>, H::Out)

Drains the underlying raw storage key/values and returns the root hash.

Useful for backing up the storage in a format that can be quickly re-loaded.

source

pub fn as_backend(&self) -> InMemoryBackend<H>

Return a new backend with all pending changes.

In contrast to commit_all this will not panic if there are open transactions.

source

pub fn commit_all(&mut self) -> Result<(), String>

Commit all pending changes to the underlying backend.

§Panic

This will panic if there are still open transactions.

source

pub fn execute_with<R>(&mut self, execute: impl FnOnce() -> R) -> R

Execute the given closure while self is set as externalities.

Returns the result of the given closure.

source

pub fn execute_and_prove<R>( &mut self, execute: impl FnOnce() -> R ) -> (R, StorageProof)

Execute the given closure while self, with proving_backend as backend, is set as externalities.

This implementation will wipe the proof recorded in between calls. Consecutive calls will get their own proof from scratch.

source

pub fn execute_with_safe<R>( &mut self, f: impl FnOnce() -> R + UnwindSafe ) -> Result<R, String>

Execute the given closure while self is set as externalities.

Returns the result of the given closure, if no panics occurred. Otherwise, returns Err.

Trait Implementations§

source§

impl<H: Hasher> Debug for TestExternalities<H>
where H::Out: Ord + Codec,

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl<H: Hasher> Default for TestExternalities<H>
where H::Out: Ord + 'static + Codec,

source§

fn default() -> Self

Returns the “default value” for a type. Read more
source§

impl<H> ExtensionStore for TestExternalities<H>
where H: Hasher, H::Out: Ord + Codec,

source§

fn extension_by_type_id(&mut self, type_id: TypeId) -> Option<&mut dyn Any>

Tries to find a registered extension by the given type_id and returns it as a &mut dyn Any. Read more
source§

fn register_extension_with_type_id( &mut self, type_id: TypeId, extension: Box<dyn Extension> ) -> Result<(), Error>

Register extension extension with specified type_id. Read more
source§

fn deregister_extension_by_type_id( &mut self, type_id: TypeId ) -> Result<(), Error>

Deregister extension with specified ‘type_id’ and drop it. Read more
source§

impl<H> ExternalitiesExt for TestExternalities<H>
where H: Hasher, H::Out: Ord + Codec,

source§

fn extension<T: Any + Extension>(&mut self) -> Option<&mut T>

Tries to find a registered extension and returns a mutable reference.
source§

fn register_extension<T: Extension>(&mut self, ext: T) -> Result<(), Error>

Register extension ext. Read more
source§

fn deregister_extension<T: Extension>(&mut self) -> Result<(), Error>

Deregister and drop extension of T type. Read more
source§

impl<H: Hasher> From<(Storage, StateVersion)> for TestExternalities<H>
where H::Out: Ord + 'static + Codec,

source§

fn from((storage, state_version): (Storage, StateVersion)) -> Self

Converts to this type from the input type.
source§

impl<H: Hasher> From<Storage> for TestExternalities<H>
where H::Out: Ord + 'static + Codec,

source§

fn from(storage: Storage) -> Self

Converts to this type from the input type.
source§

impl<H: Hasher> PartialEq for TestExternalities<H>
where H::Out: Ord + 'static + Codec,

source§

fn eq(&self, other: &TestExternalities<H>) -> bool

This doesn’t test if they are in the same state, only if they contains the same data at this state

1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

Auto Trait Implementations§

§

impl<H> !Freeze for TestExternalities<H>

§

impl<H> !RefUnwindSafe for TestExternalities<H>

§

impl<H> Send for TestExternalities<H>

§

impl<H> !Sync for TestExternalities<H>

§

impl<H> Unpin for TestExternalities<H>
where H: Unpin, <H as Hasher>::Out: Unpin,

§

impl<H> !UnwindSafe for TestExternalities<H>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, Outer> IsWrappedBy<Outer> for T
where Outer: AsRef<T> + AsMut<T> + From<T>, T: From<Outer>,

source§

fn from_ref(outer: &Outer) -> &T

Get a reference to the inner from the outer.

source§

fn from_mut(outer: &mut Outer) -> &mut T

Get a mutable reference to the inner from the outer.

source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<S, T> UncheckedInto<T> for S
where T: UncheckedFrom<S>,

source§

fn unchecked_into(self) -> T

The counterpart to unchecked_from.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<T> JsonSchemaMaybe for T

source§

impl<T> MaybeDebug for T
where T: Debug,