getLastExecutionResult - new optional argument 'options' #27

Author: Luiko Czub

CHANGES.rst

@@ -3,7 +3,21 @@ Changes in TestLink-API-Python-client Source Distribution
 
 TestLink-API-Python-client UNDER DEVELOP v0.5.1 
 -----------------------------------------------------------
-support for future TL 1.9.11 release
+support for future TL 1.9.11 release 
+
+implement 1.9.11 api changes - getLastExecutionResult #27
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+TestlinkAPIGeneric and TestlinkAPIClient api method getLastExecutionResult() 
+accepts now following additional optional arguments (usable with TL >= 1.9.10) 
+
+- options = {'getBugs' : True / False}
+
+example:
+
+ >>> tls = testlink.TestLinkHelper().connect(testlink.TestlinkAPIClient)
+ >>> tls.getLastExecutionResult(aTPlanID, aTCaseID, options={'getBugs' : True})
+  [{ ... , 'tcversion_id': '8929', ... , 'bugs': [{'bug_id': '4711'}], ... }]
 
 implement 1.9.11 new api method - assignTestCaseExecutionTask #26
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

example/TestLinkExample.py

@@ -616,7 +616,7 @@
 response = myTestLink.copyTCnewVersion(newTestCaseID_B, 
                 summary='new version of TC B', importance='1')
 print 'copyTCnewVersion', response
-print "copy TC B as TC BA into Test suite B"
+print "copy TC B as TC BA into Test suite A"
 response = myTestLink.copyTCnewTestCase(newTestCaseID_B, 
                 testsuiteid=newTestSuiteID_A, testcasename='%sA' % NEWTESTCASE_B)
 print 'copyTCnewTestCase', response

example/TestLinkExample_CF_KW.py

@@ -164,13 +164,15 @@
 # new execution result with custom field data
 # TC_B passed, explicit build and some notes , TC identified with internal id
 newResult = myTestLink.reportTCResult(newTestCaseID_B, newTestPlanID_A, 
-                newBuildName_A, 'p', "custom try", platformname=NEWPLATFORM_B, 
+                newBuildName_A, 'p', "bugid 4711 is assigned", 
+                platformname=NEWPLATFORM_B, bugid='4711',
                 customfields={'cf_tc_ex_string' : 'a custom exec value set via api',
                               'cf_tc_sd_listen' : 'ernie'})
 print "reportTCResult", newResult
 
 # get execution results
-lastResult = myTestLink.getLastExecutionResult(newTestPlanID_A, newTestCaseID_B)[0]
+lastResult = myTestLink.getLastExecutionResult(newTestPlanID_A, newTestCaseID_B, 
+                                               options={'getBugs' : True})[0]
 print "getLastExecutionResult", lastResult
 
 # map of used ids

src/testlink/testlinkapigeneric.py

@@ -100,14 +100,19 @@ def getLatestBuildForTestPlan(self):
     @decoMakerApiCallWithArgs(['testplanid'], 
                               ['testcaseid', 'testcaseexternalid',
                                'platformid', 'platformname', 
-                               'buildid', 'buildname'])
+                               'buildid', 'buildname', 'options'])
     def getLastExecutionResult(self):
         """ 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. 
 
-following optional arguments could only be used with TL version >= 1.9.9 
+following optional arguments could only used with 
+TL version >= 1.9.9 
 - platformid, platformname, buildid, buildname
+
+TL version >= 1.9.11
+- options : dictionary with key value pair
+                    'getBugs' : True / False 
 """
 
     @decoApiCallWithoutArgs

src/testlink/version.py

@@ -18,5 +18,5 @@
 # ------------------------------------------------------------------------
 
 VERSION = '0.5.1-dev25'
-TL_RELEASE = 'DEV 1.9.11'
+TL_RELEASE = 'DEV 1.9.11 (gitorious ef1ca8b)'
 

test/utest-offline/testlinkapi_offline_test.py

@@ -566,6 +566,10 @@ def test_listKeywordsForTS_Multi(self):
         self.assertEqual({'8144' : ['KeyWord01', 'KeyWord03'],
                           '8159' : ['KeyWord02'], '8169' : []}, response)
 
+    def test_whatArgs_getLastExecutionResult(self):
+        argsDescription = self.api.whatArgs('getLastExecutionResult')
+        self.assertIn('options=<options>', argsDescription)
+        self.assertIn('getBugs', argsDescription)
 
 
 if __name__ == "__main__":

test/utest-offline/testlinkapigeneric_offline_test.py

@@ -646,6 +646,10 @@ def test_whatArgs_reportTCResult(self):
         argsDescription = self.api.whatArgs('reportTCResult')
         self.assertIn('user=<user>', argsDescription)
 
+    def test_whatArgs_getLastExecutionResult(self):
+        argsDescription = self.api.whatArgs('getLastExecutionResult')
+        self.assertIn('options=<options>', argsDescription)
+        self.assertIn('getBugs', argsDescription)
 
 
 if __name__ == "__main__":