corp-names 0.1.0

Person name normalization: strip titles, suffixes, resolve nicknames to canonical forms

corp-names

Person name normalization library. Strips titles, suffixes, middle initials, and resolves nicknames to canonical forms.

Installation

pip install corp-names

Usage

from corp_names import normalize_name

result = normalize_name("Dr. Bob Smith Jr.")
print(result.normalized)  # "robert smith"
print(result.first)       # "robert"
print(result.last)        # "smith"
print(result.prefix)      # "dr"
print(result.suffix)      # "jr"

CLI

corp-names normalize "Dr. Bob Smith Jr."
# Original:   Dr. Bob Smith Jr.
# Normalized: robert smith
# First:      robert
# Last:       smith
# Prefix:     dr
# Suffix:     jr
# Nickname:   resolved to canonical form

corp-names normalize "Sir William H. Gates III" --json

Normalization Pipeline

1. Unicode normalize (unidecode for accented characters)
2. Strip punctuation (remove periods, commas; preserve hyphens)
3. Tokenize by whitespace
4. Strip prefixes (titles, honorifics)
5. Strip suffixes (generational, credentials)
6. Remove middle initials (single-letter tokens)
7. Resolve nicknames to canonical forms
8. Build normalized lowercase output

NormalizedName Model

class NormalizedName(BaseModel):
    original: str            # Original input
    normalized: str          # Full normalized lowercase name
    first: str               # First/given name (after nickname resolution)
    last: str                # Last/family name
    prefix: str              # Detected prefix(es), e.g. "dr"
    suffix: str              # Detected suffix(es), e.g. "jr"
    nickname_resolved: bool  # Whether first name was a nickname

Data

• Prefixes: ~150 titles and honorifics (military, religious, nobility, academic, political)
• Suffixes: ~600 credentials, generational markers, and honors (PhD, Jr, III, OBE, CPA)
• Nicknames: ~400 curated nickname-to-canonical mappings (bob→robert, liz→elizabeth, peggy→margaret)

All data is embedded as Python literals with no runtime dependency on external packages or files.

License

MIT