Struct sp_state_machine::TestExternalities

pub struct TestExternalities<H: Hasher, N: ChangesTrieBlockNumber = u64> where
    H::Out: Codec + Ord,  {
    pub backend: InMemoryBackend<H>,
    pub extensions: Extensions,
    // some fields omitted
}

Simple HashMap-based Externalities impl.

Fields

backend: InMemoryBackend<H>

Storage backend.

extensions: Extensions

Extensions.

Implementations

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

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

Get externalities implementation.

pub fn new(storage: Storage) -> Self

Create a new instance of TestExternalities with storage.

pub fn new_empty() -> Self

New empty test externalities.

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

Create a new instance of TestExternalities with code and storage.

pub fn overlayed_changes(&self) -> &OverlayedChanges

Returns the overlayed changes.

pub fn persist_offchain_overlay(&mut self)

Move offchain changes from overlay to the persistent store.

pub fn offchain_db(&self) -> TestPersistentOffchainDB

A shared reference type around the offchain worker storage.

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

Insert key/value into backend

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

Registers the given extension for this instance.

pub fn changes_trie_storage(&mut self) -> &mut ChangesTrieInMemoryStorage<H, N>

Get mutable reference to changes trie storage.

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.

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.

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 occured. Otherwise, returns Err.

Trait Implementations

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

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

Formats the value using the given formatter.

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

fn default() -> Self

Returns the “default value” for a type.

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

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.

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

Register extension extension with specified type_id.

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

Deregister extension with speicifed ‘type_id’ and drop it.

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

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

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

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

Register extension ext.

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

Deregister and drop extension of T type.

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

fn from(storage: Storage) -> Self

Performs the conversion.

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

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

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

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

This method tests for !=.