Add surnames attribute as aggregate of middle and last names

Author: derek73

docs/release_log.rst

@@ -2,6 +2,7 @@ Release Log
 ===========
 * 1.0.1 - August 30, 2018
     - Fix overzealous regex for "Ph. D." (#43)
+    - Add `surnames` attribute as aggregate of middle and last names
 * 1.0.0 - August 30, 2018
     - Fix support for nicknames in single quotes (#74)
     - Change prefix handling to support prefixes on first names (#60)

nameparser/parser.py

@@ -243,7 +243,21 @@ def nickname(self):
         parenthesis (``()``)
         """
         return " ".join(self.nickname_list) or self.C.empty_attribute_default
-    
+
+    @property
+    def surnames_list(self):
+        """
+        List of middle names followed by last name.
+        """
+        return self.middle_list + self.last_list
+
+    @property
+    def surnames(self):
+        """
+        A string of all middle names followed by the last name.
+        """
+        return " ".join(self.surnames_list) or self.C.empty_attribute_default
+
     ### setter methods
 
     def _set_list(self, attr, value):

tests.py

@@ -188,6 +188,14 @@ def test_blank_name(self):
         self.m(hn.first, "", hn)
         self.m(hn.last, "", hn)
 
+    def test_surnames_list_attribute(self):
+        hn = HumanName("John Edgar Casey Williams III")
+        self.m(hn.surnames_list, ["Edgar", "Casey", "Williams"], hn)
+
+    def test_surnames_attribute(self):
+        hn = HumanName("John Edgar Casey Williams III")
+        self.m(hn.surnames, "Edgar Casey Williams", hn)
+
 
 class FirstNameHandlingTests(HumanNameTestBase):
     def test_first_name(self):
@@ -1438,7 +1446,6 @@ def test_parenthesis_and_quotes_together(self):
         self.m(hn.nickname, "Jen Duff", hn)
 
 
-
 class PrefixesTestCase(HumanNameTestBase):
 
     def test_prefix(self):