version set to v0.4.6

#10 #15

Author: Luiko Czub

Diff for: CHANGES.rst

@@ -1,6 +1,18 @@
 Changes in TestLink-API-Python-client Source Distribution
 =========================================================
 
+TestLink-API-Python-client release notes v0.4.6 (Dec. 2013)
+-----------------------------------------------------------
+
+TestLink-API-Python-client is now installable via PyPI #15
+
+    pip install TestLink-API-Python-client
+
+new api methods for Platforms implemented #10
+
+- createPlatform, getProjectPlatforms
+- addPlatformToTestPlan, removePlatformFromTestPlan
+
 TestLink-API-Python-client release notes v0.4.5 (Nov. 2013)
 -----------------------------------------------------------
 

Diff for: doc/install.rst

@@ -5,7 +5,8 @@ Preconditions
 -------------
 
 Currently only the combination Python 2.7 and TestLink 1.9.8/1.9.9 is tested.
-Other combination might work - feedback is welcome :-) 
+
+- Other combination might work - feedback is welcome :-) 
 
 TestLink configuration
 ----------------------
@@ -95,7 +96,7 @@ privileges for installation, a separate TestLink virtualenv_ may help::
 
 If you always work with the same TestLink server, extend the script
 
-- [PYENV]\testlink\Scripts\activate.
+- [PYENV]/testlink/Scripts/activate[.bat|.ps1]
 
 with connection parameter as environment variables  
 

Diff for: doc/usage.rst

@@ -38,16 +38,16 @@ or generate a description of all implemented API method: ::
 Run Examples
 ------------
 
-Running example [#]_, how to use the class TestlinkAPIClient, with connection 
-parameter defined as command line arguments: ::
+Running example, how to use the class TestlinkAPIClient, with connection 
+parameter defined as command line arguments [1]_: ::
 
  [PYENV]\testlink\Scripts\activate
  python example\TestLinkExample.py 
                 --server_url http://[YOURSERVER]/testlink/lib/api/xmlrpc.php
                 --devKey [Users devKey generated by TestLink]
 
-Running example [#]_, how to use the class TestlinkAPIGeneric, with connection 
-parameter defined as environment variables: ::
+Running example, how to use the class TestlinkAPIGeneric, with connection 
+parameter defined as environment variables [2]_: ::
 
  [PYENV]\testlink\Scripts\activate
  set TESTLINK_API_PYTHON_SERVER_URL=http://[YOURSERVER]/testlink/lib/api/xmlrpc/v1/xmlrpc.php
@@ -71,5 +71,5 @@ Run unittests without TestLink Server interaction: ::
  cd test\utest
  python -m unittest discover -s test\utest-offline
 
-.. [#] TestLinkExample.py creates a new test project NEW_PROJECT_API-[CountProjects+1]. 
-.. [#] TestLinkExampleGenericApi.py creates a new test project PROJECT_API_GENERIC-[CountProjects+1]. 
+.. [1] TestLinkExample.py creates a new test project NEW_PROJECT_API-[CountProjects+1]. 
+.. [2] TestLinkExampleGenericApi.py creates a new test project PROJECT_API_GENERIC-[CountProjects+1]. 

Diff for: example/TestLinkExample.py

@@ -83,6 +83,9 @@
 NEWPROJECT="NEW_PROJECT_API-%i" % projNr
 NEWPREFIX="NPROAPI%i" % projNr
 NEWTESTPLAN="TestPlan_API"
+NEWPLATFORM_A='Big Birds %i' % projNr
+NEWPLATFORM_B='Small Birds'
+NEWPLATFORM_C='Ugly Birds'
 NEWTESTSUITE_A="A - First Level"
 NEWTESTSUITE_B="B - First Level"
 NEWTESTSUITE_AA="AA - Second Level"
@@ -163,6 +166,35 @@
 print "New Test Plan '%s' - id: %s" % (NEWTESTPLAN,newTestPlanID)
 # -- END CHANGE v0.4.5 -- 
 
+# -- Start NEW v0.4.6 -- 
+# Create platform 'Big Birds x' 
+newPlatForm = myTestLink.createPlatform(NEWPROJECT, NEWPLATFORM_A, 
+        notes='Platform for Big Birds, unique name, only used in this project')
+print "createPlatform", newPlatForm
+newPlatFormID_A = newPlatForm['id']
+# Add Platform  'Big Bird x' to platform 
+response = myTestLink.addPlatformToTestPlan(newTestPlanID, NEWPLATFORM_A) 
+print "addPlatformToTestPlan", response
+
+# Create platform 'Small Birds'
+newPlatForm = myTestLink.createPlatform(NEWPROJECT, NEWPLATFORM_B, 
+                notes='Platform for Small Birds, name used in all example projects')
+print "createPlatform", newPlatForm
+newPlatFormID_B = newPlatForm['id']
+# Add Platform  'Small Bird' to platform 
+response = myTestLink.addPlatformToTestPlan(newTestPlanID, NEWPLATFORM_B) 
+print "addPlatformToTestPlan", response
+
+# Create platform 'Ugly Birds'
+newPlatForm = myTestLink.createPlatform(NEWPROJECT, NEWPLATFORM_C, 
+                notes='Platform for Ugly Birds, will be removed from test plan')
+print "createPlatform", newPlatForm
+newPlatFormID_C = newPlatForm['id']
+# Add Platform  'Ugly Bird' to platform 
+response = myTestLink.addPlatformToTestPlan(newTestPlanID, NEWPLATFORM_C) 
+print "addPlatformToTestPlan", response
+# -- End NEW v0.4.6 -- 
+
 #Creates the test Suite A      
 newTestSuite = myTestLink.createTestSuite(newProjectID, NEWTESTSUITE_A,
             "Details of the Test Suite A")  
@@ -274,34 +306,58 @@
 # -- New Examples with v0.4.5 -- 
 
 # Add  test cases to test plan - we need the full external id !
+# TC AA should be tested with platforms 'Big Birds'+'Small Birds'
 tc_aa_full_ext_id = myTestLink.getTestCase(newTestCaseID_AA)[0]['full_tc_external_id']
 response = myTestLink.callServerWithPosArgs('addTestCaseToTestPlan', 
                 devKey=myTestLink.devKey, testprojectid=newProjectID, 
                 testplanid=newTestPlanID, testcaseexternalid=tc_aa_full_ext_id,
-                version=1)
+                platformid=newPlatFormID_A,version=1)
 print "addTestCaseToTestPlan", response
+tc_aa_full_ext_id = myTestLink.getTestCase(newTestCaseID_AA)[0]['full_tc_external_id']
+response = myTestLink.callServerWithPosArgs('addTestCaseToTestPlan', 
+                devKey=myTestLink.devKey, testprojectid=newProjectID, 
+                testplanid=newTestPlanID, testcaseexternalid=tc_aa_full_ext_id,
+                platformid=newPlatFormID_B,version=1)
+print "addTestCaseToTestPlan", response
+# TC B should be tested with platform 'Small Birds'
 tc_b_full_ext_id = myTestLink.getTestCase(testcaseid=newTestCaseID_B)[0]['full_tc_external_id']
 response = myTestLink.callServerWithPosArgs('addTestCaseToTestPlan', 
                 devKey=myTestLink.devKey, testprojectid=newProjectID, 
                 testplanid=newTestPlanID, testcaseexternalid=tc_b_full_ext_id,
-                version=1)
+                platformid=newPlatFormID_B,version=1)
 print "addTestCaseToTestPlan", response
+
+# # Try to Remove Platform  'Big Birds' from platform 
+# response = myTestLink.removePlatformFromTestPlan(newTestPlanID, NEWPLATFORM_C) 
+# print "removePlatformFromTestPlan", response
+
+# Remove Platform  'Ugly Birds' from platform 
+response = myTestLink.removePlatformFromTestPlan(newTestPlanID, NEWPLATFORM_C) 
+print "removePlatformFromTestPlan", response
 
 # -- Create Build
 newBuild = myTestLink.createBuild(newTestPlanID, NEWBUILD, 'Notes for the Build')
 print "createBuild", newBuild
 newBuildID = newBuild[0]['id'] 
 print "New Build '%s' - id: %s" % (NEWBUILD, newBuildID)
 
-# report Test Case Results
+# report Test Case Results for platform 'Big Bird'
 # TC_AA failed, build should be guessed, TC identified with external id
 newResult = myTestLink.reportTCResult(None, newTestPlanID, None, 'f', '', guess=True,
-                                      testcaseexternalid=tc_aa_full_ext_id)
+                                      testcaseexternalid=tc_aa_full_ext_id,
+                                      platformname=NEWPLATFORM_A)
 print "reportTCResult", newResult
 newResultID_AA = newResult[0]['id']
+# report Test Case Results for platform 'Small Bird'
+# TC_AA passed, build should be guessed, TC identified with external id
+newResult = myTestLink.reportTCResult(None, newTestPlanID, None, 'p', '', guess=True,
+                                      testcaseexternalid=tc_aa_full_ext_id,
+                                      platformname=NEWPLATFORM_B)
+print "reportTCResult", newResult
+newResultID_AA_p = newResult[0]['id']
 # TC_B passed, explicit build and some notes , TC identified with internal id
 newResult = myTestLink.reportTCResult(newTestCaseID_B, newTestPlanID, NEWBUILD,
-                                      'p', 'first try')
+                                      'p', 'first try', platformname=NEWPLATFORM_B)
 print "reportTCResult", newResult 
 newResultID_B = newResult[0]['id']
 

Diff for: example/TestLinkExampleGenericApi.py

@@ -241,17 +241,17 @@
                 testplanid=newTestPlanID, testcaseexternalid=tc_aa_full_ext_id,
                 platformid=newPlatFormID_B,version=1)
 print "addTestCaseToTestPlan", response
-# TC B should be tested with platforms 'Small Bird'
+# TC B should be tested with platform 'Small Bird'
 tc_b_full_ext_id = myTestLink.getTestCase(testcaseid=newTestCaseID_B)[0]['full_tc_external_id']
 response = myTestLink.callServerWithPosArgs('addTestCaseToTestPlan', 
                 devKey=myTestLink.devKey, testprojectid=newProjectID, 
                 testplanid=newTestPlanID, testcaseexternalid=tc_b_full_ext_id,
                 platformid=newPlatFormID_B,version=1)
 print "addTestCaseToTestPlan", response
 
-# Remove Platform  'Big Bird' from platform 
-response = myTestLink.removePlatformFromTestPlan(newTestPlanID, NEWPLATFORM_C) 
-print "removePlatformFromTestPlan", response
+# # Try to Remove Platform  'Big Bird' from platform 
+# response = myTestLink.removePlatformFromTestPlan(newTestPlanID, NEWPLATFORM_C) 
+# print "removePlatformFromTestPlan", response
 
 # Remove Platform  'Ugly Bird' from platform 
 response = myTestLink.removePlatformFromTestPlan(newTestPlanID, NEWPLATFORM_C) 

Diff for: src/testlink/version.py

@@ -17,4 +17,4 @@
 #
 # ------------------------------------------------------------------------
 
-VERSION = '0.4.6-DEV-10'
+VERSION = '0.4.6'