[qatl] added method named 'tl.ping'

README.rst

@@ -254,3 +254,9 @@ Usage ( *XMLRPC* )
 
 * **XMLRPC**: *call to method named* '*tl.sayHello*'
 * **Description** : get **'Hello!'** message
+
+**api_ping**
++++++++++++++++++++++++
+
+* **XMLRPC**: *call to method named* '*tl.ping*'
+* **Description** : get **'Hello!'** message

qatestlink/configs/settings.json

@@ -28,7 +28,8 @@
             "build_name_two": "issue2",
             "user_name": "qacode",
             "about": "Testlink API Version: 1.0 initially written by Asiel Brumfield\n with contributions by TestLink development Team",
-            "say_hello": "Hello!"
+            "say_hello": "Hello!",
+            "ping": "Hello!"
         }
     }
 }

qatestlink/core/testlink_manager.py

@@ -463,7 +463,7 @@ def api_about(self):
         return res_value.get('string')
 
     def api_say_hello(self):
-        """Call to method named 'tl.about' for testlink XMLRPC
+        """Call to method named 'tl.sayHello' for testlink XMLRPC
 
         Returns:
             str -- Message predefined by Testlink code
@@ -474,3 +474,16 @@ def api_say_hello(self):
         res_value = res_dict.get(
             'methodResponse')['params']['param']['value']
         return res_value.get('string')
+
+    def api_ping(self):
+        """Call to method named 'tl.ping' for testlink XMLRPC
+
+        Returns:
+            str -- Message predefined by Testlink code
+        """
+        req_data = self._xml_manager.req_ping()
+        res = self._conn.post(self._xml_manager.headers, req_data)
+        res_dict = self._xml_manager.parse_response(res)
+        res_value = res_dict.get(
+            'methodResponse')['params']['param']['value']
+        return res_value.get('string')

qatestlink/core/xmls/xmlrpc_manager.py

@@ -677,3 +677,16 @@ def req_say_hello(self):
         xml = dicttoxml(
             self.req_dict, custom_root='methodCall', attr_type=False)
         return xml
+
+    def req_ping(self):
+        """String xml object ready to use on API call
+
+        Returns:
+            str -- XML request with parsed params
+        """
+        self.req_dict.update({
+            "methodName": RouteType.TLINK_PING.value
+        })
+        xml = dicttoxml(
+            self.req_dict, custom_root='methodCall', attr_type=False)
+        return xml

tests/unitaries/suite_002_methods.py

@@ -223,6 +223,13 @@ def test_019_method_say_hello(self):
         self.assertIsInstance(say_hello, str)
         self.assertEquals(say_hello, DATA['say_hello'])
 
+    @skipIf(SKIP, SKIP_MESSAGE)
+    def test_020_method_ping(self):
+        """TODO: doc method"""
+        ping = self.testlink_manager.api_ping()
+        self.assertIsInstance(ping, str)
+        self.assertEquals(ping, DATA['ping'])
+
 
 class TestMethodsRaises(TestCase):
     """Test suite for tests methods