Skip to main content

Library for manipulating and comparing (English) names

Project description

A Python library for manipulating and comparing English, Western-style personal names.

Released under a BSD-style license.



To install from PyPI run

pip install name_tools


easy_install name_tools

To install from a source package run

python install


name_tools.split(name) breaks a name into 4 (possibly empty) parts, representing prefixes (‘Mr.’, ‘Dr.’, etc.), a ‘first part’ (given names, middle names, middle initials), a last name, and suffixes (‘Jr.’, ‘III’, ‘Ph.D’, etc.)

>>> import name_tools
>>> name_tools.split("President Barack Hussein Obama II")
('President', 'Barack Hussein', 'Obama', 'II')
>>> name_tools.split("Obama, President Barack H., II")
('President', 'Barack H', 'Obama', 'II')
>>> name_tools.split("Fleet Admiral William Frederick Halsey, Jr., USN")
('Fleet Admiral', 'William Frederick', 'Halsey', 'Jr., USN')
>>> name_tools.split("Dick van Dyke")
('', 'Dick', 'van Dyke', '')

name_tools.canonicalize(name) returns a name in a canonical format: ‘Prefixes First Last, Suffixes’, with extra spaces removed and words capitalized.

>>> name_tools.canonicalize('  WASHBURNE,  zoe alleyne')
'Zoe Alleyne Washburne'
>>> name_tools.canonicalize('DR. simon tam')
'Dr. Simon Tam'
>>> name_tools.canonicalize(' thurston b. howell iii')
'Thurston B. Howell, III'

name_tools.match(name1, name2) provides a measure of the similarity between two name, considering factors such as differing word order (‘Bond, James’ and ‘James Bond’), use of initials (‘J. R. R. Tolkien’ and ‘John Ronald Reuel Tolkien’) and various titles and honorifics (‘Fleet Admiral William Frederick Halsey, Jr., USN’, and ‘William Frederick Halsey’).

>>> name_tools.match('Eric Schmidt', 'Eric Schmidt')
>>> name_tools.match('Bob Dole', 'Dole, Bob')
>>> name_tools.match("Mr. X", "X")
>>> name_tools.match('Jeff Tweedy', 'J Tweedy')
>>> name_tools.match('Ferris Bueller', 'Bueller')
>>> name_tools.match('John Smith', 'John Johnson')

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for name_tools, version 0.1.3
Filename, size File type Python version Upload date Hashes
Filename, size name_tools-0.1.3.tar.gz (7.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page