add support for name parts in the constructor, fix #140

Author: derek73

docs/release_log.rst

@@ -1,5 +1,7 @@
 Release Log
 ===========
+* 1.1.2 - November 13, 2022
+    - Add support for attributes in constructor (#140)
 * 1.1.1 - January 28, 2022
     - Fix bug in is_suffix handling of lists (#129)
 * 1.1.0 - January 3, 2022

nameparser/__init__.py

@@ -1,4 +1,4 @@
-VERSION = (1, 1, 1)
+VERSION = (1, 1, 2)
 __version__ = '.'.join(map(str, VERSION))
 __author__ = "Derek Gulbranson"
 __author_email__ = '[email protected]'

nameparser/parser.py

@@ -36,7 +36,10 @@ class HumanName(object):
 
     Instantiation assigns to ``full_name``, and assignment to
     :py:attr:`full_name` triggers :py:func:`parse_full_name`. After parsing the
-    name, these instance attributes are available.
+    name, these instance attributes are available. Alternatively, you can pass 
+    any of the instance attributes to the constructor method and skip the parsing
+    process. If any of the the instance attributes are passed to the constructor 
+    as keywords, :py:func:`parse_full_name` will not be performed. 
 
     **HumanName Instance Attributes**
 
@@ -56,6 +59,12 @@ class HumanName(object):
     :param str string_format: python string formatting
     :param str initials_format: python initials string formatting
     :param str initials_delimter: string delimiter for initials
+    :param str first: first name
+    :param str middle: middle name
+    :param str last: last name
+    :param str title: The title or prenominal
+    :param str suffix: The suffix or postnominal
+    :param str nickname: Nicknames
     """
 
     C = CONSTANTS
@@ -77,7 +86,9 @@ class HumanName(object):
     _full_name = ''
 
     def __init__(self, full_name="", constants=CONSTANTS, encoding=DEFAULT_ENCODING,
-                 string_format=None, initials_format=None, initials_delimiter=None):
+                 string_format=None, initials_format=None, initials_delimiter=None,
+                 first=None, middle=None, last=None, title=None, suffix=None,
+                 nickname=None):
         self.C = constants
         if type(self.C) is not type(CONSTANTS):
             self.C = Constants()
@@ -86,8 +97,17 @@ def __init__(self, full_name="", constants=CONSTANTS, encoding=DEFAULT_ENCODING,
         self.string_format = string_format or self.C.string_format
         self.initials_format = initials_format or self.C.initials_format
         self.initials_delimiter = initials_delimiter or self.C.initials_delimiter
-        # full_name setter triggers the parse
-        self.full_name = full_name
+        if (first or middle or last or title or suffix or nickname):
+            self.first = first
+            self.middle = middle
+            self.last = last
+            self.title = title
+            self.suffix = suffix
+            self.nickname = nickname
+            self.unparsable = False
+        else:
+            # full_name setter triggers the parse
+            self.full_name = full_name
 
     def __iter__(self):
         return self

tests.py

@@ -2343,7 +2343,44 @@ def test_initials_with_prefix_firstname(self):
     def test_initials_with_prefix(self):
         hn = HumanName("Alex van Johnson")
         self.m(hn.initials_list(), ["A", "J"], hn)
-
+        
+    def test_constructor_first(self):
+        hn = HumanName(first="TheName")
+        self.assertFalse(hn.unparsable)
+        self.m(hn.first, "TheName", hn)
+    
+    def test_constructor_middle(self):
+        hn = HumanName(middle="TheName")
+        self.assertFalse(hn.unparsable)
+        self.m(hn.middle, "TheName", hn)
+
+    def test_constructor_last(self):
+        hn = HumanName(last="TheName")
+        self.assertFalse(hn.unparsable)
+        self.m(hn.last, "TheName", hn)
+
+    def test_constructor_title(self):
+        hn = HumanName(title="TheName")
+        self.assertFalse(hn.unparsable)
+        self.m(hn.title, "TheName", hn)
+
+    def test_constructor_suffix(self):
+        hn = HumanName(suffix="TheName")
+        self.assertFalse(hn.unparsable)
+        self.m(hn.suffix, "TheName", hn)
+
+    def test_constructor_nickname(self):
+        hn = HumanName(nickname="TheName")
+        self.assertFalse(hn.unparsable)
+        self.m(hn.nickname, "TheName", hn)
+
+    def test_constructor_multiple(self):
+        hn = HumanName(first="TheName", last="lastname", title="mytitle", full_name="donotparse")
+        self.assertFalse(hn.unparsable)
+        self.m(hn.first, "TheName", hn)
+        self.m(hn.last, "lastname", hn)
+        self.m(hn.title, "mytitle", hn)
+    
 
 TEST_NAMES = (
     "John Doe",