🍊Introduction

Helpful Reporter for your Test Framework

Handshake simplifies the process of exporting test results and sharing them in various formats. It processes the test results collected from test frameworks and ensures they are simplified for better clarity.

requires python 3.11 or 3.12

PyPI Package: https://pypi.org/project/handshakes/

Quick Example:

---

# content of test_sample.py
def inc(x):
    return x + 1


def test_answer():
    assert inc(3) == 5
    
def test_simple():
    assert inc(3) == 4

Execute these tests and ensure that Handshake is installed. For example, we will use the pytest test framework. We have a custom reporter implemented for pytest, so once the package is installed, you can execute the tests by running: pytest.

Test Results Available

---

TesResults is generated along with the sqlite file

Sqlite File

After running the tests, as shown above, the results are stored in the TeStReSuLtS.db file within the TestResults directory (configurable).

Sample File:

---

112KB

TeStReSuLtS.db

Sqlite File

Please note the structure could vary over time, but you can get the base idea from the sample file

JSON File

after the results are stored in the DB, we can execute a few commands, to export the required results.

Execute: handshake patch TestResults -e json -o JsonReport

Json Report Generated

7KB

JsonReport.zip

archive

Zip File

Excel File

Execute the command: handshake patch TestResults -xl

Please note in order to use Excel export you would need to install optional extras: excel-export

pip install handshakes[excel-export]

or

poetry add "handshakes[excel-export]"

excel is saved inside the TestResults

Sample File:

---

20KB

excel-export.xlsx

Excel File

Features 🗽

---

• Aggregates reports from various test frameworks

• Stores reports in a .sqlite database

• Supports export to Excel

• Supports export to JSON files

• Archives reports of multiple test runs

• Enables grouping of test runs by project name

• Rotates stored test reports

Upcoming features 🐳

---

• Allow Export by HTML (Revamp Designs)

• Write as many custom reporters as possible

• Deliver real-time reports.

• Make sure the Custom Reporter for pytest covers all the features and scenarios

• Improve Docs and Provide Options for Configuring Handshake Reporter

Demo ✨

---

Webpack App

Demo Page for List of Runs

Documentation 📦

---

• Installation Process

• Supported Test Frameworks - While it is not necessary to restrict ourselves to this list, please note that one needs to start and supply results in a specific manner for Handshake to process them. The following custom reporters are available as of now, and additional ones can be provided upon request.

• Storybook

Bugs/Feature Requests

Please use the GitHub issue tracker to submit bugs or request features.