Struct 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>) -> Self

Creates a new instance of Source with the given content.

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

Reads the file’s content

pub fn read_(file: &Path) -> Result<Self, SolcError>

read + mapping error to SolcError.

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 list.

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

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

Reads all of the given 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.

pub fn content_hash_of(src: &str) -> String

Generate a non-cryptographically secure checksum of the given source.

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 duplicate 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

Formats the value using the given formatter.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Source

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

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Source

impl StructuralPartialEq for Source