Guard the remaining config data invariants at import time

prefixes.py asserts its own invariants at import so a bad edit fails
immediately rather than drifting until a test happens to catch it. The
other data modules had no such guard, and two of them had already
drifted.

Data fixes:

- 'esq' was in both SUFFIX_ACRONYMS and SUFFIX_NOT_ACRONYMS. Those are
  the two halves of one distinction, not overlapping categories.
  _classify checks suffix_words first, so the acronym membership was
  unreachable -- removing it changes 0 of the 486 differential-corpus
  parses. Present in v1's data too; inherited, not introduced.
- TITLES contained 'actor ' and 'television ' with trailing spaces, so
  "'actor' in TITLES" was False. Parsing was unaffected because both
  Lexicon and v1's SetManager normalize on ingest, which is exactly what
  let the typo survive. Also inherited from v1.

Assertions added:

- suffixes.py: SUFFIX_ACRONYMS_AMBIGUOUS <= SUFFIX_ACRONYMS, and
  SUFFIX_ACRONYMS disjoint from SUFFIX_NOT_ACRONYMS.
- titles.py: FIRST_NAME_TITLES <= TITLES. True by construction today
  (TITLES = FIRST_NAME_TITLES | {...}), so it pins that against a
  future edit making TITLES standalone.
- All six vocabulary modules plus CAPITALIZATION_EXCEPTIONS' keys:
  entries stored lowercase and whitespace-free. This is the check that
  found the TITLES typo.

Deliberately NOT asserted: cross-category disjointness. TITLES and
SUFFIX_ACRONYMS share 15 entries (lt, md, phd, cpt, ...) and every one
is a legitimate homograph resolved by position, as are TITLES/PREFIXES
and SUFFIX_ACRONYMS/PREFIXES.

The predicates use .strip().lower() rather than _lexicon._normalize:
config/ is the lower layer and _lexicon imports from it, so importing
back would invert the layering. Each guard was verified to fire on a
mutated copy of its own data -- an assertion that cannot fail is worth
nothing.

Note `assert` is stripped under `python -O`. These protect the shipped
data during development; Lexicon re-checks the relationships at
construction, which is what protects a caller's own vocabulary.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: derek73

nameparser/config/bound_first_names.py

@@ -21,3 +21,10 @@
     'أم',     # "umm" (mother of), hamza spelling
     'ام',     # "umm", hamza-less spelling
 }
+
+
+# See prefixes.py: entries are looked up in normalized form, so a stray
+# capital or trailing space makes one unreachable by direct membership
+# test even though the parser's own ingest normalizes it away.
+assert all(w == w.strip().lower() for w in BOUND_FIRST_NAMES), \
+    "BOUND_FIRST_NAMES entries must be stored lowercase and whitespace-free"

nameparser/config/capitalization.py

@@ -8,3 +8,9 @@
 """
 Any pieces that are not capitalized by capitalizing the first letter.
 """
+
+
+# See prefixes.py: keys are looked up in normalized form. Only the keys --
+# the values are the exact-cased replacements, so they are cased on purpose.
+assert all(k == k.strip().lower() for k in CAPITALIZATION_EXCEPTIONS), \
+    "CAPITALIZATION_EXCEPTIONS keys must be stored lowercase and whitespace-free"

nameparser/config/conjunctions.py

@@ -26,3 +26,10 @@
 "of" and "the" are also include to facilitate joining multiple titles,
 e.g. "President of the United States".
 """
+
+
+# See prefixes.py: entries are looked up in normalized form, so a stray
+# capital or trailing space makes one unreachable by direct membership
+# test even though the parser's own ingest normalizes it away.
+assert all(w == w.strip().lower() for w in CONJUNCTIONS), \
+    "CONJUNCTIONS entries must be stored lowercase and whitespace-free"

nameparser/config/maiden_markers.py

@@ -35,3 +35,10 @@
 abbreviation "f." (collides with the initial "F." — only the full
 participles are safe).
 """
+
+
+# See prefixes.py: entries are looked up in normalized form, so a stray
+# capital or trailing space makes one unreachable by direct membership
+# test even though the parser's own ingest normalizes it away.
+assert all(w == w.strip().lower() for w in MAIDEN_MARKERS), \
+    "MAIDEN_MARKERS entries must be stored lowercase and whitespace-free"

nameparser/config/prefixes.py

@@ -126,3 +126,8 @@
     "NON_FIRST_NAME_PREFIXES must stay a subset of PREFIXES"
 assert not (NON_FIRST_NAME_PREFIXES & BOUND_FIRST_NAMES), \
     "NON_FIRST_NAME_PREFIXES must stay disjoint from BOUND_FIRST_NAMES"
+# Entries are looked up in normalized form; a stray capital or trailing
+# space makes one unreachable by direct membership test even though the
+# parser's own ingest normalizes it away.
+assert all(w == w.strip().lower() for w in PREFIXES), \
+    "PREFIXES entries must be stored lowercase and whitespace-free"

nameparser/config/suffixes.py

@@ -391,7 +391,6 @@
     'emt-p',
     'enp',
     'erd',
-    'esq',
     'evp',
     'faafp',
     'faan',
@@ -710,3 +709,20 @@
 when matching against these pieces.
 
 """
+
+
+# Guard the invariants the docstrings above promise, so a future edit that
+# breaks them fails at import time instead of silently drifting until a test
+# happens to catch it (same rationale as prefixes.py). Note `assert` is
+# stripped under `python -O`; Lexicon re-checks the relationships at
+# construction, which is what protects a caller's own vocabulary.
+assert SUFFIX_ACRONYMS_AMBIGUOUS <= SUFFIX_ACRONYMS, \
+    "SUFFIX_ACRONYMS_AMBIGUOUS must stay a subset of SUFFIX_ACRONYMS"
+assert not (SUFFIX_ACRONYMS & SUFFIX_NOT_ACRONYMS), \
+    "a suffix is an acronym or a word, not both: " \
+    f"{sorted(SUFFIX_ACRONYMS & SUFFIX_NOT_ACRONYMS)}"
+# Entries are looked up in normalized form, so a stray capital or a
+# trailing space makes an entry unreachable by direct membership test even
+# though the parser's own ingest would paper over it.
+assert all(w == w.strip().lower() for w in SUFFIX_ACRONYMS | SUFFIX_NOT_ACRONYMS), \
+    "suffix entries must be stored lowercase and whitespace-free"

nameparser/config/titles.py

@@ -89,7 +89,7 @@
     'academic',
     'acolyte',
     'activist',
-    'actor ',
+    'actor',
     'actress',
     'adept',
     'adjutant',
@@ -664,7 +664,7 @@
     'teacher',
     'technical',
     'technologist',
-    'television ',
+    'television',
     'tenor',
     'theater',
     'theatre',
@@ -770,3 +770,19 @@
     'श्रीमती',     # Shrimati (Mrs.)
     'डॉ',         # Dr. abbreviation
 }
+
+
+# Guard the invariants at import time, so a bad edit fails here instead of
+# drifting silently until a test happens to catch it (see prefixes.py).
+# The subset rule holds by construction today -- TITLES is defined as
+# FIRST_NAME_TITLES | {...} -- so this pins it against a future edit that
+# makes TITLES a standalone set. Lexicon enforces the same rule on
+# caller-supplied vocabulary; `assert` is stripped under `python -O`.
+assert FIRST_NAME_TITLES <= TITLES, \
+    "FIRST_NAME_TITLES must stay a subset of TITLES"
+# Entries are looked up in normalized form, so a stray capital or a
+# trailing space makes an entry unreachable by direct membership test
+# ('actor' in TITLES was False) even though the parser's own ingest
+# normalizes and papers over it. TITLES covers FIRST_NAME_TITLES.
+assert all(w == w.strip().lower() for w in TITLES), \
+    "TITLES entries must be stored lowercase and whitespace-free"