new api method assignRequirements() #14

Author: Luiko Czub

Diff for: CHANGES.rst

@@ -22,6 +22,13 @@ new TestlinkAPIGeneric and TestlinkAPIClient api methods
 - getUserByLogin(), getUserByID()
 - deleteExecution()
 - setTestCaseExecutionType()
+- assignRequirements()
+
+Known TL 1.9.9 limitations:
+
+- 6202 assignRequirements() calls assign_to_tcase() without author_id
+- 6197 MSSQL - 1.9.8 Upgrade - req_coverage table
+- 6193 POSTGRESQL - 1.9.8 Upgrade - req_coverage table
 
 TestLink-API-Python-client release notes v0.4.7 (Jan. 2014)
 -----------------------------------------------------------

Diff for: example/TestLinkExample.py

@@ -601,6 +601,11 @@
 # add png file as Attachemnt to a requirement.
 print "uploadRequirementAttachment", "Sorry currently no testdata"
 
+# add requirements to testcase AA
+# response = myTestLink.assignRequirements(tc_aa_full_ext_id, newProjectID, 
+#                         [{'req_spec' : 6729, 'requirements' : [6731]},
+#                          {'req_spec' : 6733, 'requirements' : [6735, 6737]}])
+print "assignRequirements", "Sorry currently no testdata"
 
 
 

Diff for: example/TestLinkExampleGenericApi.py

@@ -512,6 +512,12 @@
 # add png file as Attachemnt to a requirement.
 print "uploadRequirementAttachment", "Sorry currently no testdata"
 
+# add requirements to testcase AA
+# response = myTestLink.assignRequirements(tc_aa_full_ext_id, newProjectID, 
+#                         [{'req_spec' : 6729, 'requirements' : [6731]},
+#                          {'req_spec' : 6733, 'requirements' : [6735, 6737]}])
+print "assignRequirements", "Sorry currently no testdata"
+
 print ""
 print "Number of Projects in TestLink: %i " % len(myTestLink.getProjects())
 print ""

Diff for: src/testlink/testlinkapigeneric.py

@@ -321,6 +321,23 @@ def getFirstLevelTestSuitesForTestProject(self):
 #     */
 #    public function assignRequirements($args)
 
+    @decoApiCallAddDevKey               
+    @decoMakerApiCallWithArgs(['testcaseexternalid', 'testprojectid', 
+                               'requirements'])
+    def assignRequirements(self):
+        """ Assign Requirements to a test case 
+        It is possible to assign multiple requirements, belonging to different 
+        requirement specifications. (the internal IDs must be known!)
+        
+        Argument REQUIREMENTS expects an array of dictionaries, example:
+        .assignRequirements('GPROAPI4-2', 6652, 
+                           [{'req_spec' : 6729, 'requirements' : [6731]},
+                            {'req_spec' : 6733, 'requirements' : [6735, 6737]}])
+        This would assign to testcase 'GPROAPI4-2' (in testproject with id 6652)
+        a) requirement with ID 6731 of requirement spec 6729 AND
+        b) requirements with ID 6735 and 6737 of requirement spec 6733
+        """
+
     @decoApiCallAddDevKey               
     @decoMakerApiCallWithArgs([], ['testcaseid', 'testcaseexternalid'])
     def getTestCaseAttachments(self):

Diff for: test/utest-online/testlinkapi_online_test.py

@@ -281,6 +281,13 @@ def test_deleteExecution_unknownKey(self):
     def test_setTestCaseExecutionType_unknownID(self):
         with self.assertRaisesRegexp(TLResponseError, '7000.*4712'):
             self.client.setTestCaseExecutionType('N-4711', 1, 4712, 1)
+
+    def test_assignRequirements_unknownID(self):
+        with self.assertRaisesRegexp(TLResponseError, '7000.*4712'):
+            self.client.assignRequirements('N-4711', 4712, 
+                        [{'req_spec' : 4713, 'requirements' : [4714, 4717]}, 
+                         {'req_spec' : 4723, 'requirements' : [4725]}])
+            
 
 
 if __name__ == "__main__":

Diff for: test/utest-online/testlinkapigeneric_online_test.py

@@ -299,6 +299,13 @@ def test_setTestCaseExecutionType_unknownID(self):
         with self.assertRaisesRegexp(TLResponseError, '7000.*4712'):
             self.client.setTestCaseExecutionType('N-4711', 1, 4712, 1)
 
+    def test_assignRequirements_unknownID(self):
+        with self.assertRaisesRegexp(TLResponseError, '7000.*4712'):
+            self.client.assignRequirements('N-4711', 4712, 
+                        [{'req_spec' : 4713, 'requirements' : [4714, 4717]}, 
+                         {'req_spec' : 4723, 'requirements' : [4725]}])
+            
+            
 
 if __name__ == "__main__":
     #import sys;sys.argv = ['', 'Test.testName']