Struct guppy::graph::Workspace

pub struct Workspace<'g> { /* fields omitted */ }

Information about a workspace, parsed from metadata returned by cargo metadata.

For more about workspaces, see Cargo Workspaces in The Rust Programming Language.

Implementations

impl<'g> Workspace<'g>

These parallel iterators require the rayon1 feature is enabled.

pub fn par_iter(&self) -> impl ParallelIterator<Item = PackageMetadata<'g>>

Returns a parallel iterator over package metadatas, sorted by workspace path.

Requires the rayon1 feature to be enabled.

pub fn par_iter_by_path(
    &self
) -> impl ParallelIterator<Item = (&'g Utf8Path, PackageMetadata<'g>)>

Returns a parallel iterator over workspace paths and package metadatas, sorted by workspace paths.

Requires the rayon1 feature to be enabled.

pub fn par_iter_by_name(
    &self
) -> impl ParallelIterator<Item = (&'g str, PackageMetadata<'g>)>

Returns a parallel iterator over workspace names and package metadatas, sorted by package names.

Requires the rayon1 feature to be enabled.

impl<'g> Workspace<'g>

pub fn root(&self) -> &'g Utf8Path

Returns the workspace root.

pub fn member_count(&self) -> usize

Returns the number of packages in this workspace.

pub fn contains_name(&self, name: impl AsRef<str>) -> bool

Returns true if the workspace contains a package by the given name.

pub fn contains_path(&self, path: impl AsRef<Utf8Path>) -> bool

Returns true if the workspace contains a package by the given workspace path.

pub fn iter(
    &self
) -> impl Iterator<Item = PackageMetadata<'g>> + ExactSizeIterator

Returns an iterator over package metadatas, sorted by the path they’re in.

pub fn iter_by_path(
    &self
) -> impl Iterator<Item = (&'g Utf8Path, PackageMetadata<'g>)> + ExactSizeIterator

Returns an iterator over workspace paths and package metadatas, sorted by the path they’re in.

pub fn iter_by_name(
    &self
) -> impl Iterator<Item = (&'g str, PackageMetadata<'g>)> + ExactSizeIterator

Returns an iterator over workspace names and package metadatas, sorted by names.

pub fn member_ids(
    &self
) -> impl Iterator<Item = &'g PackageId> + ExactSizeIterator

Returns an iterator over package IDs for workspace members. The package IDs will be returned in the same order as members, sorted by the path they’re in.

pub fn member_by_path(
    &self,
    path: impl AsRef<Utf8Path>
) -> Result<PackageMetadata<'g>, Error>

Maps the given path to the corresponding workspace member.

Returns an error if the path didn’t match any workspace members.

pub fn members_by_paths<B>(
    &self,
    paths: impl IntoIterator<Item = impl AsRef<Utf8Path>>
) -> Result<B, Error> where
    B: FromIterator<PackageMetadata<'g>>, 

Maps the given paths to their corresponding workspace members, returning a new value of the specified collection type (e.g. Vec).

Returns an error if any of the paths were unknown.

pub fn member_by_name(
    &self,
    name: impl AsRef<str>
) -> Result<PackageMetadata<'g>, Error>

Maps the given name to the corresponding workspace member.

Returns an error if the name didn’t match any workspace members.

pub fn members_by_names<B>(
    &self,
    names: impl IntoIterator<Item = impl AsRef<str>>
) -> Result<B, Error> where
    B: FromIterator<PackageMetadata<'g>>, 

Maps the given names to their corresponding workspace members, returning a new value of the specified collection type (e.g. Vec).

Returns an error if any of the paths were unknown.

impl<'g> Workspace<'g>

Helpers for property testing

The methods in this section allow a Workspace to be used in property-based testing scenarios.

Currently, proptest 1 is supported if the proptest1 feature is enabled.

pub fn prop010_name_strategy(&self) -> impl Strategy<Value = &'g str> + 'g

Returns a Strategy that generates random package names from this workspace.

Requires the proptest1 feature to be enabled.

Panics

Panics if there are no packages in this Workspace.

pub fn prop010_id_strategy(&self) -> impl Strategy<Value = &'g PackageId> + 'g

Returns a Strategy that generates random package IDs from this workspace.

Requires the proptest1 feature to be enabled.

Panics

Panics if there are no packages in this Workspace.

Trait Implementations

impl<'g> Clone for Workspace<'g>

fn clone(&self) -> Workspace<'g>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'g> Debug for Workspace<'g>

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

Formats the value using the given formatter.