Struct foundry_compilers_artifacts::Source

pub struct Source {
    pub content: Arc<String>,
    pub kind: SourceCompilationKind,
}

Content of a solidity file

This contains the actual source code of a file

Fields

content: Arc<String>

Content of the file

This is an Arc because it may be cloned. If the graph of the project contains multiple conflicting versions then the same Source may be required by conflicting versions and needs to be duplicated.

kind: SourceCompilationKind

Implementations

impl Source

pub fn new(content: impl Into<String>) -> Source

Creates a new instance of Source with the given content.

pub fn read(file: &Path) -> Result<Source, SolcIoError>

Reads the file’s content

pub fn is_dirty(&self) -> bool

Returns true if the source should be compiled with full output selection.

pub fn read_all_from( dir: &Path, extensions: &[&str], ) -> Result<Sources, SolcIoError>

Recursively finds all source files under the given dir path and reads them all

pub fn read_sol_yul_from(dir: &Path) -> Result<Sources, SolcIoError>

Recursively finds all solidity and yul files under the given dir path and reads them all

pub fn read_all_files(files: Vec<PathBuf>) -> Result<Sources, SolcIoError>

Reads all source files of the given vec

Depending on the len of the vec it will try to read the files in parallel

pub fn read_all<T, I>(files: I) -> Result<Sources, SolcIoError>

where I: IntoIterator<Item = T>, T: Into<PathBuf>,

Reads all files

pub fn par_read_all<T, I>(files: I) -> Result<Sources, SolcIoError>

where I: IntoIterator<Item = T>, <I as IntoIterator>::IntoIter: Send, T: Into<PathBuf> + Send,

Parallelized version of Self::read_all that reads all files using a parallel iterator

NOTE: this is only expected to be faster than Self::read_all if the given iterator contains at least several paths or the files are rather large.

pub fn content_hash(&self) -> String

Generate a non-cryptographically secure checksum of the file’s content

Trait Implementations

impl AsRef<[u8]> for Source

fn as_ref(&self) -> &[u8]

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

impl AsRef<str> for Source

fn as_ref(&self) -> &str

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

impl Clone for Source

fn clone(&self) -> Source

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Source

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Source

fn deserialize<__D>( __deserializer: __D, ) -> Result<Source, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Source

fn eq(&self, other: &Source) -> 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 Source

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Source

impl StructuralPartialEq for Source