Struct forc_pkg::manifest::ManifestFile

pub struct ManifestFile { /* private fields */ }

A Manifest that was deserialized from a file at a particular path.

Implementations

impl ManifestFile

pub fn from_file(path: PathBuf, sway_git_tag: &str) -> Result<Self>

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

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 sway_git_tag is used to specify the pinned commit at which we fetch std.

pub fn from_dir(manifest_dir: &Path, sway_git_tag: &str) -> Result<Self>

Read the manifest from the Forc.toml in the directory specified by the given path or any of its parent directories.

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

pub fn validate(&self, path: &Path) -> Result<()>

Validate the Manifest.

This checks the project and organization names against a set of reserved/restricted keywords and patterns, and if a given entry point exists.

pub fn path(&self) -> &Path

The path to the Forc.toml from which this manifest was loaded.

This will always be a canonical path.

pub fn dir(&self) -> &Path

The path to the directory containing the Forc.toml from which this manfiest was loaded.

This will always be a canonical path.

pub fn entry_path(&self) -> PathBuf

Given the directory in which the file associated with this Manifest resides, produce the path to the entry file as specified in the manifest.

This will always be a canonical path.

pub fn entry_string(&self) -> Result<Arc<str>>

Produces the string of the entry point file.

pub fn program_type(&self) -> Result<TreeType>

Parse and return the associated project’s program type.

pub fn check_program_type(&self, expected_types: Vec<TreeType>) -> Result<()>

Given the current directory and expected program type, determines whether the correct program type is present.

pub fn build_profile(&self, profile_name: &str) -> Option<&BuildProfile>

Access the build profile associated with the given profile name.

pub fn dep_path(&self, dep_name: &str) -> Option<PathBuf>

Given the name of a path dependency, returns the full canonical Path to the dependency.

Methods from Deref<Target = Manifest>

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

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

Validate the Manifest.

This checks the project and organization names against a set of reserved/restricted keywords and patterns.

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 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 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 patch(&self, patch_name: &str) -> Option<&BTreeMap<String, Dependency>>

Retrieve the listed patches for the given name.

Trait Implementations

impl Clone for ManifestFile

fn clone(&self) -> ManifestFile

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ManifestFile

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

Formats the value using the given formatter.

impl Deref for ManifestFile

type Target = Manifest

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.