Give Constants a useful __repr__

The previous __repr__ ("<Constants() instance>") didn't identify which
instance you were looking at or how it differed from the default,
making it useless for debugging config state.

Collections (some with hundreds of entries, e.g. titles/prefixes) are
summarized as counts rather than dumped in full. Scalar config flags
are only shown when they differ from the class default, so a plain
Constants() reads as just the collection sizes. Formatted as a
bracketed multi-line block to match HumanName's __repr__ style.

Updates the two doctests in docs/customize.rst that asserted the old
repr string, using ELLIPSIS so they don't break every time a config
set's size changes.

Author: derek73

docs/customize.rst

@@ -17,8 +17,10 @@ The first is via ``from nameparser.config import CONSTANTS``.
 .. doctest::
 
     >>> from nameparser.config import CONSTANTS
-    >>> CONSTANTS
-    <Constants() instance>
+    >>> CONSTANTS  # doctest: +ELLIPSIS
+    <Constants : [
+        prefixes: ...
+    ]>
 
 The other is the ``C`` attribute of a ``HumanName`` instance, e.g.
 ``hn.C``.
@@ -27,8 +29,10 @@ The other is the ``C`` attribute of a ``HumanName`` instance, e.g.
 
     >>> from nameparser import HumanName
     >>> hn = HumanName("Dean Robert Johns")
-    >>> hn.C
-    <Constants() instance>
+    >>> hn.C  # doctest: +ELLIPSIS
+    <Constants : [
+        prefixes: ...
+    ]>
 
 Both places are usually a reference to the same shared module-level
 :py:class:`~nameparser.config.CONSTANTS` instance, depending on how you

nameparser/config/__init__.py

@@ -531,8 +531,29 @@ def suffixes_prefixes_titles(self) -> Set[str]:
             self._pst = self.prefixes | self.suffix_acronyms | self.suffix_not_acronyms | self.titles
         return self._pst
 
+    _repr_collection_attrs = (
+        'prefixes', 'suffix_acronyms', 'suffix_not_acronyms', 'titles',
+        'first_name_titles', 'conjunctions', 'bound_first_names',
+        'non_first_name_prefixes', 'suffix_acronyms_ambiguous',
+    )
+    _repr_scalar_attrs = (
+        'string_format', 'initials_format', 'initials_delimiter',
+        'initials_separator', 'suffix_delimiter', 'empty_attribute_default',
+        'capitalize_name', 'force_mixed_case_capitalization',
+        'patronymic_name_order', 'middle_name_as_last',
+    )
+
     def __repr__(self) -> str:
-        return "<Constants() instance>"
+        # Collections (some with hundreds of entries, e.g. titles/prefixes)
+        # are summarized as counts rather than dumped in full. Scalars are
+        # only shown when they differ from the class default, so a plain
+        # Constants() reads as just the collection sizes.
+        lines = [f"    {name}: {len(getattr(self, name))}" for name in self._repr_collection_attrs]
+        lines += [
+            f"    {name}: {value!r}" for name in self._repr_scalar_attrs
+            if (value := getattr(self, name)) != getattr(type(self), name)
+        ]
+        return "<Constants : [\n" + "\n".join(lines) + "\n]>"
 
     def __setstate__(self, state: Mapping[str, Any]) -> None:
         # Restore each saved attribute directly. The previous implementation

tests/test_constants.py

@@ -522,3 +522,33 @@ def test_repeated_access_is_cached(self) -> None:
             f"{cached_per_call * 1e6:.1f} us/call vs an uncached build cost of "
             f"{uncached_per_call * 1e6:.1f} us/call. Was _pst caching removed?"
         )
+
+
+class ConstantsReprTests(HumanNameTestBase):
+
+    def test_repr_reports_actual_collection_sizes(self) -> None:
+        c = Constants()
+        repr_str = repr(c)
+        for name in Constants._repr_collection_attrs:
+            self.assertIn(f"{name}: {len(getattr(c, name))}", repr_str)
+
+    def test_repr_omits_scalars_at_default_value(self) -> None:
+        c = Constants()
+        repr_str = repr(c)
+        for name in Constants._repr_scalar_attrs:
+            self.assertNotIn(name, repr_str)
+
+    def test_repr_shows_scalar_override(self) -> None:
+        c = Constants(middle_name_as_last=True)
+        self.assertIn("middle_name_as_last: True", repr(c))
+
+    def test_repr_reflects_mutated_collection_size(self) -> None:
+        c = Constants()
+        before = len(c.titles)
+        c.titles.add('a-brand-new-title-for-repr-test')
+        self.assertIn(f"titles: {before + 1}", repr(c))
+
+    def test_repr_is_bracketed_multiline(self) -> None:
+        repr_str = repr(Constants())
+        self.assertTrue(repr_str.startswith("<Constants : [\n"))
+        self.assertTrue(repr_str.endswith("\n]>"))