Skip to content

Normalize HumanName repr indentation and trailing whitespace #212

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
derek73 merged 1 commit into from
Jul 4, 2026
+102 −102
Merged

Normalize HumanName repr indentation and trailing whitespace #212

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,13 +69,13 @@ Quick Start Example
>>> name = HumanName("Dr. Juan Q. Xavier de la Vega III (Doc Vega)")
>>> name
<HumanName : [
title: 'Dr.'
first: 'Juan'
middle: 'Q. Xavier'
last: 'de la Vega'
suffix: 'III'
nickname: 'Doc Vega'
maiden: ''
title: 'Dr.'
first: 'Juan'
middle: 'Q. Xavier'
last: 'de la Vega'
suffix: 'III'
nickname: 'Doc Vega'
maiden: ''
]>
>>> name.last
'de la Vega'
Expand All @@ -99,13 +99,13 @@ and "post-nominal" would probably be better names.)
>>> name = HumanName("1 & 2, 3 4 5, Mr.")
>>> name
<HumanName : [
title: ''
first: '3'
middle: '4 5'
last: '1 & 2'
suffix: 'Mr.'
nickname: ''
maiden: ''
title: ''
first: '3'
middle: '4 5'
last: '1 & 2'
suffix: 'Mr.'
nickname: ''
maiden: ''
]>

Customization
Expand Down
84 changes: 42 additions & 42 deletions docs/customize.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -348,27 +348,27 @@ constant so that "Hon" can be parsed as a first name.
>>> hn = HumanName("Hon Solo")
>>> hn
<HumanName : [
title: 'Hon'
first: ''
middle: ''
last: 'Solo'
suffix: ''
nickname: ''
maiden: ''
title: 'Hon'
first: ''
middle: ''
last: 'Solo'
suffix: ''
nickname: ''
maiden: ''
]>
>>> from nameparser.config import CONSTANTS
>>> CONSTANTS.titles.remove('hon')
SetManager({'right', ..., 'tax'})
>>> hn = HumanName("Hon Solo")
>>> hn
<HumanName : [
title: ''
first: 'Hon'
middle: ''
last: 'Solo'
suffix: ''
nickname: ''
maiden: ''
title: ''
first: 'Hon'
middle: ''
last: 'Solo'
suffix: ''
nickname: ''
maiden: ''
]>


Expand Down Expand Up @@ -403,13 +403,13 @@ making them lower case and removing periods.
>>> hn = HumanName("Assoc Dean of Chemistry Robert Johns", constants=constants)
>>> hn
<HumanName : [
title: 'Assoc Dean of Chemistry'
first: 'Robert'
middle: ''
last: 'Johns'
suffix: ''
nickname: ''
maiden: ''
title: 'Assoc Dean of Chemistry'
first: 'Robert'
middle: ''
last: 'Johns'
suffix: ''
nickname: ''
maiden: ''
]>


Expand All @@ -431,13 +431,13 @@ the config on one instance could modify the behavior of another instance.
>>> other_instance = HumanName("Dean Robert Johns")
>>> other_instance # Dean parses as title
<HumanName : [
title: 'Dean'
first: 'Robert'
middle: ''
last: 'Johns'
suffix: ''
nickname: ''
maiden: ''
title: 'Dean'
first: 'Robert'
middle: ''
last: 'Johns'
suffix: ''
nickname: ''
maiden: ''
]>


Expand All @@ -459,13 +459,13 @@ reference to the module-level config values with the behavior described above.
>>> other_instance = HumanName("Dean Robert Johns", None) # <-- pass None for per-instance config
>>> other_instance
<HumanName : [
title: ''
first: 'Dean'
middle: 'Robert'
last: 'Johns'
suffix: ''
nickname: ''
maiden: ''
title: ''
first: 'Dean'
middle: 'Robert'
last: 'Johns'
suffix: ''
nickname: ''
maiden: ''
]>
>>> other_instance.has_own_config
True
Expand Down Expand Up @@ -531,13 +531,13 @@ directly to the attribute.
>>> hn.suffix = "Md."
>>> hn.suffix
<HumanName : [
title: 'Associate Processor'
first: 'John'
middle: 'A. Kenneth'
last: 'Doe'
suffix: 'Md.'
nickname: ''
maiden: ''
title: 'Associate Processor'
first: 'John'
middle: 'A. Kenneth'
last: 'Doe'
suffix: 'Md.'
nickname: ''
maiden: ''
]>


Expand Down
78 changes: 39 additions & 39 deletions docs/usage.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,23 +34,23 @@ Requires Python 3.10+.
>>> name.full_name = "Juan Q. Xavier Velasquez y Garcia, Jr."
>>> name
<HumanName : [
title: ''
first: 'Juan'
middle: 'Q. Xavier'
last: 'Velasquez y Garcia'
suffix: 'Jr.'
nickname: ''
maiden: ''
title: ''
first: 'Juan'
middle: 'Q. Xavier'
last: 'Velasquez y Garcia'
suffix: 'Jr.'
nickname: ''
maiden: ''
]>
>>> name.middle = "Jason Alexander"
>>> name.middle
'Jason Alexander'
>>> name
<HumanName : [
title: ''
first: 'Juan'
middle: 'Jason Alexander'
last: 'Velasquez y Garcia'
title: ''
first: 'Juan'
middle: 'Jason Alexander'
last: 'Velasquez y Garcia'
suffix: 'Jr.'
nickname: ''
maiden: ''
Expand Down Expand Up @@ -139,13 +139,13 @@ available from the nickname attribute.
>>> name = HumanName('Jonathan "John" A. Smith')
>>> name
<HumanName : [
title: ''
first: 'Jonathan'
middle: 'A.'
last: 'Smith'
suffix: ''
nickname: 'John'
maiden: ''
title: ''
first: 'Jonathan'
middle: 'A.'
last: 'Smith'
suffix: ''
nickname: 'John'
maiden: ''
]>

Exception: content that looks like a suffix (a member of
Expand All @@ -161,13 +161,13 @@ written in parenthesis.
>>> name = HumanName('Andrew Perkins (MBA)')
>>> name
<HumanName : [
title: ''
first: 'Andrew'
middle: ''
last: 'Perkins'
suffix: 'MBA'
nickname: ''
maiden: ''
title: ''
first: 'Andrew'
middle: ''
last: 'Perkins'
suffix: 'MBA'
nickname: ''
maiden: ''
]>

A few suffix acronyms, listed in
Expand All @@ -182,13 +182,13 @@ reading in that ambiguous context:
>>> name = HumanName('JEFFREY (JD) BRICKEN')
>>> name
<HumanName : [
title: ''
first: 'JEFFREY'
middle: ''
last: 'BRICKEN'
suffix: ''
nickname: 'JD'
maiden: ''
title: ''
first: 'JEFFREY'
middle: ''
last: 'BRICKEN'
suffix: ''
nickname: 'JD'
maiden: ''
]>

Leading Period-Abbreviation Titles
Expand All @@ -208,13 +208,13 @@ word appearing after the first name is left as a middle name.
>>> name = HumanName("Major. Dona Smith")
>>> name
<HumanName : [
title: 'Major.'
first: 'Dona'
middle: ''
last: 'Smith'
suffix: ''
nickname: ''
maiden: ''
title: 'Major.'
first: 'Dona'
middle: ''
last: 'Smith'
suffix: ''
nickname: ''
maiden: ''
]>
>>> name = HumanName("J. Smith")
>>> name.first
Expand Down
14 changes: 7 additions & 7 deletions nameparser/parser.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -209,13 +209,13 @@ def __repr__(self) -> str:
_string = f"<{self.__class__.__name__} : [ Unparsable ] >"
else:
attrs = (
f"\ttitle: {self.title or ''!r} \n"
f"\tfirst: {self.first or ''!r} \n"
f"\tmiddle: {self.middle or ''!r} \n"
f"\tlast: {self.last or ''!r} \n"
f"\tsuffix: {self.suffix or ''!r}\n"
f"\tnickname: {self.nickname or ''!r}\n"
f"\tmaiden: {self.maiden or ''!r}"
f" title: {self.title or ''!r}\n"
f" first: {self.first or ''!r}\n"
f" middle: {self.middle or ''!r}\n"
f" last: {self.last or ''!r}\n"
f" suffix: {self.suffix or ''!r}\n"
f" nickname: {self.nickname or ''!r}\n"
f" maiden: {self.maiden or ''!r}"
)
_string = f"<{self.__class__.__name__} : [\n{attrs}\n]>"
return _string
Expand Down