# Introduction
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:
## Quick Example:
***
```python
# 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
{% tabs %}
{% tab title="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:
***
{% file src="" %}
Sqlite File
{% endfile %}
Please note the structure could vary over time, but you can get the base idea from the sample file
{% endtab %}
{% tab title="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
{% file src="" %}
Zip File
{% endfile %}
{% endtab %}
{% tab title="Excel File" %}
Execute the command: `handshake patch TestResults -xl`
{% hint style="info" %}
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]"`
{% endhint %}
excel is saved inside the TestResults
Sample File:
***
{% file src="" %}
Excel File
{% endfile %}
{% endtab %}
{% endtabs %}
## 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 ✨
***
{% embed url="" %}
Demo Page for List of Runs
{% endembed %}
## Documentation 📦
***
* [Installation Process](https://rahuls-organization-17.gitbook.io/handshake/installation)
* [Supported Test Frameworks](https://rahuls-organization-17.gitbook.io/handshake/supported-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](https://rahularanger.github.io/handshake/?path=/docs/stories-introduction--docs)
* Interested why? Then, please check out [why](https://rahuls-organization-17.gitbook.io/handshake/why "mention") and [idea](https://rahuls-organization-17.gitbook.io/handshake/idea "mention")
## Bugs/Feature Requests
Please use the [GitHub issue tracker](https://github.com/RahulARanger/handshake/issues) to submit bugs or request features.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://rahuls-organization-17.gitbook.io/handshake/introduction.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
