Struct SourceLocator 

pub struct SourceLocator { /* private fields */ }

Locates crate sources in the Cargo registry.

The locator can find sources either by scanning the registry directly or by using cargo metadata to find exact paths for dependencies.

Implementations

impl SourceLocator

pub fn new() -> Result<Self, Error>

Create a new SourceLocator with the default registry path.

Errors

Returns an error if the home directory cannot be determined.

pub const fn with_registry_path(registry_path: PathBuf) -> Self

Create a SourceLocator with a custom registry path.

pub fn load_metadata(&mut self, manifest_path: &Path) -> Result<(), Error>

Load cargo metadata from a project directory.

This enables more accurate source location by using the exact paths from cargo’s dependency resolution.

Errors

Returns an error if cargo metadata cannot be loaded.

pub fn load_metadata_from_current_dir(&mut self) -> Result<(), Error>

Load cargo metadata from the current directory.

Errors

Returns an error if cargo metadata cannot be loaded.

pub fn locate(&self, name: &str, version: &str) -> Result<PathBuf, Error>

Locate the source directory for a crate by name and version.

First tries to use cargo metadata if available, then falls back to scanning the registry directory.

Errors

Returns an error if the source cannot be found.

pub fn packages(&self) -> Option<&[Package]>

Get all packages from the loaded metadata.

Returns None if metadata hasn’t been loaded.

pub fn workspace_root(&self) -> Option<&Path>

Get the workspace root from loaded metadata.

Returns None if metadata hasn’t been loaded.

pub fn all_dependency_sources( &self, ) -> Result<Vec<(String, String, PathBuf)>, Error>

Find all dependency sources for a workspace.

Returns a list of (name, version, path) tuples for all dependencies that have sources in the registry.

Errors

Returns an error if metadata hasn’t been loaded.

pub fn list_registry_crates(&self) -> Result<Vec<(String, String)>, Error>

List all available crate versions in the registry.

Returns a list of (name, version) tuples.

Errors

Returns an error if the registry cannot be read.

Trait Implementations

impl Debug for SourceLocator

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

Formats the value using the given formatter.