Struct PathResolver 

pub struct PathResolver { /* private fields */ }

A trie of relative file-paths, tagged by package name (in insertion order).

Implementations

impl PathResolver

pub fn new() -> Self

Create an empty trie.

pub fn packages(&self) -> &IndexSet<PackageName>

Return slice to packages. Note that it is in the order of decreasing priority.

pub fn insert_package<P: AsRef<Path>>( &mut self, package: PackageName, paths: &[P], ) -> Vec<PathBuf>

Insert a package files; return the new paths that conflict with what was already in the trie before this call.

1. File -> File at p: return p.
2. Directory -> File at p: return just p.
3. File -> Directory under some existing file f: return the new file’s p.
4. Directory -> Directory: no conflict.

pub fn unregister_package<N: Into<PackageName>>( &mut self, package: N, ) -> Changes

Unregister all paths belonging to package, then prune empty branches.

Returns a change vectors.

pub fn reprioritize_packages(&mut self, new_order: Vec<PackageName>) -> Changes

Recompute active files based on old (insertion) vs new priority.

pub fn sync_clobbers( target_prefix: &Path, clobbers_dir: &Path, to_clobbers: &[(PathBuf, PackageName)], from_clobbers: &[(PathBuf, PackageName)], ) -> Result<()>

Move files on-disk:

• For each (p,pkg) in to_clobbers: base/p → clobbers/pkg/p if base/p exists and dest doesn’t.
• For each (p,pkg) in from_clobbers: clobbers/pkg/p → base/p if source exists and dest doesn’t.

pub fn packages_for_prefix<P: AsRef<Path>>( &self, path: P, ) -> Option<&HashSet<PackageName>>

Which packages own this prefix?

pub fn packages_for_exact<P: AsRef<Path>>( &self, path: P, ) -> Option<&HashSet<PackageName>>

Who owns exactly this file?

pub fn find_conflicts(&self) -> Vec<(PathBuf, Vec<PackageName>)>

List global file-vs-file conflicts (>1 owners).

pub fn collect_clobbered_paths(&self) -> HashMap<PathBuf, ClobberedPath>

Collect all paths where multiple packages wrote the same file, returning a map from each path to its final owner and overridden packages.

Trait Implementations

impl Clone for PathResolver

fn clone(&self) -> PathResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathResolver

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

Formats the value using the given formatter.

impl Default for PathResolver

fn default() -> PathResolver

Returns the “default value” for a type.

impl PartialEq for PathResolver

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

impl StructuralPartialEq for PathResolver