new api method getTestCaseAssignedTester #29

Author: Luiko Czub

CHANGES.rst

@@ -5,7 +5,18 @@ TestLink-API-Python-client UNDER DEVELOP v0.5.2
 -----------------------------------------------------------
 support for future TL 1.9.12 release
 
-implement 1.9.12 new api - getTestCaseBugs #30
+implement 1.9.12 new api method - getTestCaseAssignedTester #29
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+new TestlinkAPIGeneric and TestlinkAPIClient api method
+
+- getTestCaseAssignedTester(<testplanid>, <testcaseexternalid>,
+  [buildid=<buildid>], [buildname=<buildname>], [platformid=<platformid>], 
+  [platformname=<platformname>], [devKey=<devKey>])
+
+examples see `<example/TestLinkExample.py>`_  
+
+implement 1.9.12 new api method - getTestCaseBugs #30
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 new TestlinkAPIGeneric and TestlinkAPIClient api method
@@ -14,10 +25,9 @@ new TestlinkAPIGeneric and TestlinkAPIClient api method
   [testcaseid]=<testcaseid>], [testcaseexternalid=<testcaseexternalid>], 
   [buildid=<buildid>], [buildname=<buildname>], [platformid=<platformid>], 
   [platformname=<platformname>], [devKey=<devKey>])
-  
-examples see `<example/TestLinkExample.py>`_  
-
 
+examples see `<example/TestLinkExample.py>`_  
+  
 TestLink-API-Python-client release notes v0.5.1 (Aug. 2014) 
 ------------------------------------------------------------
 

example/TestLinkExample.py

@@ -428,7 +428,21 @@
                         newTestPlanID_A, tc_b_full_ext_id,
                         buildname=NEWBUILD_A, platformname=NEWPLATFORM_B)  
 print "assignTestCaseExecutionTask", response
-  
+
+# get test case assigned tester
+response = myTestLink.getTestCaseAssignedTester(  
+                        newTestPlanID_A, tc_aa_full_ext_id,
+                        buildid=newBuildID_A, platformname=NEWPLATFORM_A)
+print "getTestCaseAssignedTester TC_AA TP_A Platform A", response
+response = myTestLink.getTestCaseAssignedTester( 
+                        newTestPlanID_A, tc_aa_full_ext_id,
+                        buildname=NEWBUILD_A, platformid=newPlatFormID_B)  
+print "getTestCaseAssignedTester TC_AA TP_A Platform B", response
+response = myTestLink.getTestCaseAssignedTester(
+                        newTestPlanID_A, tc_b_full_ext_id,
+                        buildname=NEWBUILD_A, platformname=NEWPLATFORM_B)  
+print "getTestCaseAssignedTester TC_B TP_A Platform B", response
+
 # get bugs for test case TC_AA in test plan A - state TC not executed
 response = myTestLink.getTestCaseBugs(newTestPlanID_A, 
                                       testcaseexternalid=tc_aa_full_ext_id)
@@ -487,6 +501,10 @@
                         newTestPlanID_B, tc_b_full_ext_id, buildname=NEWBUILD_B)  
 print "assignTestCaseExecutionTask", response
 
+# get test case assigned tester
+response = myTestLink.getTestCaseAssignedTester(  
+                        newTestPlanID_B, tc_b_full_ext_id, buildname=NEWBUILD_B)
+print "getTestCaseAssignedTester TC_B TP_B no Platform", response
 
 # TC_B blocked (without platform), explicit build and some notes , 
 # TC identified with internal id, report by myTestUserName

example/TestLinkExampleGenericApi.py

@@ -353,6 +353,20 @@
                         buildname=NEWBUILD_A, platformname=NEWPLATFORM_B)  
 print "assignTestCaseExecutionTask", response
 
+# get test case assigned tester
+response = myTestLink.getTestCaseAssignedTester(  
+                        newTestPlanID_A, tc_aa_full_ext_id,
+                        buildid=newBuildID_A, platformname=NEWPLATFORM_A)
+print "getTestCaseAssignedTester TC_AA TP_A Platform A", response
+response = myTestLink.getTestCaseAssignedTester( 
+                        newTestPlanID_A, tc_aa_full_ext_id,
+                        buildname=NEWBUILD_A, platformid=newPlatFormID_B)  
+print "getTestCaseAssignedTester TC_AA TP_A Platform B", response
+response = myTestLink.getTestCaseAssignedTester(
+                        newTestPlanID_A, tc_b_full_ext_id,
+                        buildname=NEWBUILD_A, platformname=NEWPLATFORM_B)  
+print "getTestCaseAssignedTester TC_B TP_A Platform B", response
+
 # get bugs for test case TC_AA in test plan A - state TC not executed
 response = myTestLink.getTestCaseBugs(newTestPlanID_A, 
                                       testcaseexternalid=tc_aa_full_ext_id)
@@ -412,6 +426,11 @@
                         newTestPlanID_B, tc_b_full_ext_id, buildname=NEWBUILD_B)  
 print "assignTestCaseExecutionTask", response
 
+# get test case assigned tester
+response = myTestLink.getTestCaseAssignedTester(  
+                        newTestPlanID_B, tc_b_full_ext_id, buildname=NEWBUILD_B)
+print "getTestCaseAssignedTester TC_B TP_B no Platform", response
+
 # TC_B in test plan b (without platform)
 # first try failed (with bug), second blocked - all by user myTestUserName
 newResult = myTestLink.reportTCResult(newTestPlanID_B, 'f', 

src/testlink/testlinkapigeneric.py

@@ -1046,6 +1046,7 @@ def assignTestCaseExecutionTask(self):
         """ assigns a user to a test case execution task
         
         user                 login name => tester
+        testplanid           test plan id
         testcaseexternalid   format PREFIX-NUMBER
         
         args variations:     buildid - buildname 
@@ -1110,6 +1111,46 @@ def getTestCaseBugs(self):
         test case information is general mandatory
         """
 
+#   /**
+#    * Gets the result of LAST EXECUTION for a particular testcase on a test plan.
+#    * If there are no filter criteria regarding platform and build,
+#    * result will be get WITHOUT checking for a particular platform and build.
+#    *
+#    * @param struct $args
+#    * @param string $args["devKey"]
+#    * @param int $args["tplanid"]
+#    * @param string $args["testcaseexternalid"] format PREFIX-NUMBER
+#    * @param int $args["buildid"] Mandatory => you can provide buildname as alternative
+#    * @param int $args["buildname"] Mandatory => you can provide buildid (DB ID) as alternative
+#    * @param int $args["platformid"] optional - BECOMES MANDATORY if Test plan has platforms
+#    *                                           you can provide platformname as alternative  
+#    *  
+#    * @param int $args["platformname"] optional - BECOMES MANDATORY if Test plan has platforms
+#    *                                           you can provide platformid as alternative  
+#    *
+#    *
+#    * @return mixed $resultInfo
+#    *
+#    * @access public
+#    */
+#   public function getTestCaseAssignedTester($args)
+
+    @decoApiCallAddDevKey
+    @decoMakerApiCallWithArgs(['testplanid', 'testcaseexternalid'],
+                        ['buildid', 'buildname', 'platformid', 'platformname'])
+    def getTestCaseAssignedTester(self):
+        """ Gets the result of LAST EXECUTION for a particular testcase on a 
+        test plan.
+        
+        testplanid           test plan id
+        testcaseexternalid   format PREFIX-NUMBER
+        
+        args variations:     buildid - buildname 
+                             platformid - platformname
+        build information is general mandatory
+        platform information is required, when test plan has assigned platforms
+        """
+
     #
     #  public methods for general server calls
     #                                   

src/testlink/version.py

@@ -17,6 +17,6 @@
 #
 # ------------------------------------------------------------------------
 
-VERSION = '0.5.2-dev30'
+VERSION = '0.5.2-dev29'
 TL_RELEASE = 'DEV 1.9.12 (gitorious 9ca61c8)'
 

test/utest-online/testlinkapi_online_test.py

@@ -304,7 +304,12 @@ def test_getTestCaseBugs_unknownID(self):
                                         buildname='build 4713',
                                         platformname='platform 4714')                         
 
-           
+    def test_getTestCaseAssignedTester_unknownID(self):
+        with self.assertRaisesRegexp(TLResponseError, '3000.*4711'):
+            self.client.getTestCaseAssignedTester(4711, 'TC-4712', 
+                                            buildname='build 4713', 
+                                            platformname='platform 4714') 
+          
 
 if __name__ == "__main__":
     #import sys;sys.argv = ['', 'Test.testName']

test/utest-online/testlinkapigeneric_online_test.py

@@ -356,6 +356,13 @@ def test_getTestCaseBugs_unknownID(self):
             self.client.getTestCaseBugs(4711, testcaseexternalid='TC-4712', 
                                         buildname='build 4713',
                                         platformname='platform 4714')                         
+
+    def test_getTestCaseAssignedTester_unknownID(self):
+        with self.assertRaisesRegexp(TLResponseError, '3000.*4711'):
+            self.client.getTestCaseAssignedTester(4711, 'TC-4712', 
+                                            buildname='build 4713', 
+                                            platformname='platform 4714') 
+              
 
 if __name__ == "__main__":
     #import sys;sys.argv = ['', 'Test.testName']