Struct PackageGraph 

pub struct PackageGraph {
    pub root_manifest_path: PathBuf,
    pub root_dir: PathBuf,
    pub is_workspace_root: bool,
    pub root_package: Option<usize>,
    pub root_settings: RootSettings,
    pub primary_packages: Vec<usize>,
    pub default_members: Vec<usize>,
    pub excluded_members: Vec<PathBuf>,
    pub packages: Vec<WorkspacePackage>,
}

A loaded set of local Cabin packages with their dependency edges resolved against the local filesystem.

Packages appear in topological order: a package’s local dependencies always appear before the package itself in PackageGraph::packages.

Fields

root_manifest_path: PathBuf

Path to the manifest the user passed (canonicalized to absolute).

root_dir: PathBuf

Directory containing the root manifest.

is_workspace_root: bool

Whether the root manifest declares a [workspace] table.

root_package: Option<usize>

If the root manifest itself is a package (i.e. has a [package] Table), the index of that package in PackageGraph::packages.

root_settings: RootSettings

Root-manifest policy settings. For package roots this mirrors the root package’s root-owned fields; for pure workspace roots this is the only place those settings are exposed.

primary_packages: Vec<usize>

Indices of packages that count as “primary” — i.e. would be built when no narrower package selection is given.

For a single package this is just the root. For a workspace root it is every member declared by [workspace.members]. Path dependencies pulled in transitively are not primary.

default_members: Vec<usize>

Indices of packages listed under [workspace.default-members], validated to be members. Empty when the workspace declares no defaults — callers fall back to the documented “all members” behavior. Always a subset of primary_packages.

excluded_members: Vec<PathBuf>

Relative paths under root_dir for any directories dropped by [workspace.exclude]. Carried through purely for metadata reporting; the loader has already removed them from primary_packages.

packages: Vec<WorkspacePackage>

All loaded packages, in topological order.

Implementations

impl PackageGraph

pub fn package_by_name(&self, name: &str) -> Option<&WorkspacePackage>

Find a package by name. Linear scan; package counts are small.

pub fn index_of(&self, name: &str) -> Option<usize>

Index of a package by name. Returned together with the reference for callers that need to record edges by index.

Trait Implementations

impl Clone for PackageGraph

fn clone(&self) -> PackageGraph

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PackageGraph

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

Formats the value using the given formatter.

impl Eq for PackageGraph

impl PartialEq for PackageGraph

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