Struct ConfigCandidateIndex 

pub struct ConfigCandidateIndex { /* private fields */ }

In-memory directory listing of config-candidate files (and discovered source files), keyed by absolute directory, used to resolve plugin config patterns without re-walking the filesystem.

Built once from the files the discovery walk already collected, so a discover_config_files lookup that previously cost one filesystem stat per (plugin, ancestor-directory, pattern) becomes an in-memory set lookup. The walk respects .gitignore / ignorePatterns / the hidden-directory allowlist, so config discovery via this index follows the same traversal rules as source discovery (the raw filesystem path used in production mode does not); see the crate docs / CHANGELOG for that deliberate refinement.

Implementations

impl ConfigCandidateIndex

pub fn build<'a>(paths: impl IntoIterator<Item = &'a Path>) -> Self

Build the index from absolute file paths (discovered source files unioned with non-source config candidates). Files with no parent or no file name are skipped.

pub fn dir_contains(&self, dir: &Path, name: &OsStr) -> bool

Whether the directory dir contains a file named name, per the files the discovery walk collected. Used by file-based plugin activation to avoid a per-directory filesystem read probe.

pub fn any_descendant_contains(&self, root: &Path, name: &OsStr) -> bool

Whether any directory at or below root contains a file named name, per the files the discovery walk collected. Lets a plugin activate from a sentinel file nested anywhere under root (e.g. a .env.schema in a workspace subdirectory) without a recursive filesystem walk.