name-cleaver
pypi i name-cleaver

name-cleaver

Parser and standardizer for politician, individual and organization names.

by sunlightlabs

0.6.0 (see all)License:BSD License
pypi i name-cleaver
Readme

This is the name parser and standardizer for the datacommons project. It now supports politician, individual and organization names.

Installation

Installation is easy:

pip install name-cleaver

Usage

Basic usage is the same for each type of name, just import the relevant NameCleaver class from one of:

  • PoliticianNameCleaver
  • IndividualNameCleaver
  • OrganizationNameCleaver

Example:

from name_cleaver import PoliticianNameCleaver
smith = PoliticianNameCleaver('Smith, Robert J').parse()

smith.first => "Robert"
smith.middle => "J."
smith.last => "Smith"

print str(smith) => "Robert J. Smith"

Usage as above can usually be expected to return a Name object, but is not guaranteed to not throw an exception if NameCleaver is given unexpected input or otherwise can't figure out what to do with a name. You can look for and handle Name Cleaver's UnparseableNameException class. If you don't want to deal with handling exceptions, NameCleaver has a safe mode:

smith = PoliticianNameCleaver('Smith, Robert J').parse(safe=True)

In safe mode, if NameCleaver encounters an exception or doesn't come up with a fully-formed name, it will return the original input string.

GitHub Stars

119

LAST COMMIT

6yrs ago

MAINTAINERS

1

CONTRIBUTORS

8

OPEN ISSUES

3

OPEN PRs

2
VersionTagPublished
0.6.0
9yrs ago
0.5.2
9yrs ago
0.5.1
9yrs ago
0.5.0
10yrs ago
No alternatives found
No tutorials found
Add a tutorial