Merge pull request #1 from nassauwinter/server_wrappers

Server wrappers: Zephyr Scale Server API wrappers

Author: nassauwinter

.github/workflows/build_and_load_to_pypi.yaml

@@ -6,7 +6,7 @@ on:
 jobs:
   Build_release:
 
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-20.04
 
     steps:
       - uses: actions/setup-python@v4
@@ -26,7 +26,7 @@ jobs:
 
       - name: Install python dependencies
         run: |
-          cd ${{ github.workspace }}/zephyr-python-api && ls
+          cd ${{ github.workspace }} && ls
           pipenv install --dev
           pipenv run pip list --local
 

.github/workflows/pr_checks.yaml

@@ -0,0 +1,40 @@
+name: PR checks
+on:
+  pull_request:
+    branches: [ main, dev ]
+  push:
+    branches: [ dev ]
+
+jobs:
+  Run_PR_checks:
+
+    runs-on: ubuntu-20.04
+    strategy:
+      matrix:
+        python-version: [ '3.6', '3.7', '3.8', '3.9', '3.10' ]
+
+    steps:
+    - name: Check out repository code
+      uses: actions/checkout@v3
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Update pip and install pipenv
+      run: |
+        pip install --upgrade pip
+        pip install pipenv
+        python --version
+        pip --version
+        pipenv --version
+
+    - name: Install Python dependencies
+      run: |
+        cd ${{ github.workspace }} && ls
+        pipenv install --dev --skip-lock
+        pipenv run pip list --local
+
+    - name: Test with tox
+      run: pipenv run tox

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2022 Petr Sharapenko
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

Pipfile

@@ -13,6 +13,4 @@ pytest-mock = "*"
 pylint = "*"
 build = "*"
 twine = "*"
-
-[requires]
-python_version = "3.8"
+tox-gh-actions = "*"

README.md

@@ -5,13 +5,13 @@
 ![PyPI](https://img.shields.io/pypi/v/zephyr-python-api)
 ![PyPI - License](https://img.shields.io/pypi/l/zephyr-python-api)
 ### Project description
-This is a set of wrappers for Zephyr Scale (TM4J) REST API. This means you can interact with Zephyr Scale without GUI, access it with python code and create automation scripts for your every day interactions. 
-
-NOTE: Currently only Scale Cloud wrappers are implemented. 
+This is a set of wrappers for Zephyr Scale (TM4J) REST API. This means you can interact with Zephyr Scale without GUI, access it with python code and create automation scripts for your every day interactions.
 
 To be done:
-* Scale Server wrappers implementations
-* Usage examples
+* More usage examples
+* Tests, tests and tests for gods of testing
+* Convenient docs
+* Implementing higher level wrappers representing Test Case, Test Cycle, etc.
 
 ### Installation
 
@@ -30,7 +30,7 @@ zscale = ZephyrScale(token=<your_token>)
 
 Zephyr Server (TM4J) auth:
 ```python
-from zephyr import API_V1, ZephyrScale
+from zephyr import ZephyrScale
 
 # Auth can be made with Jira token
 auth = {"token": "<your_jira_token>"}
@@ -41,7 +41,7 @@ auth = {"username": "<your_login>", "password": "<your_password>"}
 # or even session cookie dict
 auth = {"cookies": "<session_cookie_dict>"}
 
-zscale = ZephyrScale(api=API_V1, base_url=<your_base_url>, **auth)
+zscale = ZephyrScale.server_api(base_url=<your_base_url>, **auth)
 ```
 
 Then it is possible to interact with api wrappers:

examples/server.py

@@ -0,0 +1,72 @@
+"""
+Usage examples of Zephyr Scale Server API wrappers.
+"""
+import logging
+
+from zephyr import ZephyrScale
+
+
+# Enable logging with level Debug for more verbosity
+logging.basicConfig(level=logging.DEBUG)
+
+
+# Specify your Jira context to operate with:
+base_url = "https://http://localhost:2990/jira/rest/atm/1.0/"
+
+
+# Deside the type of authorization. It could be a token, username/password or cookies
+auth = {"token": "<your_jira_token>"}
+# auth = {"username": "<your_username>", "password": "your_pass"}
+# auth = {"cookies": "<your_cookie_dict>"}
+
+# Create an instance of Zephyr Scale
+zscale = ZephyrScale.server_api(base_url=base_url, **auth)
+
+
+# Now we can start playing with the Zephyr API!
+test_cases = zscale.api.test_cases
+
+# Get a test case:
+case_data = test_cases.get_test_case("<your_case_id>")
+
+# Create a test case:
+creation_data = test_cases.create_test_case("<your_project_key>", "Test case name")
+
+# Update a test case:
+test_script = {
+    "type": "STEP_BY_STEP",
+    "steps": [
+      {
+        "description": "Description for the step 1",
+        "testData": "Some test data",
+        "expectedResult": "Expectations"
+      },
+      {
+        "description": "Step 2 description",
+        "testData": "Some more test data",
+        "expectedResult": "Expected result for the step 2"
+      }]}
+update_data = test_cases.update_test_case("<your_case_id>",
+                                          objective=f"New_test_objective",
+                                          testScript=test_script)
+
+# Delete a test case:
+deleted = test_cases.delete_test_case("<case_id_you_don't_need_anymore>")
+
+# Get test case attachments:
+attachments = test_cases.get_attachments("<your_case_id>")
+
+# Create a test case attachment (upload):
+upload_result = test_cases.create_attachment("<your_case_id>", "path_to_attachment_file")
+
+# Get the latest execution result for the test case:
+execution_data = test_cases.get_latest_result("<your_case_id>")
+
+# Get attachments for a specified step:
+test_cases.get_step_attachments("<your_case_id>", "<step_id>")
+
+# Create an attachment for step:
+test_cases.create_step_attachment("<your_case_id>", "<step_id>", "path_to_attachment_file")
+
+# Search test cases with JQL:
+search = test_cases.search_cases(query='projectKey = "<your_awesome_porojects_key>"')

setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = zephyr-python-api
-version = 0.0.1.dev2
+version = 0.0.1
 author = Petr Sharapenko
 author_email = nassauwinter@gmail.com
 description = Zephyr (TM4J) Python REST API wrapper
@@ -10,14 +10,17 @@ url = https://github.com/nassauwinter/zephyr-python-api
 project_urls =
     Bug Tracker = https://github.com/nassauwinter/zephyr-python-api/issues
 classifiers =
+    Programming Language :: Python :: 3.6
     Programming Language :: Python :: 3.7
     Programming Language :: Python :: 3.8
+    Programming Language :: Python :: 3.9
+    Programming Language :: Python :: 3.10
     License :: OSI Approved :: Apache Software License
     Operating System :: OS Independent
 
 [options]
 packages = find:
-python_requires = >=3.7
+python_requires = >=3.6
 install_requires =
     requests
 

tests/pytest.ini

@@ -0,0 +1,9 @@
+[pytest]
+markers =
+    unit: test Zephyr Scale modules
+    integration: test integration with Server/Cloud
+
+log_cli = True
+log_cli_level = DEBUG
+log_cli_format = %(asctime)s %(levelname)s %(message)s
+log_cli_date_format = %Y-%m-%d %H:%M:%S