Skip to main content

Python API for Kiwi TCMS

https://travis-ci.org/kiwitcms/tcms-api.svg?branch=master https://ci.appveyor.com/api/projects/status/jhuyyt9vrpaxagrk?svg=true Documentation Code coverage Tidelift Become a sponsor Kiwi TCMS on Twitter

This package allows to connect and access Kiwi TCMS API.

DOCUMENTATION

https://tcms-api.readthedocs.io/en/latest/modules/tcms_api.html

CHANGELOG

v12.8 (17 Dec 2023)

  • When creating a TestPlan limit name to 255 characters

  • When creating a TestCase limit summary to 255 characters

v12.7 (10 Dec 2023)

  • Build & test this package with Python 3.11

  • Replace urllib.parse functions deprecated since Python 3.8

  • Refactor issues reported by newer version of pylint

  • Refactor issues reported by CodeQL

  • Reformat source code with Black

  • Enable ReadTheDocs CI

v12.2 (04 Apr 2023)

  • New arguments for plugin_helpers.Backend.update_test_execution() method. Now accepts the start_date and stop_date arguments at the end of its signature

  • Start testing the client library with Python 3.9

v11.4 (15 Jul 2022)

  • Fallback to C:tcms.conf in case we’re on Windows

  • [pre-commit.ci] pre-commit autoupdate

v11.3 (17 May 2022)

  • Make it possible for plugins to print info about created/reused TP/TR

  • Specify start_date when creating a TestRun

v11.2 (15 May 2022)

  • Make plugin prefix configurable via TCMS_PREFIX environment variable. Fixes Issue #6

  • Use TCMS_PARENT_PLAN environment variable if specified. Will configure a parent TestPlan. Fixes Issue #4

  • Introduce plugin_helpers.Backend.name and plugin_helpers.Backend.version attributes

  • Convert plugin_helpers.Backend.default_tester_id into a cached property

  • Use the account sending the API request if default_tester_id is None. That avoide the use of User.filter API method for which most users may not be authorized

  • Sanity check and sanitize URL config. Refs Issue #45

v11.1 (13 May 2022)

  • Allow the environment variable TCMS_DEFAULT_TESTER_ID to override internal queries, pointing directly to the user who will create new test plans, test runs and update test executions.

  • Internal updates around CI

v11.0 (05 Dec 2021)

WARNING: contains backwards incompatible changes!

  • Method plugin_helpers.Backend.add_test_case_to_run() now returns a list

  • Adjust internal API calls for upcoming Kiwi TCMS v11.0

  • Still compatible with Kiwi TCMS v10.x API

  • Start using f-strings. Available since Python 3.6 which is the minimum required version for tcms-api anyway

v10.0 (02 March 2021)

WARNING: contains backwards incompatible changes!

  • Compatible with Kiwi TCMS v10.0 or later

v9.0 (12 January 2021)

WARNING: contains backwards incompatible changes!

  • Compatible with Kiwi TCMS v9.0 or later

  • Method Backend.build_id() doesn’t receive product_id as firsts parameter anymore! Related to Kiwi TCMS Issue #246

v8.6.0 (28 October 2020)

  • Use a sub-package to install gssapi, see installation instructions

v8.5.0 (04 August 2020)

  • Fix super() call in CookieTransport class to make this package compatible with Python 3.8 (Václav Klikar)

v8.4.0 (25 June 2020)

  • Add instructions how to install gssapi because they don’t ship binary packages on Linux

  • Provide plugin_helpers.Backend.get_statuses_by_weight() and fall-back to it if TestExecutionStatus can’t be found by name. This is to be used by Kiwi TCMS plugins (Bryan Mutai)

v8.3.0 (10 April 2020)

  • Use gssapi library for kerberos communications on both Linux and Windows

  • Requires MIT Kerberos for Windows, see installation instructions

v8.2.0 (02 April 2020)

This version adds additional methods and functionality that can be used by Kiwi TCMS plugins written in Python.

  • Modify plugin_helpers.Backend.test_case_get_or_create() to return tuple (dict, bool). WARNING: this will break existing plugins

  • plugin_helpers.Backend will use TCMS_PLAN_ID environment variable if specified. This allows the user to select an existing TestPlan to save new results into. Fixes Issue #5

  • Add plugin_helpers.Backend.finish_test_run() which may be called by plugins to indicate that a TestRun has been finished

  • Add plugin_helpers.Backend.default_tester_id() and update TestExecution.tested_by when changing status

  • Use default_tester_id() when creating a new TestRun

  • When creating new test run always set TR.manager := TP.author and make sure that TestPlan.create() will also specify author

v8.1.1 (23 March 2020)

  • Use winkerberos dependency on Microsoft Windows platform (@mtg-edmund-tse)

  • Setting rename in config file: use_mod_kerb -> use_kerberos

  • Bug-fix: don’t fall back to user/pass if kerberos is configured

  • Bug-fix: send correctly formatted authorization request header, per RFC-4459

  • Bug-fix: properly authenticate with Kiwi TCMS via kerberos ticket if requested to do so

  • Start sending User-Agent: tcms-api/<version> for all requests

  • Enable integration testing with and without Kerberos

  • Enable testing on Windows

v8.0.1 (10 February 2020)

This version is compatible only with Kiwi TCMS v8.0 or later!

  • Do not use deprecated field product in TestCase.create API method

  • Set TestCase.is_automated to True

v8.0 (09 February 2020)

This version is compatible only with Kiwi TCMS v8.0 or later!

  • Adjusts plugin_helpers module to reflect backwards incompatible API changes introduced in Kiwi TCMS v8.0

v6.7.1 (07 February 2020)

  • Fix a bug in how use_mod_kerb setting was evaluated which lead to always preferring Kerberos which in turn was causing issues on Windows.

v6.7 (10 April 2019)

This version is compatible only with Kiwi TCMS v6.7 or later! For older server versions use tcms-api==5.3!

This version contains breaking changes in plugin_helpers!

  • Switch from TestCaseRun to TestExecution API. Fixes Issue #7

  • Rename plugin_helpers.Backend.update_test_case_run() to plugin_helpers.Backend.update_test_execution()

Metadata

Release files for tcms-api 12.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tcms-api 12.8
File Size Uploaded Provenance Actions
tcms-api-12.8.tar.gz 25.2 kB Without provenance Details for tcms-api-12.8.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tcms-api 12.8
File Interpreter ABI Platform Actions
tcms_api-12.8-py3-none-any.whl Python 3 none any Details for tcms_api-12.8-py3-none-any.whl

Total release size: 48.4 kB

Release files / tcms-api-12.8.tar.gz

Download URL tcms-api-12.8.tar.gz
Size 25.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d8942f8123e234ca4eef109234c100eac38d05c68d849d092ce39c07ffbde25b
BLAKE2b-256 checksum
How to use checksums
51d641ce260be7d372a56714f2a61449cc113a17c53c2e7c246fc696d125371d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.13

Release files / tcms_api-12.8-py3-none-any.whl

Download URL tcms_api-12.8-py3-none-any.whl
Size 23.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
087ead04734f16773e240654714bbe54006c27cc4e45f5f449feeec26a2ed407
BLAKE2b-256 checksum
How to use checksums
6acbcaf87502d3219b36d2aebc739138e57bc41be0e0ab667810371816c7e96f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.13

Security for tcms-api 12.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

12.8 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page