entropic::IgnoreMatcher Class Reference

gitignore-style path matcher (#15, v2.1.4). More...

#include <entropic/mcp/servers/ignore_matcher.h>

Classes
struct	Rule
	One compiled gitignore rule (public so internal helpers in the .cpp can construct Rules without friend declarations). More...

Public Member Functions
	IgnoreMatcher ()=default
	Construct an empty matcher (no rules).
void	load (const std::filesystem::path &root)
	Load gitignore + explorerignore from a workspace root.
void	add_pattern (const std::string &pattern, const std::filesystem::path &base={})
	Add a single pattern programmatically (test surface).
bool	is_ignored (const std::string &rel_path, bool is_dir) const
	Test whether a path is ignored.
std::size_t	rule_count () const
	Number of compiled rules (test surface).

Detailed Description

gitignore-style path matcher (#15, v2.1.4).

Single instance owns a compiled rule set. is_ignored is O(rules) per call; rules are evaluated in source order, last-match-wins so that negation patterns (!keep.log) can re-include paths that earlier patterns excluded.

Version

2.1.4

Definition at line 56 of file ignore_matcher.h.

Constructor & Destructor Documentation

IgnoreMatcher()

entropic::IgnoreMatcher::IgnoreMatcher ( )

default

Construct an empty matcher (no rules).

Version

2.1.4

Member Function Documentation

add_pattern()

void entropic::IgnoreMatcher::add_pattern	(	const std::string &	pattern,
		const std::filesystem::path &	base = {}
	)

Add a single pattern programmatically (test surface).

Add a pattern programmatically.

Parameters

pattern	Gitignore-syntax pattern.
base	Anchor directory (relative to root). Empty means "anchored at root."

Version

2.1.4

Definition at line 337 of file ignore_matcher.cpp.

is_ignored()

bool entropic::IgnoreMatcher::is_ignored	(	const std::string &	rel_path,
		bool	is_dir
	)		const

Test whether a path is ignored.

Test a path against the rule set (last-match-wins for negation).

Parameters

rel_path	Forward-slash, relative-to-root path. Must NOT start with /. Trailing slash optional.
is_dir	True if the path refers to a directory.

Returns

true if the path matches an active (non-negated) exclusion rule.

Version

2.1.4

Definition at line 424 of file ignore_matcher.cpp.

load()

void entropic::IgnoreMatcher::load

(

const std::filesystem::path &

root

)

Load gitignore + explorerignore from a workspace root.

Load all .gitignore files (recursive) + .explorerignore.

Walks root recursively for .gitignore files and loads them with their per-directory anchoring. Then loads <root>/.explorerignore (if present) anchored at root. Existing rules are cleared first.

Safe to call repeatedly when the working directory changes.

Parameters

root	Workspace root directory (must exist; non-canonical paths are accepted).

Version

2.1.4

Definition at line 371 of file ignore_matcher.cpp.

rule_count()

std::size_t entropic::IgnoreMatcher::rule_count ( ) const

inline

Number of compiled rules (test surface).

Returns

Rule count. @utility

Version

2.1.4

Definition at line 110 of file ignore_matcher.h.

---

The documentation for this class was generated from the following files:

• entropic/mcp/servers/ignore_matcher.h
• mcp/servers/ignore_matcher.cpp