Struct foundry_compilers::AggregatedCompilerOutput

pub struct AggregatedCompilerOutput {
    pub errors: Vec<Error>,
    pub sources: VersionedSourceFiles,
    pub contracts: VersionedContracts,
    pub build_infos: BTreeMap<Version, RawBuildInfo>,
}

The aggregated output of (multiple) compile jobs

This is effectively a solc version aware CompilerOutput

Fields

errors: Vec<Error>

all errors from all CompilerOutput

sources: VersionedSourceFiles

All source files combined with the solc version used to compile them

contracts: VersionedContracts

All compiled contracts combined with the solc version used to compile them

build_infos: BTreeMap<Version, RawBuildInfo>

Implementations

impl AggregatedCompilerOutput

pub fn slash_paths(&mut self)

Converts all \\ separators in all paths to /

pub fn has_error( &self, ignored_error_codes: &[u64], ignored_file_paths: &[PathBuf], compiler_severity_filter: &Severity ) -> bool

Whether the output contains a compiler error

This adheres to the given compiler_severity_filter and also considers Error with the given Severity as errors. For example Severity::Warning will consider Errors with Severity::Warning and Severity::Error as errors.

pub fn has_warning<'a>(&self, filter: impl Into<ErrorFilter<'a>>) -> bool

Checks if there are any compiler warnings that are not ignored by the specified error codes and file paths.

pub fn diagnostics<'a>( &'a self, ignored_error_codes: &'a [u64], ignored_file_paths: &'a [PathBuf], compiler_severity_filter: Severity ) -> OutputDiagnostics<'a>

pub fn is_empty(&self) -> bool

pub fn is_unchanged(&self) -> bool

pub fn extend_all<I>(&mut self, out: I)

where I: IntoIterator<Item = (Version, CompilerOutput)>,

pub fn extend(&mut self, version: Version, output: CompilerOutput)

adds a new CompilerOutput to the aggregated output

pub fn write_build_infos( &self, build_info_dir: impl AsRef<Path> ) -> Result<(), SolcIoError>

Creates all BuildInfo files in the given build_info_dir

There can be multiple BuildInfo, since we support multiple versions.

The created files have the md5 hash {_format,solcVersion,solcLongVersion,input} as their file name

pub fn find_first( &self, contract: impl AsRef<str> ) -> Option<CompactContractRef<'_>>

Finds the first contract with the given name

Examples

use foundry_compilers::{artifacts::*, Project};

let project = Project::builder().build()?;
let output = project.compile()?.into_output();
let contract = output.find_first("Greeter").unwrap();

pub fn remove_first(&mut self, contract: impl AsRef<str>) -> Option<Contract>

Removes the first contract with the given name from the set

Examples

use foundry_compilers::{artifacts::*, Project};

let project = Project::builder().build()?;
let mut output = project.compile()?.into_output();
let contract = output.remove_first("Greeter").unwrap();

pub fn remove( &mut self, path: impl AsRef<str>, contract: impl AsRef<str> ) -> Option<Contract>

Removes the contract with matching path and name

Examples

use foundry_compilers::{artifacts::*, Project};

let project = Project::builder().build()?;
let mut output = project.compile()?.into_output();
let contract = output.remove("src/Greeter.sol", "Greeter").unwrap();

pub fn remove_contract<'a>( &mut self, info: impl Into<ContractInfoRef<'a>> ) -> Option<Contract>

Removes the contract with matching path and name using the <path>:<contractname> pattern where path is optional.

If the path segment is None, then the first matching Contract is returned, see Self::remove_first

Examples

use foundry_compilers::{artifacts::*, info::ContractInfo, Project};

let project = Project::builder().build()?;
let mut output = project.compile()?.into_output();
let info = ContractInfo::new("src/Greeter.sol:Greeter");
let contract = output.remove_contract(&info).unwrap();

pub fn contracts_iter(&self) -> impl Iterator<Item = (&String, &Contract)>

Iterate over all contracts and their names

pub fn contracts_into_iter(self) -> impl Iterator<Item = (String, Contract)>

Iterate over all contracts and their names

pub fn contracts_with_files_iter( &self ) -> impl Iterator<Item = (&String, &String, &Contract)>

Returns an iterator over (file, name, Contract)

pub fn contracts_with_files_into_iter( self ) -> impl Iterator<Item = (String, String, Contract)>

Returns an iterator over (file, name, Contract)

pub fn contracts_with_files_and_version_iter( &self ) -> impl Iterator<Item = (&String, &String, &Contract, &Version)>

Returns an iterator over (file, name, Contract, Version)

pub fn contracts_with_files_and_version_into_iter( self ) -> impl Iterator<Item = (String, String, Contract, Version)>

Returns an iterator over (file, name, Contract, Version)

pub fn get( &self, path: impl AsRef<str>, contract: impl AsRef<str> ) -> Option<CompactContractRef<'_>>

Given the contract file’s path and the contract’s name, tries to return the contract’s bytecode, runtime bytecode, and ABI.

Examples

use foundry_compilers::{artifacts::*, Project};

let project = Project::builder().build()?;
let output = project.compile()?.into_output();
let contract = output.get("src/Greeter.sol", "Greeter").unwrap();

pub fn split(self) -> (VersionedSourceFiles, VersionedContracts)

Returns the output’s source files and contracts separately, wrapped in helper types that provide several helper methods

Examples

use foundry_compilers::Project;

let project = Project::builder().build()?;
let output = project.compile()?.into_output();
let (sources, contracts) = output.split();

pub fn join_all(&mut self, root: impl AsRef<Path>) -> &mut Self

Joins all file path with root

pub fn with_stripped_file_prefixes(self, base: impl AsRef<Path>) -> Self

Strips the given prefix from all file paths to make them relative to the given base argument.

Convenience method for Self::strip_prefix_all() that consumes the type.

Examples

Make all sources and contracts relative to the project’s root directory

use foundry_compilers::Project;

let project = Project::builder().build()?;
let output = project.compile()?.into_output().with_stripped_file_prefixes(project.root());

pub fn strip_prefix_all(&mut self, base: impl AsRef<Path>) -> &mut Self

Removes base from all contract paths

Trait Implementations

impl Clone for AggregatedCompilerOutput

fn clone(&self) -> AggregatedCompilerOutput

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AggregatedCompilerOutput

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

Formats the value using the given formatter.

impl Default for AggregatedCompilerOutput

fn default() -> AggregatedCompilerOutput

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AggregatedCompilerOutput

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AggregatedCompilerOutput

fn eq(&self, other: &AggregatedCompilerOutput) -> bool

This method tests for self and other values to be equal, and is used by ==.

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.

impl Serialize for AggregatedCompilerOutput

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AggregatedCompilerOutput