Metadata-Version: 2.4
Name: pyrept
Version: 1.0.1
Summary: This library generates both HTML and JSON reports for your Nose unit tests, providing a clear and structured overview of test results.
Home-page: https://github.com/pankajnayak1994/pyrept
Download-URL: https://github.com/pankajnayak1994/pyrept
Author: Pankaj Kumar Nayak
Author-email: nayakpankaj2015@gmail.com
License: MIT
Keywords: nose2,testing,reporting,pytest
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Testing
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: jinja2
Requires-Dist: nose2
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: download-url
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# Python Unit Test HTML JSON Report Generator

[![codecov](https://codecov.io/gh/pankajnayak1994/pyrept/graph/badge.svg?token=M0KTUAOO4V)](https://codecov.io/gh/pankajnayak1994/pyrept)
![PyPI - Downloads](https://img.shields.io/pypi/dm/pyrept)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pyrept)
![GitHub contributors](https://img.shields.io/github/contributors/pankajnayak1994/pyrept)

### Introduction
A [Nose2] plugin for generating detailed, searchable, and user-friendly HTML and JSON reports of your test results.

Key Features:

- Rich Test Descriptions: Automatically captures docstrings from tests as descriptions, making the reports more informative and readable.
- Failure Tracebacks: Includes complete traceback details for any failed tests, enabling quick identification and resolution of issues.
- Searchable and Filterable Reports: Allows users to search and filter results by status (e.g., passed, failed, skipped, or error), making it easy to navigate through large test suites.
- Customizable Outputs: Supports customization options to fit specific reporting needs.
- JSON Integration: Provides JSON reports for easy integration with other tools or automated workflows.
- This plugin is ideal for enhancing test visibility and making debugging more efficient.

![Report Screenshot](https://raw.githubusercontent.com/pankajnayak1994/pyrept/master/docs/images/report.png)

### Installation
You can install the Nose2 HTML Report Plugin using `pip`:
```
pip install pyrept
```

### Configuration
To get `nose2` to recognize the plugin add an entry into the `plugin` key of the `unittest` section of your `nose2.cfg` file. Configurations for the plugin should be placed into an `html-report` section of the configuration file. Below is a working example:
```
[unittest]
plugins = pyrept.html_report

[html-report]
always-on = True
```

#### Additional Settings
Specify the path for the HTML report. Defaults to `report.html`
```
[unittest]
plugins = pyrept.html_report

[html-report]
always-on = True
path = test_results/my_custom_report_file.html
```

### Usage
Command line flag:
```
nose2 --html-report
```

If you have `always-on=True` inside your `nose2.cfg`:
```
nose2
```
