Struct PackageManifest

pub struct PackageManifest {
    pub project: Project,
    pub network: Option<Network>,
    pub dependencies: Option<BTreeMap<String, Dependency>>,
    pub patch: Option<BTreeMap<String, BTreeMap<String, Dependency>>>,
    pub build_target: Option<BTreeMap<String, BuildTarget>>,
    pub contract_dependencies: Option<BTreeMap<String, ContractDependency>>,
    pub proxy: Option<Proxy>,
    /* private fields */
}

A direct mapping to a Forc.toml.

Fields

project: Project

network: Option<Network>

dependencies: Option<BTreeMap<String, Dependency>>

patch: Option<BTreeMap<String, BTreeMap<String, Dependency>>>

build_target: Option<BTreeMap<String, BuildTarget>>

A list of configuration-time constants.

contract_dependencies: Option<BTreeMap<String, ContractDependency>>

proxy: Option<Proxy>

Implementations

impl PackageManifest

pub const DEFAULT_ENTRY_FILE_NAME: &'static str = "main.sw"

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self>

Given a path to a Forc.toml, read it and construct a PackageManifest.

This also validates the manifest, returning an Err in the case that invalid names, fields were used.

If core and std are unspecified, std will be added to the dependencies table implicitly. In this case, the git tag associated with the version of this crate is used to specify the pinned commit at which we fetch std.

pub fn validate(&self) -> Result<()>

Validate the PackageManifest.

This checks:

1. The project and organization names against a set of reserved/restricted keywords and patterns.
2. The validity of the details provided. Makes sure that there are no mismatching detail declarations (to prevent mixing details specific to certain types).

pub fn from_dir<P: AsRef<Path>>(dir: P) -> Result<Self>

Given a directory to a forc project containing a Forc.toml, read the manifest.

This is short for PackageManifest::from_file, but takes care of constructing the path to the file.

pub fn deps(&self) -> impl Iterator<Item = (&String, &Dependency)>

Produce an iterator yielding all listed dependencies.

pub fn build_profiles(&self) -> impl Iterator<Item = (&String, &BuildProfile)>

Produce an iterator yielding all listed build profiles.

pub fn contract_deps( &self, ) -> impl Iterator<Item = (&String, &ContractDependency)>

Produce an iterator yielding all listed contract dependencies

pub fn deps_detailed( &self, ) -> impl Iterator<Item = (&String, &DependencyDetails)>

Produce an iterator yielding all Detailed dependencies.

pub fn patches( &self, ) -> impl Iterator<Item = (&String, &BTreeMap<String, Dependency>)>

Produce an iterator yielding all listed patches.

pub fn patch(&self, patch_name: &str) -> Option<&BTreeMap<String, Dependency>>

Retrieve the listed patches for the given name.

pub fn proxy(&self) -> Option<&Proxy>

Retrieve the proxy table for the package.

pub fn dep(&self, dep_name: &str) -> Option<&Dependency>

Retrieve a reference to the dependency with the given name.

pub fn dep_detailed(&self, dep_name: &str) -> Option<&DependencyDetails>

Retrieve a reference to the dependency with the given name.

pub fn contract_dep( &self, contract_dep_name: &str, ) -> Option<&ContractDependency>

Retrieve a reference to the contract dependency with the given name.

pub fn contract_dependency_detailed( &self, contract_dep_name: &str, ) -> Option<&DependencyDetails>

Retrieve a reference to the contract dependency with the given name.

Trait Implementations

impl Clone for PackageManifest

fn clone(&self) -> PackageManifest

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PackageManifest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PackageManifest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PackageManifest

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

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 PackageManifest