Add getTestCaseByVersion

Several API endpoints require a version and getting the latest/specifc
version with `getTestCaseByVersion` can be useful.

Author: Brian Williams

Diff for: README.rst

@@ -92,7 +92,7 @@ how existing code can be adapted
 TestLink-API-Python-client developers
 -------------------------------------
 *   `James Stock`_, `Olivier Renault`_, `lczub`_, `manojklm`_ (PY3)
-*   `g4l4drim`_, `pade`_, `anton-matosov`_, `citizen-stig`_, `charz`_, `Maberi`_
+*   `g4l4drim`_, `pade`_, `anton-matosov`_, `citizen-stig`_, `charz`_, `Maberi`_, `Brian-Williams`_
 *   anyone forgotten?
 
 .. _Apache License 2.0: http://www.apache.org/licenses/LICENSE-2.0

Diff for: src/testlink/testlinkapi.py

@@ -212,7 +212,23 @@ def copyTCnewTestCase(self, origTestCaseId, origVersion=None, **changedAttribute
         return self._copyTC(origTestCaseId, changedAttributes, origVersion,
                             duplicateaction = 'generate_new')
 
-    
+    def getTestCaseByVersion(self, testCaseID, version=None):
+        """
+        Gets testcase information based on the version.
+
+        :param testCaseID: test case to search for
+        :param version: version to search for defaults to None. None searches for latest
+        :return: test case info dictionary
+        """
+        testcases = self.getTestCase(testCaseID, version=version)
+        if version is None:
+            return testcases[0]
+        for testcase in testcases:
+            if str(testcase['version']) == str(version):
+                return testcase
+        else:
+            raise RuntimeError("Testcase {} doesn't have version {}.".format(testCaseID, version))
+
     def _copyTC(self, origTestCaseId, changedArgs, origVersion=None, **options):
         """ creates a copy of test case with id ORIGTESTCASEID
         
@@ -237,7 +253,7 @@ def _copyTC(self, origTestCaseId, changedArgs, origVersion=None, **options):
         """
 
         # get orig test case content 
-        origArgItems = self.getTestCase(origTestCaseId, version=origVersion)[0]
+        origArgItems = self.getTestCaseByVersion(origTestCaseId, version=origVersion)
         # get orig test case project id 
         origArgItems['testprojectid'] = self.getProjectIDByNode(origTestCaseId)