fix: .get() on the regexes proxy is no longer swallowed by __getattr__

1.4's #256 deprecation told users ".get() remains available for
intentional soft access". On CONSTANTS.capitalization_exceptions that
holds -- TupleManager subclasses dict, so .get() comes for free. The
regexes proxy is not a dict, and its catch-all __getattr__ claimed the
name `get` as a regex lookup, so the escape hatch the deprecation
message pointed at raised AttributeError instead.

Define get() explicitly, with dict.get semantics.

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

Author: derek73

nameparser/_config_shim.py

@@ -524,6 +524,12 @@ def __iter__(self) -> Iterator[str]:
     def keys(self) -> KeysView[str]:
         return self._regexes().keys()
 
+    def get(self, name: str, default: object = None) -> object:
+        # Defined explicitly because __getattr__ would otherwise claim
+        # `get` as a regex name. The sibling managers inherit this from
+        # dict; #256's deprecation text promised it on both.
+        return self._regexes().get(name, default)
+
     def __setattr__(self, name: str, value: object) -> None:
         self._raise_readonly(name)
 

tests/v2/test_config_shim.py

@@ -11,6 +11,7 @@
     CONSTANTS, Constants, SetManager, TupleManager, _DelimiterManager,
     _RegexesProxy, _cached_parser,
 )
+from nameparser.config.regexes import EMPTY_REGEX, REGEXES
 
 _DATA_DIR = Path(__file__).parent / "data"
 
@@ -195,6 +196,17 @@ def test_regexes_membership_iteration_and_deepcopy() -> None:
     assert isinstance(copy.deepcopy(r), _RegexesProxy)
 
 
+def test_regexes_get_is_the_soft_access_escape_hatch() -> None:
+    # 1.4's #256 deprecation told users ".get() remains available for
+    # intentional soft access"; __getattr__ must not swallow `get`
+    # itself. capitalization_exceptions inherits it from dict -- the
+    # regexes proxy is not a dict, so it has to say so explicitly.
+    r = _RegexesProxy()
+    assert r.get("word") is REGEXES["word"]
+    assert r.get("typo") is None
+    assert r.get("typo", EMPTY_REGEX) is EMPTY_REGEX
+
+
 def test_constants_default_fields_present() -> None:
     c = Constants()
     assert "dr" in c.titles