# adaptavist
This python package provides functionality for Jira Test Management ([tm4j](https://www.adaptavist.com/doco/display/KT/Managing+Tests+From+the+REST+API)).
## Table of Contents
- [Installation](#installation)
- [Getting Started](#getting-started)
- [Examples and Features](#examples-and-features)
- [General Workflow](#general-workflow)
## Installation
To install adaptavist, you can use the following command(s):
```bash
python -m pip install adaptavist
```
To uninstall adaptavist, you can use the following command:
```bash
python -m pip uninstall adaptavist
```
## Getting Started
adaptavist is using the REST API of Adaptavist Test Management for Jira Server (see https://docs.adaptavist.io/tm4j/server/api/) and Jira's internal REST API, both with HTTP Basic authentication.
In order to access Adaptavist/Jira, valid credentials are necessary. In addition, `getpass.getuser().lower()` must be a known Jira user as well.
## Examples and Features
### General Workflow
```python
from adaptavist import Adaptavist
# create a new instance
atm = Adaptavist(jira_server, jira_username, jira_password)
# create a test plan
test_plan_key = atm.create_test_plan(project_key="TEST", test_plan_name="my test plan")
# create a test cycle (formerly test run) with a set of test cases and add it to test plan
test_run_key = atm.create_test_run(project_key="TEST", test_run_name="my test cycle", test_cases=["TEST-T1"], test_plan_key=test_plan_key)
# as test cycle creation also creates/initializes test results, we can just edit these
atm.edit_test_script_status(test_run_key=test_run_key, test_case_key="TEST-T1", step=1, status="Pass")
# (optional) edit/overwrite the overall execution status of the test case (by default this is done automatically when editing status of a single step)
atm.edit_test_result_status(test_run_key=test_run_key, test_case_key="TEST-T1", status="Pass")
```
There's much more inside (like adding attachments, creating folders and environments, cloning test cycles). Additional code examples will follow.
Raw data
{
"_id": null,
"home_page": "https://github.com/devolo/adaptavist",
"name": "adaptavist-fixed",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "python adaptavist kanoah tm4j jira test testmanagement report",
"author": "Stephan Steinberg, Guido Schmitz, Markus Bong",
"author_email": "guido.schmitz@devolo.de, markus.bong@devolo.de",
"download_url": "https://files.pythonhosted.org/packages/25/47/66726ea48c736fb1ed5c9770ca111abbf03671389f8f576f64b7e5ddcb82/adaptavist_fixed-0.4.tar.gz",
"platform": "any",
"description": "# adaptavist\n\nThis python package provides functionality for Jira Test Management ([tm4j](https://www.adaptavist.com/doco/display/KT/Managing+Tests+From+the+REST+API)).\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Getting Started](#getting-started)\n- [Examples and Features](#examples-and-features)\n- [General Workflow](#general-workflow)\n\n## Installation\n\nTo install adaptavist, you can use the following command(s):\n\n```bash\npython -m pip install adaptavist\n```\n\nTo uninstall adaptavist, you can use the following command:\n\n```bash\npython -m pip uninstall adaptavist\n```\n\n## Getting Started\n\nadaptavist is using the REST API of Adaptavist Test Management for Jira Server (see https://docs.adaptavist.io/tm4j/server/api/) and Jira's internal REST API, both with HTTP Basic authentication.\n\nIn order to access Adaptavist/Jira, valid credentials are necessary. In addition, `getpass.getuser().lower()` must be a known Jira user as well.\n\n## Examples and Features\n\n### General Workflow\n\n ```python\n from adaptavist import Adaptavist\n\n # create a new instance\n atm = Adaptavist(jira_server, jira_username, jira_password)\n\n # create a test plan\n test_plan_key = atm.create_test_plan(project_key=\"TEST\", test_plan_name=\"my test plan\")\n\n # create a test cycle (formerly test run) with a set of test cases and add it to test plan\n test_run_key = atm.create_test_run(project_key=\"TEST\", test_run_name=\"my test cycle\", test_cases=[\"TEST-T1\"], test_plan_key=test_plan_key)\n\n # as test cycle creation also creates/initializes test results, we can just edit these\n atm.edit_test_script_status(test_run_key=test_run_key, test_case_key=\"TEST-T1\", step=1, status=\"Pass\")\n\n # (optional) edit/overwrite the overall execution status of the test case (by default this is done automatically when editing status of a single step)\n atm.edit_test_result_status(test_run_key=test_run_key, test_case_key=\"TEST-T1\", status=\"Pass\")\n\n ```\n\nThere's much more inside (like adding attachments, creating folders and environments, cloning test cycles). Additional code examples will follow.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "python package providing functionality for Jira Test Management (tm4j)",
"version": "0.4",
"project_urls": {
"Homepage": "https://github.com/devolo/adaptavist"
},
"split_keywords": [
"python",
"adaptavist",
"kanoah",
"tm4j",
"jira",
"test",
"testmanagement",
"report"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4754c5c75ddafe0d89be4553bf5e65e792b6218544e46a6eb7e471ccfb87c862",
"md5": "a9f37aa2ef953b2a1b50ce36981d5259",
"sha256": "934e5857e3d0faa75f00c6f399430761cc654dc8b2ebeb41009056f21926586b"
},
"downloads": -1,
"filename": "adaptavist_fixed-0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a9f37aa2ef953b2a1b50ce36981d5259",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 13460,
"upload_time": "2023-11-08T18:50:55",
"upload_time_iso_8601": "2023-11-08T18:50:55.486252Z",
"url": "https://files.pythonhosted.org/packages/47/54/c5c75ddafe0d89be4553bf5e65e792b6218544e46a6eb7e471ccfb87c862/adaptavist_fixed-0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "254766726ea48c736fb1ed5c9770ca111abbf03671389f8f576f64b7e5ddcb82",
"md5": "c644ed7640b5643bf6ae006069ea34e2",
"sha256": "660a553735306c69c2247b292076f36e856fef02e16168cd045f3d654a5b5bfc"
},
"downloads": -1,
"filename": "adaptavist_fixed-0.4.tar.gz",
"has_sig": false,
"md5_digest": "c644ed7640b5643bf6ae006069ea34e2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 27657,
"upload_time": "2023-11-08T18:50:57",
"upload_time_iso_8601": "2023-11-08T18:50:57.024492Z",
"url": "https://files.pythonhosted.org/packages/25/47/66726ea48c736fb1ed5c9770ca111abbf03671389f8f576f64b7e5ddcb82/adaptavist_fixed-0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-08 18:50:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "devolo",
"github_project": "adaptavist",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "adaptavist-fixed"
}