Struct Context 

pub struct Context<'a> {
    pub root: &'a Path,
    pub index: &'a FileIndex,
    pub registry: Option<&'a RuleRegistry>,
    pub facts: Option<&'a FactValues>,
    pub vars: Option<&'a HashMap<String, String>>,
    pub git_tracked: Option<&'a HashSet<PathBuf>>,
    pub git_blame: Option<&'a BlameCache>,
}

Execution context handed to each rule during evaluation.

• registry — available for rules that need to build and evaluate nested rules at runtime (e.g. for_each_dir). Tests that don’t exercise nested evaluation can set this to None.
• facts — resolved fact values, computed once per Engine::run.
• vars — user-supplied string variables from the config’s vars: section.
• git_tracked — set of repo paths reported by git ls-files, computed once per run when at least one rule has git_tracked_only: true. None outside a git repo or when no rule asked for it. Rules that opt in consult it via Context::is_git_tracked.
• git_blame — per-file git blame cache, computed lazily when at least one rule reports wants_git_blame(). None when no rule asked for it. Rules consult it via crate::git::BlameCache::get; both “outside a git repo” and “blame failed for this file” surface as a None lookup, which the rule treats as “silent no-op.”

Fields

root: &'a Path

index: &'a FileIndex

registry: Option<&'a RuleRegistry>

facts: Option<&'a FactValues>

vars: Option<&'a HashMap<String, String>>

git_tracked: Option<&'a HashSet<PathBuf>>

git_blame: Option<&'a BlameCache>

Implementations

impl Context<'_>

pub fn is_git_tracked(&self, rel_path: &Path) -> bool

True if rel_path is in git’s index. Returns false when no tracked-set was computed (no git repo, or no rule asked for it). Rules that opt into git_tracked_only therefore silently skip every entry outside a git repo, which is the right behaviour for the canonical “don’t let X be committed” use case.

pub fn dir_has_tracked_files(&self, rel_path: &Path) -> bool

True if the directory at rel_path contains at least one git-tracked file. Used by dir_* rules opting into git_tracked_only. Same None-means-untracked semantics as Context::is_git_tracked.

Trait Implementations

impl<'a> Debug for Context<'a>

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

Formats the value using the given formatter.