Struct NameMatcher 

pub struct NameMatcher<'a> { /* private fields */ }

A reusable text prefilter for an identifier or keyword.

A match only indicates that a source may contain the name: matches in comments and strings are included. Matchers created with Self::new accept sources that change under NFKC normalization because Python normalizes identifiers this way. Matchers created with Self::keyword search their literal spelling instead. Callers should validate candidates using the AST or semantic analysis.

Construct a matcher once and reuse it across sources to avoid preprocessing the name for each source. Cache matchers for fixed names in a std::sync::LazyLock.

Implementations

impl<'a> NameMatcher<'a>

pub fn new(name: &'a str) -> Self

Creates an identifier matcher that borrows name without allocating.

The identifier name is expected to be NFKC-normalized.

pub fn keyword(keyword: &'a str) -> Self

Creates a keyword matcher that borrows keyword without allocating.

Python recognizes keywords by their literal spelling, without NFKC normalization, so keyword matchers skip the normalization check.

pub fn may_match(&self, source: &str) -> bool

Returns whether source may contain the configured identifier or keyword.

Identifier matchers conservatively return true if the source changes under NFKC normalization. Otherwise, searches for the literal spelling bounded by bytes other than ASCII letters, digits or _. Matches may occur in comments, strings, or Unicode identifiers.

Trait Implementations

impl<'a> Clone for NameMatcher<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for NameMatcher<'a>

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

Formats the value using the given formatter.