Python Human Name Parser

Version 2.0.0rc1

nameparser parses human names into seven fields — title, given, middle, family, suffix, nickname, maiden. Results are immutable, configuration is composable (Lexicon for vocabulary, Policy for behavior), and locale packs are opt-in. Requires Python 3.11+.

>>> from nameparser import parse
>>> name = parse("Dr. Juan Q. Xavier de la Vega III")
>>> name.given, name.family
('Juan', 'de la Vega')
>>> name.render("{family}, {given}")
'de la Vega, Juan'

Coming from 1.x? Migrating from HumanName.

• Using the parser
  • Parse a name
  • Input shapes
  • Words that attach to their neighbors
  • Aggregate views
  • Dicts and strings
  • Fixing case
  • Nicknames and maiden names
  • Titles you didn’t configure
  • Comparing names
  • When the parser had to guess
  • Tokens and spans
  • Correcting a parse
  • Command line
  • Where next
• How the parser works
  • From string to name
  • Two layers decide the roles
  • Configuration lives in three containers
  • Parsers are values
  • Honest ambiguity
• Customizing the parser
  • Vocabulary: Lexicon
  • Behavior: Policy
  • Presentation: rendering arguments
  • Sharing a configured parser
• Locale packs
  • What works without a pack
  • Using a pack
  • Creating your own Locale
  • Contributing a pack to nameparser
• Migrating from HumanName
  • Before you upgrade
  • Attribute map
  • Config map
  • Comparison
  • Behavior changes
• API reference
  • The 2.0 API
  • 1.x compatibility layer
• Release Log
• Naming Practices and Resources
• Contributing

Indices and tables

• Index

• Module Index

• Search Page

GitHub Project: https://github.com/derek73/python-nameparser