Additional nickname delimiter specifications #110

Activity

1. derek73

   added

   enhancement

   on Aug 9, 2020
2. derek73 commented on Aug 9, 2020

   

   derek73

   on Aug 9, 2020

   Owner

   More actions

   This seems like a good idea and not too hard to do.
3. derek73 commented on Jul 1, 2026

   

   derek73

   on Jul 1, 2026

   Owner

   More actions

   Thanks for the detailed writeup! Rather than patching regexes.py/parser.py directly (which meant re-forking on every upgrade), as of v1.3.0 there's a supported extension point for exactly this: Constants.extra_nickname_delimiters, added in #190. It's a dict of extra regex patterns that parse_nicknames() runs after the three built-in delimiters (quotes, double quotes, parens), so you can register your patterns at runtime without touching the library source:

   import re
   from nameparser import HumanName
   
   hn = HumanName("John ''Big J'' Smith", constants=None)
   hn.C.extra_nickname_delimiters['double_apos'] = re.compile(r"''(.*?)''")
   hn.C.extra_nickname_delimiters['apos'] = re.compile(r"'(.*?)'")
   hn.parse_full_name()
   
   hn.nickname  # 'Big J'

   Note constants=None gives this HumanName instance its own Constants copy so the change doesn't leak into other instances/threads; if you want it applied globally, register on nameparser.config.CONSTANTS instead.

   These custom patterns go through the same suffix-vs-nickname disambiguation as the built-ins, so something like (Ret) still won't get swallowed as a nickname.

   This shipped in #190 and will be part of the v1.3.0 release. Closing this out — let me know if the new hook doesn't cover your case.
4. derek73

   closed this as completedon Jul 1, 2026
5. derek73

   self-assigned this

   on Jul 1, 2026
6. derek73

   added this to the v1.3.0 milestone on Jul 1, 2026
7. derek73

   added a commit that references this issue on Jul 3, 2026

   docs: add missing v1.3.0 changelog entries for #100, #166, #187, #188, …

   ...

   ddaaa07