Struct foundry_compilers::project_util::TempProject

pub struct TempProject<C: Compiler = MultiCompiler, T: ArtifactOutput = ConfigurableArtifacts> { /* private fields */ }

Available on crate feature project-util only.

A Project wrapper that lives in a new temporary directory

Once TempProject is dropped, the temp dir is automatically removed, see TempDir::drop()

Implementations

impl<T: ArtifactOutput + Default> TempProject<MultiCompiler, T>

pub fn with_artifacts( paths: ProjectPathsConfigBuilder, artifacts: T, ) -> Result<Self>

Available on crate feature svm-solc only.

Creates a new temp project using the provided paths and artifacts handler. sets the project root to a temp dir

pub fn with_solc_settings(self, settings: impl Into<Settings>) -> Self

Overwrites the settings to pass to solc

pub fn set_solc(&mut self, solc: impl AsRef<str>) -> &mut Self

Available on crate feature svm-solc only.

Explicitly sets the solc version for the project

impl<T: ArtifactOutput + Default> TempProject<MultiCompiler, T>

pub fn with_style(prefix: &str, style: PathStyle) -> Result<Self>

Available on crate feature svm-solc only.

Creates a new temp project for the given PathStyle

impl TempProject<MultiCompiler, HardhatArtifacts>

pub fn hardhat() -> Result<Self>

Available on crate feature svm-solc only.

Creates an empty new hardhat style workspace in a new temporary dir

impl<C: Compiler + Default, T: ArtifactOutput + Default> TempProject<C, T>

pub fn create_new( root: TempDir, inner: Project<C, T>, ) -> Result<Self, SolcIoError>

Makes sure all resources are created

pub fn new(paths: ProjectPathsConfigBuilder) -> Result<Self>

Available on crate feature svm-solc only.

Creates a new temp project using the provided paths and setting the project root to a temp dir

pub fn prefixed(prefix: &str, paths: ProjectPathsConfigBuilder) -> Result<Self>

Available on crate feature svm-solc only.

Creates a new temp project inside a tempdir with a prefixed directory

pub fn prefixed_with_artifacts( prefix: &str, paths: ProjectPathsConfigBuilder, artifacts: T, ) -> Result<Self>

Available on crate feature svm-solc only.

Creates a new temp project inside a tempdir with a prefixed directory and the given artifacts handler

pub fn dapptools() -> Result<Self>

Creates an empty new dapptools style workspace in a new temporary dir

pub fn dapptools_init() -> Result<Self>

Creates an initialized dapptools style workspace in a new temporary dir

pub fn project(&self) -> &Project<C, T>

pub fn project_mut(&mut self) -> &mut Project<C, T>

pub fn paths(&self) -> &ProjectPathsConfig<C::Language>

The configured paths of the project

pub fn paths_mut(&mut self) -> &mut ProjectPathsConfig<C::Language>

The configured paths of the project

pub fn copy_source(&self, source: impl AsRef<Path>) -> Result<()>

Copies a single file into the projects source

pub fn copy_sources<I, S>(&self, sources: I) -> Result<()>

where I: IntoIterator<Item = S>, S: AsRef<Path>,

pub fn copy_lib(&self, lib: impl AsRef<Path>) -> Result<()>

Copies a single file into the project’s main library directory

pub fn copy_libs<I, S>(&self, libs: I) -> Result<()>

where I: IntoIterator<Item = S>, S: AsRef<Path>,

Copy a series of files into the main library dir

pub fn add_lib( &self, name: impl AsRef<str>, content: impl AsRef<str>, ) -> Result<PathBuf>

Adds a new library file

pub fn add_basic_lib( &self, name: impl AsRef<str>, version: impl AsRef<str>, ) -> Result<PathBuf>

Adds a basic lib contract contract <name> {} as a new file

pub fn add_test( &self, name: impl AsRef<str>, content: impl AsRef<str>, ) -> Result<PathBuf>

Adds a new test file inside the project’s test dir

pub fn add_script( &self, name: impl AsRef<str>, content: impl AsRef<str>, ) -> Result<PathBuf>

Adds a new script file inside the project’s script dir

pub fn add_source( &self, name: impl AsRef<str>, content: impl AsRef<str>, ) -> Result<PathBuf>

Adds a new source file inside the project’s source dir

pub fn add_basic_source( &self, name: impl AsRef<str>, version: impl AsRef<str>, ) -> Result<PathBuf>

Adds a basic source contract contract <name> {} as a new file

pub fn add_contract( &self, name: impl AsRef<str>, content: impl AsRef<str>, ) -> Result<PathBuf>

Adds a solidity contract in the project’s root dir. This will also create all intermediary dirs.

pub fn artifacts_path(&self) -> &PathBuf

Returns the path to the artifacts directory

pub fn sources_path(&self) -> &PathBuf

Returns the path to the sources directory

pub fn cache_path(&self) -> &PathBuf

Returns the path to the cache file

pub fn root(&self) -> &Path

The root path of the temporary workspace

pub fn compile(&self) -> Result<ProjectCompileOutput<C, T>>

pub fn artifacts_snapshot( &self, ) -> Result<ArtifactsSnapshot<T::Artifact, C::Settings>>

Returns a snapshot of all cached artifacts

pub fn mock( &self, gen: &MockProjectGenerator, version: impl AsRef<str>, ) -> Result<()>

Populate the project with mock files

pub fn ensure_no_errors(&self) -> Result<&Self>

Compiles the project and ensures that the output does not contain errors

pub fn ensure_unchanged(&self) -> Result<&Self>

Compiles the project and ensures that the output is unchanged

pub fn ensure_changed(&self) -> Result<&Self>

Compiles the project and ensures that the output has changed

pub fn ensure_no_errors_recompile_unchanged(&self) -> Result<&Self>

Compiles the project and ensures that the output does not contain errors and no changes exists on recompiled.

This is a convenience function for ensure_no_errors + ensure_unchanged.

pub fn assert_no_errors_recompile_unchanged(&self) -> &Self

Compiles the project and asserts that the output does not contain errors and no changes exists on recompiled.

This is a convenience function for assert_no_errors + assert_unchanged.

pub fn assert_no_errors(&self) -> &Self

Compiles the project and asserts that the output does not contain errors

pub fn assert_unchanged(&self) -> &Self

Compiles the project and asserts that the output is unchanged

pub fn assert_changed(&self) -> &Self

Compiles the project and asserts that the output is changed

pub fn list_source_files(&self) -> Vec<PathBuf>

Returns a list of all source files in the project’s src directory

impl TempProject

pub fn dapptools_with_ignore_paths( paths_to_ignore: Vec<PathBuf>, ) -> Result<Self>

Available on crate feature svm-solc only.

pub fn checkout(repo: impl AsRef<str>) -> Result<Self>

Available on crate feature svm-solc only.

Clones the given repo into a temp dir, initializes it recursively and configures it.

pub fn mocked( settings: &MockProjectSettings, version: impl AsRef<str>, ) -> Result<Self>

Available on crate feature svm-solc only.

Create a new temporary project and populate it with mock files.

pub fn mocked_random(version: impl AsRef<str>) -> Result<Self>

Available on crate feature svm-solc only.

Create a new temporary project and populate it with a random layout.

Trait Implementations

impl<T: ArtifactOutput + Default> AsRef<Project<MultiCompiler, T>> for TempProject<MultiCompiler, T>

fn as_ref(&self) -> &Project<MultiCompiler, T>

Converts this type into a shared reference of the (usually inferred) input type.

impl<T: ArtifactOutput> Debug for TempProject<MultiCompiler, T>

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

Formats the value using the given formatter.