support for TL 1.9.20 (dev) release and py27, py36, py37
main topic is to support TL 1.9.19 and TL 1.9.20 (dev) api changes related to test case attachments, which are stored since TL 1.9.19 with a reference to the test case version instead the test case id .
Parameter <version> is now mandatory for _uploadTestCaseAttachment_ and optional for _getTestCaseAttachments_.
changed TestlinkAPIGeneric and TestlinkAPIClient api methods
- getTestCasesForTestPlan() is adapted to support the new optional argument <customfields> . Sample see example/TestLinkExample_CF_KW.py
API-XMLRPC - getTestCaseAttachments returns no attachment, uploaded with uploadTestCaseAttachment
- see TL Mantis Ticket 8658 <http://mantis.testlink.org/view.php?id=8658>`_
- recommended to use the TL 1.9.20 development state with github commit 6a4984164 or later (even for the TL upgrade or installation).
Calling getTestCasesForTestPlan() with the new optional argument <customfields> returns only internal db values. As alternative, loop over all returned test cases and call getTestCaseCustomFieldDesignValue(). Sample see example/TestLinkExample_CF_KW.py
support for TL 1.9.17 release and py27, py36
- getExecutionSet(<testplanid>, [testcaseid=<testcaseid>], [testcaseexternalid=<testcaseexternalid>], [buildid=<buildid>], [buildname=<buildname>], [platformid=<platformid>], [platformname=<platformname>], [options=<options>], [devKey=<devKey>])
- getRequirements(<testprojectid>, [testplanid=<testplanid>], [platformid=<platformid>], [devKey=<devKey>])
- getReqCoverage(<testprojectid>, <requirementdocid>, [devKey=<devKey>])
- setTestCaseTestSuite(<testcaseexternalid>, <testsuiteid>, [devKey=<devKey>])
- getTestSuiteAttachments(<testsuiteid>, [devKey=<devKey>])
- getAllExecutionsResults(<testplanid>, [testcaseid=<testcaseid>], [testcaseexternalid=<testcaseexternalid>], [platformid=<platformid>], [buildid=<buildid>], [options=<options>])
pull request by Brian-Williams:
- TestReporter's subclasses can be used to idempotently generate required components of testlink before sending the report to a specified testcase.
- TestGenReporter is a default combination of all the TestReporter's subclasses and will try to generate everything it's subclasses is capable of.
- Added TestLinkHelper._setParams to simplify libraries that need to overwrite how a helper aquires it's parameters
- Added TestlinkAPIClient.getTestCaseByVersion to expose the common need of gettting the latest testcase by default. It was already used, but not a function in this class and has uses elsewhere.
example/TestLinkExample.py includes sample, how to use TestGenReporter and TestlinkAPIClient.getTestCaseByVersion
TestlinkAPIGeneric and TestlinkAPIClient accepts know the additional xmlrpclib.ServerProxy() arguments use_datetime and context (new with Py2.7.9) - https://docs.python.org/2/library/xmlrpclib.html
context allows to define a SSL context, which can holds various data longer-lived than single SSL connections, such as SSL configuration options, certificate(s) and private key(s). (new with Py2.7.9) - https://docs.python.org/2/library/ssl.html#ssl-contexts
TestLinkHelper will set the unverified_context() if the server url starts with https and no context is defined, calling - TestLinkHelper().connect(TestlinkAPIClient)
API-XMLRPC - new 1.9.17 xmlrpc.class function getAllExecutionsResults not callable via XMLRPC api
API-XMLRPC - getRequirements raise PHP Fatal error (github commit 0c8feb6)
API-XMLRPC - getExecutionSet raise database error (github commit 1ee5f78)
support for TL 1.9.16 release and py27, py34, py35 and py36
new TestlinkAPIGeneric and TestlinkAPIClient api method
- updateBuildCustomFieldsValues(<testprojectid>, <testplanid>, <buildid>, <customfields>, [devKey=<devKey>])
example example/TestLinkExample_CF_KW.py shows, how to set and get customer field values
support for TL 1.9.15 release and py26, py27, py33, py34 and py35
- further releases will be developed only against py27, py34 and py35
- If there is a need to support other py versions, please give feedback
new TestlinkAPIGeneric and TestlinkAPIClient api methods
- updateTestSuite(<testsuiteid>, [testprojectid=<testprojectid>], [prefix=<prefix>], [parentid=<parentid>], [testsuitename=<testsuitename>], [details=<details>], [order=<order>], [devKey=<devKey>])
- getTestSuite(<testsuitename>, <prefix>, [devKey=<devKey>])
- getIssueTrackerSystem(<itsname>, [devKey=<devKey>])
changed TestlinkAPIGeneric and TestlinkAPIClient api methods
- reportTCResult() is adapted to support the new optional argument <steps> for setting test step results
- createBuild() is adapted to support new optional arguments
- <active> : 1 (default) = activ 0 = inactiv
- <open> : 1 (default) = open 1 = closed
- <releasedate> : YYYY-MM-DD
- <copytestersfrombuild> : valid buildid tester assignments will be copied.
- addTestCaseToTestPlan() is adapted to to support the new optional argument <overwrite> to update linked Test Case Versions
- createTestCase() is adapted to to support the new optional arguments <status> and <estimatedexecduration>
- createTestProject() is adapted to to support the new optional arguments <itsname> and <itsenabled> to link a project with an ITS
examples:
>>> tls = testlink.TestLinkHelper().connect(testlink.TestlinkAPIClient) >>> tls.reportTCResult(None, 'aTPlanID', 'aBuildName', 'f', 'result note', >>> testcaseexternalid='aTCaseFullExID', overwrite=True, >>> platformname='Small Birds', execduration=4.1, >>> timestamp='2015-09-19 14:33:02', >>> steps=[{'step_number' : 3, 'result' : 'p', 'notes' : 'a exec note3'}, >>> {'step_number' : 4, 'result' : 'f', 'notes' : 'a exec note4'}]) >>> tls.createBuild(aTPlanID, 'newBuildName', 'a build note', >>> active=1, open=1, releasedate='2016-11-30' >>> copytestersfrombuild=existingBuildID) >>> tls.addTestCaseToTestPlan(aTProjectID, aTPlanID, 'aTCaseFullExID', >>> aTCVersion, overwrite=1)
changing test suite order with updateTestSuite raise internal server error
- same reason as TL Mantis Ticket 7696
- solution: change testlink-1.9.15/lib/functions/testsuite.class.php - update as descriped in TL GitHub Commit 1fa41e7
TestLink web presents no login page (internal server error)
- see TL Mantis Ticket 7708
- solution: change testlink-1.9.15/lib/functions/common.php as described in TL GitHub Commit db74644
Test projects with execution step results can not be deleted - details and solution see TL Mantis Ticket 7765
support for TL 1.9.14 release and py26, py27, py33 and py34
- further releases will be developed only against py27 and py34.
- If there is a need to support other py versions, please give feedback
new TestlinkAPIGeneric and TestlinkAPIClient api methods
- deleteTestProject(<testprojectprefix>)
- updateTestSuiteCustomFieldDesignValue(<testprojectid>, <testsuiteid>, <customfields>)
examples example/TestLinkExample.py and example/TestLinkExampleGenericApi.py now deletes the sample project, if it already exist.
example example/TestLinkExample_CF_KW.py shows, how to set and get customer field values
changed TestlinkAPIGeneric and TestlinkAPIClient api methods
- addTestCaseKeywords() and removeTestCaseKeywords() are adapted to work with a set of keywords.
- getTestCaseKeywords() is adapted to work with a set of test cases ids.
- createTestPlan() is adapted to work with new optional argument <prefix>
- reportTCResult() is adapted to work with new optional arguments <execduration> and <timestamp>
examples:
>>> tls = testlink.TestLinkHelper().connect(testlink.TestlinkAPIClient) >>> tls.addTestCaseKeywords( {TCa_exID : ['KW01', 'KW03', 'KW02'], >>> TCb_exID : ['KW01', 'KW02', 'KW04']}) >>> tls.removeTestCaseKeywords( {TCa_exID : ['KW02'], >>> TCb_exID : ['KW01', 'KW04']}) >>> tls.getTestCaseKeywords( testcaseid=[TCa_ID, TCb_ID] ) >>> tls.getTestCaseKeywords( testcaseexternalid=[TCa_exID, TCb_exID] ) >>> tls.createTestPlan('aTPlanName', 'aTProjectName') >>> tls.createTestPlan('aTPlanName', testprojectname='aTProjectName') >>> tls.createTestPlan('aTPlanName', prefix='aTProjectPrefix') >>> tls.reportTCResult(None, 'aTPlanID', 'aBuildName', 'f', 'result one', >>> testcaseexternalid='aTCaseFullExID', overwrite=True, >>> platformname='Small Birds', execduration=4.1, >>> timestamp='2015-09-19 14:33:02')
Attention: the api getTestCaseKeywords() returns for the situation invalid test case id a different error code
- 1.9.13 error code 5000 - 1.9.14 error code 5040
whatArgs reports incorrect arg name for createTestCase
- wrong arg name <execution>, correct arg name <executiontype>
TestlinkAPIClient service method countProjects() raise 'Empty Response!' error, when no project exist
- general problem of all 'count*' service methods
- api method 'getProjects()' now returns an empty list when no projects exists
TestlinkAPIClient does not accept optional argument 'transport' for proxy configuration
- TestlinkAPIClient accepts now like TestlinkAPIGeneric optional arguments
TestlinkAPIClient service method listKeywordsForTC() uses now getTestCaseKeywords()
- internal change to reduce code complexity
- 7282 updateTestSuiteCustomFieldDesignValue() does change customer field values
support for TL 1.9.13 release
Integrates Maberi pull request #36
- allows easy proxy configuration using TestLinkHelper
- Adds a new --proxy option in command line.
- Recognizes "http_proxy" environment variable.
new TestlinkAPIGeneric and TestlinkAPIClient api methods
- unassignTestCaseExecutionTask(<testplanid>, <testcaseexternalid>, [buildid=<buildid>], [buildname=<buildname>], [platformid=<platformid>], [platformname=<platformname>], [user=<loginname>], [action='unassignAll'|'unassignOne'], [devKey=<devKey>])
- getProjectKeywords(<testprojectid>)
- getTestCaseKeywords([testcaseid=<testcaseid>], [testcaseexternalid=<testcaseexternalid>])
- deleteTestPlan(<testplanid>)
- addTestCaseKeywords(<testcaseexternalid>, <keywords>)
- Attention: with TL 1.9.14, this api method will change the interface (args) see TL Mantis Task 6934
- removeTestCaseKeywords(<testcaseexternalid>, <keywords>)
- Attention: with TL 1.9.14, this api method will change the interface (args) see TL Mantis Task 6907
examples see example/TestLinkExample.py and example/TestLinkExample_CF_KW.py
TestlinkAPIGeneric and TestlinkAPIClient api method getTestCasesForTestPlan() accepts now the additional optional argument platformid=<platformid>
example:
>>> tls = testlink.TestLinkHelper().connect(testlink.TestlinkAPIClient) >>> tls.getTestCasesForTestPlan(aTPlanID, platformid=aPlatFormID) {'12996': {'949': {'platform_name': 'Small Bird', ... }}
Also the optional argument buildid=<buildid> could now be used
support for TestLink release 1.9.12 and py26, py27, py33 and py34
Integrates manojklm pull requests #33 and #37
- add source and unittest support for py33 and py34
- extend py26 support for unittest2
- add .travis.yml configuration for Travis CI
- add tox.ini configuration for Tox
Track now TestLink-API-Python-client build results on Travis CI - see https://travis-ci.org/lczub/TestLink-API-Python-client
uploading attachments excepts now also a file path as parameter.
still supported 0.5.2 behavior - file descriptor:
a_file_obj=open(A_VALID_FILE_PATH) newAttachment = myTestLink.uploadExecutionAttachment(a_file_obj, A_Result_ID, 'Attachment Title', 'Attachment Description')
new supported 0.6.0 behaviour - file path:
a_file_path=A_VALID_FILE_PATH newAttachment = myTestLink.uploadExecutionAttachment(a_file_path, A_Result_ID, 'Attachment Title', 'Attachment Description')
support for TestLink release 1.9.12
new TestlinkAPIGeneric and TestlinkAPIClient api method
- getTestCaseAssignedTester(<testplanid>, <testcaseexternalid>, [buildid=<buildid>], [buildname=<buildname>], [platformid=<platformid>], [platformname=<platformname>], [devKey=<devKey>])
examples see example/TestLinkExample.py
new TestlinkAPIGeneric and TestlinkAPIClient api method
- getTestCaseBugs(<testplanid>, [testcaseid]=<testcaseid>], [testcaseexternalid=<testcaseexternalid>], [buildid=<buildid>], [buildname=<buildname>], [platformid=<platformid>], [platformname=<platformname>], [devKey=<devKey>])
examples see example/TestLinkExample.py
support for TestLink release 1.9.11
TestlinkAPIGeneric and TestlinkAPIClient api method getLastExecutionResult() accepts now following additional optional arguments
- 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'}], ... }]
new TestlinkAPIGeneric and TestlinkAPIClient api method
- assignTestCaseExecutionTask(<user>, <testplanid>, <testcaseexternalid>, [buildid=<buildid>], [buildname=<buildname>], [platformid=<platformid>], [platformname=<platformname>], [devKey=<devKey>])
examples see example/TestLinkExample.py
support for TestLink release 1.9.10
new TestlinkAPIClient service methods, which returns keyword lists without internal details (like getTestCasesForTestSuite() does)
- listKeywordsForTC(internal_or_external_tc_id)
- listKeywordsForTC(internal_ts_id)
Example:
>>> import testlink >>> tls = testlink.TestLinkHelper().connect(testlink.TestlinkAPIClient) >>> tc_kw = tls.listKeywordsForTC('NPROAPI-3') ['KeyWord01', 'KeyWord03'] >>> tc_kw = tls.listKeywordsForTC(5440) ['KeyWord01', 'KeyWord03'] >>> tc_kw = tls.listKeywordsForTC('5440') ['KeyWord01', 'KeyWord03'] >>> ts_kw = tls.listKeywordsForTS('5415') {'5440' : ['KeyWord01', 'KeyWord03'], '5445' : ['KeyWord03'], '5450' : []}
Known limitations:
- it is not possible to ask for a special test case version, cause TL links keywords against a test case and not a test case version
TestlinkAPIGeneric and TestlinkAPIClient api method getTestCasesForTestSuite() accepts now following additional optional arguments (usable with TL >= 1.9.10)
- parameter getkeywords
TestlinkAPIGeneric and TestlinkAPIClient api method reportTCResult() accepts now following additional optional arguments (usable with TL >= 1.9.10)
- user
new TestlinkAPIGeneric and TestlinkAPIClient api methods
- updateTestCaseCustomFieldDesignValue, getTestCaseCustomFieldExecutionValue getTestCaseCustomFieldTestPlanDesignValue
- getTestSuiteCustomFieldDesignValue, getTestPlanCustomFieldDesignValue
- getReqSpecCustomFieldDesignValue , getRequirementCustomFieldDesignValue
Installation failed under Python 2.6 with on error, cause TestlinkAPIGeneric used in _convertPostionalArgs() a Py31 feature, back ported to Py27
- Dictionary and set comprehensions ({i: i*2 for i in range(3)}).
TestLink-API-Python-client is now installable under Py26 and Py27. To use it under Py26, the module argparse must be installed additionally:
pip install argparse pip install TestLink-API-Python-client
TestlinkAPIGeneric and TestlinkAPIClient api method getLastExecutionResult() accepts now following additional optional arguments (usable with TL >= 1.9.9)
- platformid, platformname, buildid, buildname
new TestlinkAPIGeneric and TestlinkAPIClient api method to return the TL version
- testLinkVersion()
new TestlinkAPIGeneric and TestlinkAPIClient service method to return connection informations
- connectionInfo()
new TestlinkAPIGeneric and TestlinkAPIClient api methods
- getUserByLogin(), getUserByID()
- deleteExecution()
- setTestCaseExecutionType()
- assignRequirements()
- getExecCountersByBuild()
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
new TestlinkAPIClient service methods to copy test cases between test suites or to create a new test case version.
- copyTCnewVersion(origTestCaseId, **changedAttributes)
- copyTCnewTestCase(origTestCaseId, **changedAttributes)
- getProjectIDByNode(a_nodeid)
Example:
>>> import testlink >>> tls = testlink.TestLinkHelper().connect(testlink.TestlinkAPIClient) >>> tc_info = tls.getTestCase(None, testcaseexternalid='NPROAPI-3') [{'full_tc_external_id': 'NPROAPI-3', ..., 'id': '5440', 'version': '2', 'testsuite_id': '5415', 'tc_external_id': '3','testcase_id': '5425', ...}] >>> tls.copyTCnewTestCase(tc_info[0]['testcase_id'], testsuiteid=newSuiteID, testcasename='a new test case name')
Known limitations:
- estimatedexecduration settings are not copied
new TestlinkAPIGeneric and TestlinkAPIClient api methods to modify test cases
- addTestCaseToTestPlan, updateTestCase
- createTestCaseSteps, deleteTestCaseSteps
Known TL 1.9.9 limitations:
- 6109 createTestCaseSteps with action update does not change existing steps
- 6108 createTestCaseSteps creates steps without test case references
- 6102 updateTestCase returns debug informations
- 6101 updateTestCase does not set modification timestamp
new TestlinkAPIGeneric and TestlinkAPIClient api methods to upload attachments
- uploadRequirementSpecificationAttachment, uploadRequirementAttachment
- uploadTestProjectAttachment, uplodTestSuiteAttachment
- uploadTestCaseAttachment
pip install TestLink-API-Python-client
new TestlinkAPIGeneric and TestlinkAPIClient api methods to handle platforms
- createPlatform, getProjectPlatforms
- addPlatformToTestPlan, removePlatformFromTestPlan
Known TL 1.9.9 limitations:
- 6076 addPlatformToTestPlan creates invalid platform links
All v0.4.0 API methods from TestlinkAPIClient are shifted to the new super class TestlinkAPIGeneric and could be used with the new optional argument handling and asked with whatArgs() for there arguments.
- getProject, createTestProject, createTestCase, createTestSuite, createTestPlan, createTestCase
- createBuild, reportTCResult, uploadExecutionAttachment,
- getTestProjectByName, getProjectTestPlans, getTotalsForTestPlan, getBuildsForTestPlan
- getLatestBuildForTestPlan, getTestPlanByName
- getTestSuitesForTestPlan, getTestSuiteByID, getTestSuitesForTestSuite, getFirstLevelTestSuitesForTestProject
- getTestCasesForTestSuite, getTestCasesForTestPlan, getTestCaseIDByName, getFullPath
- getLastExecutionResult, getTestCaseCustomFieldDesignValue, getTestCaseAttachments
Other API methods can be used with the new method
- callServerWithPosArgs(apiMethodame, [apiArgName=apiArgValue])
new class TestlinkAPIGeneric implements the Testlink API methods as generic PY methods
- all arguments of Teslink API are supported as optional arguments
- often used (or mandatory) arguments can be configured as positional arguments
- error handling for TestLink API error codes
class TestlinkAPIClient inherits now from TestlinkAPIGeneric the Testlink API methods
- configuration for positional arguments are consistent with v0.4.0 - except getTestCaseIDByName (see ac6ccf5)
Attention - handling for optional arguments has been changed. Existing code, which uses TestlinkAPIClient, must be adapted. Changes between v0.4.5 and v.0.4.0 are documented in example/TestLinkExample.py
Every implemented API method uses the new method callServerWithPosArgs() to call the server and check the response for error codes.
- If the response include an error code, a TLResponseError is raised
This method can although be used to call not yet implemented API methods.
The Teslink API Client can now be asked, what arguments a API method expects:
import testlink tlh = testlink.TestLinkHelper() tls = tlh.connect(testlink.TestlinkAPIClient) print tls.whatArgs('createTestPlan') createTestPlan(<testplanname>, <testprojectname>, [note=<note>], [active=<active>], [public=<public>], [devKey=<devKey>]) create a test plan
or for a description of all implemented api method
import testlink tlh = testlink.TestLinkHelper() tls = tlh.connect(testlink.TestlinkAPIClient) for m in testlink.testlinkargs._apiMethodsArgs.keys(): print tls.whatArgs(m), '\n'
see Milestone v0.4.5