nominally 1.0.0

A maximum-strength name parser for record linkage.

nominally: a maximum-strength name parser for record linkage

🖥️ Examples

Run a quick name at the command line:

$ nominally "Jimmy Blankinsop"
       raw: Jimmy Blankinsop
   cleaned: jimmy blankinsop
    parsed: blankinsop, jimmy
      list: ['', 'jimmy', '', 'blankinsop', '', '']
     title:
     first: jimmy
    middle:
      last: blankinsop
    suffix:
  nickname:

Pull out the major parts...

$ python -q
>>> from nominally import parse_name
>>> parse_name("Blankinsop, Jr., Mr. James 'Jimmy'")
{
  'title': 'mr',
  'first': 'james',
  'middle': '',
  'last': 'blankinsop',
  'suffix': 'jr',
  'nickname': 'jimmy'
}

Or separate into individual parts; complete string; lists; dicts...

$ python -q
>>> from nominally import Name
>>> n = Name("DR. PEACHES BARTKOWICZ")
>>> n
Name({'title': 'dr', 'first': 'peaches', 'middle': '', 'last': 'bartkowicz', 'suffix': '', 'nickname': ''})
>>> str(n)
'dr peaches bartkowicz'
>>> dict(n)
{
  'title': 'dr',
  'first': 'peaches',
  'middle': '',
  'last': 'bartkowicz',
  'suffix': '',
  'nickname': ''
}
>>> list(n.values())
['dr', 'peaches', '', 'bartkowicz', '', '']
>>> n.first
'peaches'
>>> n.last
'bartkowicz'
>>> n.raw
'DR. PEACHES BARTKOWICZ'
>>> n.report()
{
  'raw': 'DR. PEACHES BARTKOWICZ',
  'cleaned': 'dr peaches bartkowicz',
  'parsed': 'bartkowicz, dr peaches',
  'list': ['dr', 'peaches', '', 'bartkowicz', '', ''],
  'title': 'dr',
  'first': 'peaches',
  'middle': '',
  'last': 'bartkowicz',
  'suffix': '',
  'nickname': ''
}

🔬 Elaborate Examples

For fully worked examples, see: https://github.com/vaneseltine/nominally-examples/

🧙‍ Author

🎓 Beginnings

Nominally started as a fork of the python-nameparser package, and has benefitted considerably from this origin⸺especially the testing foundation.