Struct RustProject 

pub struct RustProject { /* private fields */ }

A factual Cargo project index rooted at one canonical repository root.

Views are borrowed and deterministically ordered by stable structural keys, so reordering filesystem enumeration cannot change what a caller reads.

Implementations

impl RustProject

pub fn load( root: &Path, limits: ResolutionLimits, ) -> Result<Self, RustProjectError>

Read every manifest beneath root and index the project it declares.

Reads Cargo.toml files and directory listings only: no Rust source is opened and Cargo is never invoked.

pub fn root(&self) -> &Path

The canonical repository root this project was loaded from.

pub fn limits(&self) -> ResolutionLimits

The limits this project was loaded under and retains for snapshots.

pub fn packages(&self) -> &[RustPackage]

Every package in the project, workspace members and eligible in-root path dependencies alike, ordered by manifest path.

pub fn workspace_members(&self) -> impl Iterator<Item = &RustPackage>

Only the packages the workspace declares as members.

pub fn package(&self, id: PackageId) -> Option<&RustPackage>

The package an identity issued by this project selects.

pub fn targets(&self) -> &[RustTarget]

Every target in the project, ordered by package, kind, then name.

pub fn target(&self, id: TargetId) -> Option<&RustTarget>

The target an identity issued by this project selects.

pub fn package_targets( &self, package: PackageId, ) -> impl Iterator<Item = &RustTarget>

Every target one package declares.

pub fn dependencies(&self) -> &[RustDependency]

Every dependency edge in the project, ordered by package, kind, then local dependency name.

pub fn snapshot_target( &self, target: TargetId, ) -> Result<RustTargetSnapshot, RustSnapshotError>

Snapshot only this target’s Rust module closure.

The target’s authority is validated before any source is read, and the closure is all-or-error: a caller receives every reachable source or a typed failure, never a partial set.

pub fn snapshot_package_primary_targets( &self, package: PackageId, ) -> Result<RustPackageSnapshot, RustPackageSnapshotError>

Snapshot every library, binary, and build-script target of one package.

Target closures remain separate views, but all of them share one source store so an overlapping source is read, hashed, and parsed once. Any incomplete target refuses the entire package snapshot.

pub fn snapshot_resolution( &self, target: TargetId, ) -> Result<RustResolutionSnapshot, RustSnapshotError>

Snapshot this target together with its same-package library, when Cargo exposes one, and the in-repository dependency libraries its namespace resolves names against.

pub fn package_dependencies( &self, package: PackageId, ) -> impl Iterator<Item = &RustDependency>

Every dependency edge one package declares.

Trait Implementations

impl Debug for RustProject

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

Formats the value using the given formatter.