Latest commit 48d3838
Oct 10, 2016
|Failed to load latest commit information.|
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.