Nameparser

Warnings

• breaking The `full_name` attribute's behavior changed. Before v1.0.4, it returned the original input string. Since v1.0.4, it returns a formatted string output based on the parsed components.
  Fix: If you relied on `full_name` returning the exact original string, store the original string separately or adjust your code to expect the formatted output.
• breaking Version 1.0.0 introduced significant refactoring of prefix handling and support for prefixes on first names, which may alter parsing results for certain names compared to older versions.
  Fix: Thoroughly test parsing outcomes for a representative set of names if upgrading from pre-1.0.0 versions to ensure consistent results.
• gotcha If you customize the parser's constants (e.g., adding new titles, prefixes, suffixes) after a `HumanName` instance has been created or its `full_name` attribute set, you must explicitly call `name.parse_full_name()` to re-parse the name and apply the new configurations.
  Fix: Call `name_instance.parse_full_name()` after modifying constants that affect parsing or ensure constants are configured before instantiation/first parsing.
• gotcha By default, `HumanName` will not adjust the capitalization of names that are already in mixed case. It primarily corrects all upper or all lower case names.
  Fix: To force capitalization of mixed-case names, use `name.capitalize(force=True)` or set `nameparser.config.CONSTANTS.force_mixed_case_capitalization = True` globally.
• gotcha The library is primarily designed for English names. While it can be useful for other Latin-based languages, it may not perform optimally for languages with significantly different name structures without custom configuration.
  Fix: For non-English names, consider customizing `nameparser.config.Constants` with language-specific titles, prefixes, and suffixes, or evaluate alternative libraries if primary use is non-Latin or non-English.

Install

• pip install nameparser Install stable version

Imports

• HumanName

  from nameparser import HumanName

Quickstart

Parses a full name string into a `HumanName` object, allowing access to its individual components as attributes like `title`, `first`, `middle`, `last`, `suffix`, and `nickname`.

from nameparser import HumanName

name = HumanName("Dr. Juan Q. Xavier de la Vega III (Doc Vega)")

print(f"Title: {name.title}")
print(f"First: {name.first}")
print(f"Middle: {name.middle}")
print(f"Last: {name.last}")
print(f"Suffix: {name.suffix}")
print(f"Nickname: {name.nickname}")
print(f"Full Name (formatted): {name}")