User.full_name convinience property (python-telegram-bot#949)

graynk · tsnoam · commit d347c0d45e6a · 2017-12-30T15:13:06.000+02:00
Fixes python-telegram-bot#943
diff --git a/telegram/user.py b/telegram/user.py
@@ -83,6 +83,17 @@ def name(self):
             return '%s %s' % (self.first_name, self.last_name)
         return self.first_name
 
+    @property
+    def full_name(self):
+        """
+        :obj:`str`: The users :attr:`first_name` and if present :attr:`last_name`.
+
+        """
+
+        if self.last_name:
+            return '%s %s' % (self.first_name, self.last_name)
+        return self.first_name
+
     @classmethod
     def de_json(cls, data, bot):
         if not data:
diff --git a/tests/test_user.py b/tests/test_user.py
@@ -90,6 +90,11 @@ def test_name(self, user):
         assert user.name == 'first_name'
         user.username = self.username
         assert user.name == '@username'
+    
+    def test_full_name(self, user):
+        assert user.full_name == 'first_name last_name'
+        user.last_name = None
+        assert user.full_name == 'first_name'
 
     def test_get_profile_photos(self, monkeypatch, user):
         def test(_, *args, **kwargs):
