Re-exportsยง
use super::fuzz::FuzzRunArgs;๐use super::watch::WatchArgs;๐use crate::MultiContractRunner;๐use crate::MultiContractRunnerBuilder;๐use crate::brutalizer;๐use crate::decode::decode_console_logs;๐use crate::gas_report::GasReport;๐use crate::multi_runner::FuzzFailureReplayConfig;๐use crate::multi_runner::FuzzMinimizeConfig;๐use crate::multi_runner::FuzzMinimizeEdgeIndices;๐use crate::multi_runner::FuzzMinimizeMode;๐use crate::multi_runner::FuzzMinimizeObservation;๐use crate::multi_runner::MultiNetworkConfig;๐use crate::multi_runner::ShowmapConfig;๐use crate::multi_runner::SymbolicArtifactReplayConfig;๐use crate::multi_runner::TestFunctionMatcher;๐use crate::multi_runner::is_generated_symbolic_regression_contract;๐use crate::mutation::MutationRunConfig;๐use crate::mutation::run_mutation_testing;๐use crate::result::SYMBOLIC_COUNTEREXAMPLE_ARTIFACT_SCHEMA;๐use crate::result::SuiteResult;๐use crate::result::SymbolicCounterexampleArtifact;๐use crate::result::SymbolicReplayStatus;๐use crate::result::TestKind;๐use crate::result::TestKindReport;๐use crate::result::TestOutcome;๐use crate::result::TestResult;๐use crate::result::TestStatus;๐use crate::runner::effective_test_function_kind;๐use crate::runner::inline_config_for;๐use crate::symbolic_regression::SymbolicRegression;๐use crate::symbolic_regression::SymbolicRegressionConfig;๐use crate::symbolic_regression::attach_symbolic_regressions_to_suites;๐use crate::symbolic_regression::collect_symbolic_artifacts_from_suites;๐use crate::symbolic_regression::emit_symbolic_regressions;๐use crate::traces::CallTraceDecoder;๐use crate::traces::CallTraceDecoderBuilder;๐use crate::traces::InternalTraceMode;๐use crate::traces::TraceKind;๐use crate::traces::debug::ContractSources;๐use crate::traces::debug::DebugTraceIdentifier;๐use crate::traces::decode_trace_arena;๐use crate::traces::folded_stack_trace;๐use crate::traces::identifier::SignaturesIdentifier;๐use crate::traces::render_trace_arena_inner;๐use crate::traces::speedscope;๐use crate::workspace;๐use alloy_json_abi::JsonAbi;๐use alloy_network::TransactionBuilder;๐use alloy_primitives::U256;๐use chrono::Utc;๐use clap::Parser;๐use clap::ValueEnum;๐use clap::ValueHint;๐use dialoguer::Select;๐use dialoguer::console::Term;๐use evm2::interpreter::opcode::OpCode;๐use eyre::Context;๐use eyre::OptionExt;๐use eyre::Result;๐use eyre::bail;๐use foundry_cli::opts::BuildOpts;๐use foundry_cli::opts::EvmArgs;๐use foundry_cli::opts::GlobalArgs;๐use foundry_cli::opts::TracingArgs;๐use foundry_cli::utils;๐use foundry_cli::utils::FoundryPathExt;๐use foundry_cli::utils::LoadConfig;๐use foundry_common::ContractsByArtifact;๐use foundry_common::EmptyTestFilter;๐use foundry_common::TestFilter;๐use foundry_common::TestFunctionExt;๐use foundry_common::TestFunctionKind;๐use foundry_common::compile::ProjectCompiler;๐use foundry_common::compile::compile_abi_project_cached;๐use foundry_common::external_compiler::is_external_artifact;๐use foundry_common::fs;๐use foundry_common::fs::canonicalize_path;๐use foundry_common::sh_status;๐use foundry_common::sh_warn;๐use foundry_common::shell;๐use foundry_compilers::Artifact;๐use foundry_compilers::ArtifactId;๐use foundry_compilers::Graph;๐use foundry_compilers::ProjectCompileOutput;๐use foundry_compilers::artifacts::BytecodeObject;๐use foundry_compilers::artifacts::ConfigurableContractArtifact;๐use foundry_compilers::artifacts::Libraries;๐use foundry_compilers::artifacts::Source;๐use foundry_compilers::artifacts::ast::NodeType;๐use foundry_compilers::artifacts::output_selection::ContractOutputSelection;๐use foundry_compilers::compilers::Language;๐use foundry_compilers::compilers::multi::MultiCompiler;๐use foundry_compilers::compilers::multi::MultiCompilerLanguage;๐use foundry_compilers::compilers::multi::MultiCompilerParser;๐use foundry_compilers::utils::source_files_iter;๐use foundry_config::Config;๐use foundry_config::InlineConfig;๐use foundry_config::InvariantDepthMode;๐use foundry_config::InvariantWorkers;๐use foundry_config::figment;๐use foundry_config::figment::Metadata;๐use foundry_config::figment::Profile;๐use foundry_config::figment::Provider;๐use foundry_config::figment::value::Dict;๐use foundry_config::figment::value::Map;๐use foundry_config::figment::value::Value;๐use foundry_config::filter::GlobMatcher;๐use foundry_config::fs_permissions::FsAccessPermission;๐use foundry_debugger::DebuggerBuilder;๐use foundry_debugger::ensure_dump_dir;๐use foundry_evm::backend::Backend;๐use foundry_evm::core::evm::EthEvmNetwork;๐use foundry_evm::core::evm::EvmFactoryFor;๐use foundry_evm::core::evm::FoundryEvmNetwork;๐use foundry_evm::core::evm::TempoEvmNetwork;๐use foundry_evm::executors::ExecutorBuilder;๐use foundry_evm::executors::ShowmapDomain;๐use foundry_evm::fuzz::BaseCounterExample;๐use foundry_evm::fuzz::BasicTxDetails;๐use foundry_evm::fuzz::CounterExample;๐use foundry_evm::opts::EvmOpts;๐use foundry_evm::opts::ExecutionSpecContext;๐use foundry_evm::opts::resolve_execution_spec;๐use foundry_evm::traces::backtrace::BacktraceBuilder;๐use foundry_evm::traces::identifier::TraceIdentifiers;๐use foundry_evm::traces::prune_trace_depth;๐use foundry_evm::traces::trace_arena_at_depth;๐use foundry_evm_networks::NetworkVariant;๐use foundry_tui::tui_mode;๐use quick_junit::NonSuccessKind;๐use quick_junit::Report;๐use quick_junit::TestCase;๐use quick_junit::TestCaseStatus;๐use quick_junit::TestSuite;๐use rand::Rng;๐use regex::Regex;๐use solar::ast::ContractKind as SolarContractKind;๐use solar::ast::ItemKind;๐use std::collections::BTreeMap;๐use std::collections::BTreeSet;๐use std::collections::HashSet;๐use std::fmt::Write;๐use std::path::Path;๐use std::path::PathBuf;๐use std::sync::Arc;๐use std::sync::Mutex;๐use std::sync::mpsc::channel;๐use std::time::Duration;๐use std::time::Instant;๐use tempfile::TempDir;๐use yansi::Paint;๐use foundry_evm::core::evm::BaseEvmNetwork;๐baseuse foundry_evm::core::evm::MonadEvmNetwork;๐monaduse foundry_evm::core::evm::OpEvmNetwork;๐optimismuse filter::RerunFailures;๐use summary::TestSummaryReport;๐use summary::format_invariant_metrics_table;๐
Modulesยง
- evm_
profile_ ๐server - Local HTTP server for serving EVM profiles to speedscope.app.
- filter ๐
- summary ๐
Macrosยง
- dict ๐
- Builds a figment dictionary from
key => Option<value>pairs, skipping unset values. - dispatch_
network ๐ - Evaluates
$bodywith$fenbound to the concrete network type selected by$evm_opts.
Structsยง
- Campaign
Args - Shared campaign arguments for
forge fuzz run. - Compiled
Test ๐Project - Filter
Args - The filter to use during testing.
- Fuzz
Minimize ๐Replay Pass - Fuzz
Minimize ๐Replay Session - Compiled runners for every network pass of a
forge fuzzminimization command. - Junit
Output ๐ - Helper for assembling JUnit output strings.
- Last
RunFailures ๐ - Network
Pass ๐ - Config and EVM options for one network pass of a multi-network run.
- Project
Paths Aware Filter - A filter that combines all command line arguments and the paths of the current projects
- Rerun
Failure - A failed test persisted for
forge test --rerun. - Test
Args - CLI arguments for
forge test. - Test
Execution ๐Options
Enumsยง
- EvmProfile
Format - Output format for EVM execution profiles.
- Showmap
Domain Arg - CLI mirror of
foundry_evm::executors::ShowmapDomain. - Trace
Output ๐Kind
Constantsยง
Functionsยง
- add_
junit_ ๐test_ case - Adds a single JUnit test case to the suite.
- add_
junit_ ๐test_ cases - Adds JUnit test cases for a test result.
- apply_
mutation_ ๐compiler_ overrides - collect_
matching_ ๐debug_ tests - count_
fuzz_ ๐minimize_ targets - enabled_
flags ๐ - Returns the names of the enabled flags.
- ensure_
mutation_ ๐workspace_ safe - Bails if mutation testing could corrupt the real dependency trees.
- format_
matching_ ๐debug_ tests - fuzz_
minimize_ ๐pass - is_
runnable_ ๐test_ contract - Returns whether an ABI-discovered contract could be included in the test runner.
- junit_
xml_ ๐report - Generate test report in JUnit XML report format.
- last_
run_ ๐failures - Load persisted filter (with last test run failures) from file.
- list_
from_ ๐output - Lists all matching tests without building a runner.
- matching_
fuzz_ ๐replay_ targets - matching_
test_ ๐contracts - Returns the deployable contracts in
outputthat matchfilter, with project-relative ids. - merge_
outcomes ๐ - Merges
otherintobaseby extending suite results. - merge_
suite_ ๐results - network_
passes ๐ - Splits a run into the default network pass and one override pass per annotated network.
- parse_
opcode ๐ - path_
string ๐ - Renders an optional path for the figment provider.
- persist_
run_ ๐failures - Replace the last run failures, clearing the record when the run succeeds.
- prepare_
results_ ๐for_ json - rerun_
filter_ ๐matches - Returns the rerun keys of a failed test: its failed invariant predicates, or the test name when no predicate failed.
- spawn_
backend ๐ - Spawns the backend of a test run, starting on the configured fork, if any.
- validate_
showmap_ ๐config
Type Aliasesยง
- Fuzz
Minimize ๐Replay