Module: Textus::Key::Matching

Defined in:
lib/textus/key/matching.rb

Overview

Dotted-key scope matching, shared by all prefix-scoped sweeps (WS4 / ADR 0089-era cleanup). Canonicalised here so every consumer uses a consistent dotted-boundary check with proper Nested ancestor handling. ADR 0093: Produce is the sole engine calling this.

Class Method Summary collapse

Class Method Details

.matches_prefix?(key, prefix, nested: false) ⇒ Boolean

Is ‘key` within the `prefix` scope?

- exact match, or a dotted descendant (the `prefix.` boundary, so
  prefix "art" does NOT match key "artifacts"), and
- for a nested entry, also when `prefix` descends INTO it — the nested
  parent owns the leaf the prefix names (e.g. prefix
  "feeds.machines.host1" still selects the nested entry
  "feeds.machines").

Returns:

  • (Boolean) 


17
18
19
20
21
 
# File 'lib/textus/key/matching.rb', line 17

def matches_prefix?(key, prefix, nested: false)
  return true if key == prefix || key.start_with?("#{prefix}.")

  nested && prefix.start_with?("#{key}.")
end