Struct MultiContractRunner

pub struct MultiContractRunner {
    pub contracts: DeployableContracts,
    pub known_contracts: ContractsByArtifact,
    pub revert_decoder: RevertDecoder,
    pub libs_to_deploy: Vec<Bytes>,
    pub libraries: Libraries,
    pub fork: Option<CreateFork>,
    pub tcfg: TestRunnerConfig,
}

A multi contract runner receives a set of contracts deployed in an EVM instance and proceeds to run all test functions in these contracts.

Fields

contracts: DeployableContracts

Mapping of contract name to JsonAbi, creation bytecode and library bytecode which needs to be deployed & linked against

known_contracts: ContractsByArtifact

Known contracts linked with computed library addresses.

revert_decoder: RevertDecoder

Revert decoder. Contains all known errors and their selectors.

libs_to_deploy: Vec<Bytes>

Libraries to deploy.

libraries: Libraries

Library addresses used to link contracts.

fork: Option<CreateFork>

The fork to use at launch

tcfg: TestRunnerConfig

The base configuration for the test runner.

Implementations

impl MultiContractRunner

pub fn matching_contracts<'a: 'b, 'b>( &'a self, filter: &'b dyn TestFilter, ) -> impl Iterator<Item = (&'a ArtifactId, &'a TestContract)> + 'b

Returns an iterator over all contracts that match the filter.

pub fn matching_test_functions<'a: 'b, 'b>( &'a self, filter: &'b dyn TestFilter, ) -> impl Iterator<Item = &'a Function> + 'b

Returns an iterator over all test functions that match the filter.

pub fn all_test_functions<'a: 'b, 'b>( &'a self, filter: &'b dyn TestFilter, ) -> impl Iterator<Item = &'a Function> + 'b

Returns an iterator over all test functions in contracts that match the filter.

pub fn list( &self, filter: &dyn TestFilter, ) -> BTreeMap<String, BTreeMap<String, Vec<String>>>

Returns all matching tests grouped by contract grouped by file (file -> (contract -> tests))

pub fn test_collect( &mut self, filter: &dyn TestFilter, ) -> BTreeMap<String, SuiteResult>

Executes all tests that match the given filter.

The same as test, but returns the results instead of streaming them.

Note that this method returns only when all tests have been executed.

pub fn test_iter( &mut self, filter: &dyn TestFilter, ) -> impl Iterator<Item = (String, SuiteResult)>

Executes all tests that match the given filter.

The same as test, but returns the results instead of streaming them.

Note that this method returns only when all tests have been executed.

pub fn test( &mut self, filter: &dyn TestFilter, tx: Sender<(String, SuiteResult)>, show_progress: bool, )

Executes all tests that match the given filter.

This will create the runtime based on the configured evm ops and create the Backend before executing all contracts and their tests in parallel.

Each Executor gets its own instance of the Backend.

fn run_test_suite( &self, artifact_id: &ArtifactId, contract: &TestContract, db: &Backend, filter: &dyn TestFilter, tokio_handle: &Handle, progress: Option<&TestsProgress>, ) -> SuiteResult

Methods from Deref<Target = TestRunnerConfig>

pub fn reconfigure_with(&mut self, config: Arc<Config>)

Reconfigures all fields using the given config.

pub fn configure_executor(&self, executor: &mut Executor)

Configures the given executor with this configuration.

pub fn executor( &self, known_contracts: ContractsByArtifact, artifact_id: &ArtifactId, db: Backend, ) -> Executor

Creates a new executor with this configuration.

fn trace_mode(&self) -> TraceMode

Trait Implementations

impl Deref for MultiContractRunner

type Target = TestRunnerConfig

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for MultiContractRunner

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 2512 bytes