Metadata-Version: 1.1
Name: name-cleaver
Version: 0.5.2
Summary: Name parser and formatter (for politicians, individuals, and organizations)
Home-page: http://github.com/sunlightlabs/name-cleaver/
Author: Alison Rowland
Author-email: arowland@sunlightfoundation.com
License: BSD License
Description: 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.
        
        
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Environment :: Web Environment
Classifier: Topic :: Text Processing :: Linguistic
