Package: nameparser
A simple Python (3.2+ & 2.6+) module for parsing human names into their
individual components.hn.titlehn.firsthn.middlehn.lasthn.suffixhn.nicknamehn.surnames(middle + last)hn.initials(first initial of each name part)Supported Name StructuresThe supported name structure is generally “Title First Middle Last Suffix”, where all pieces
are optional. Comma-separated format like “Last, First” is also supported.Title Firstname “Nickname” Middle Middle Lastname SuffixLastname [Suffix], Title Firstname (Nickname) Middle Middle[,] Suffix [, Suffix]Title Firstname M Lastname [Suffix], Suffix [Suffix] [, Suffix]Instantiating theHumanNameclass with a string splits on commas and then spaces,
classifying name parts based on placement in the string and matches against known name
pieces like titles and suffixes.It correctly handles some common conjunctions and special prefixes to last names
like “del”. Titles and conjunctions can be chained together to handle complex
titles like “Asst Secretary of State”. It can also try to correct capitalization
of names that are all upper- or lowercase names.It attempts the best guess that can be made with a simple, rule-based approach.
Its main use case is English and it is not likely to be useful for languages
that do not conform to the supported name structure. It’s not perfect, but it
gets you pretty far.Installationpip install nameparserIf you want to try out the latest code from GitHub you can
install with pip using the command below.pip install-egit+git://github.com/derek73/python-nameparser.git#egg=nameparserIf you need to handle lists of names, check outnamesparser, a
compliment to this module that handles multiple names in a string.Quick Start Example>>> from nameparser import HumanName
>>> name = HumanName("Dr. Juan Q. Xavier de la Vega III (Doc Vega)")
>>> name
<HumanName : [
    title: 'Dr.'
    first: 'Juan'
    middle: 'Q. Xavier'
    last: 'de la Vega'
    suffix: 'III'
    nickname: 'Doc Vega'
]>
>>> name.last
'de la Vega'
>>> name.as_dict()
{'last': 'de la Vega', 'suffix': 'III', 'title': 'Dr.', 'middle': 'Q. Xavier', 'nickname': 'Doc Vega', 'first': 'Juan'}
>>> str(name)
'Dr. Juan Q. Xavier de la Vega III (Doc Vega)'
>>> name.string_format = "{first} {last}"
>>> str(name)
'Juan de la Vega'The parser does not attempt to correct mistakes in the input. It mostly just splits on white
space and puts things in buckets based on their position in the string. This also means
the difference between ‘title’ and ‘suffix’ is positional, not semantic. “Dr” is a title
when it comes before the name and a suffix when it comes after. (“Pre-nominal”
and “post-nominal” would probably be better names.)>>> name = HumanName("1 & 2, 3 4 5, Mr.")
>>> name
<HumanName : [
    title: ''
    first: '3'
    middle: '4 5'
    last: '1 & 2'
    suffix: 'Mr.'
    nickname: ''
]>CustomizationYour project may need some adjustment for your dataset. You can
do this in your own pre- or post-processing, bycustomizing the configured pre-defined
setsof titles, prefixes, etc., or by subclassing theHumanNameclass. See thefull documentationfor more information.Full documentationContributingIf you come across name piece that you think should be in the default config, you’re
probably right.Start a New Issueand we can get them added.Please let me know if there are ways this library could be structured to make
it easier for you to use in your projects. ReadCONTRIBUTING.mdfor more info
on running the tests and contributing to the project.GitHub Projecthttps://github.com/derek73/python-nameparser