https://github.com/cle-b/pytest-httpdbg
A pytest plugin for recording HTTP(S) requests and saving them in your test report.
https://github.com/cle-b/pytest-httpdbg
aiohttp allure allure-report httpdbg httpx pytest pytest-html pytest-plugin requests urllib3
Last synced: 6 days ago
JSON representation
A pytest plugin for recording HTTP(S) requests and saving them in your test report.
- Host: GitHub
- URL: https://github.com/cle-b/pytest-httpdbg
- Owner: cle-b
- License: apache-2.0
- Created: 2023-05-08T19:54:44.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2026-03-29T07:01:02.000Z (10 days ago)
- Last Synced: 2026-03-29T09:18:02.850Z (10 days ago)
- Topics: aiohttp, allure, allure-report, httpdbg, httpx, pytest, pytest-html, pytest-plugin, requests, urllib3
- Language: Python
- Homepage: https://httpdbg.readthedocs.io/en/latest/test/#pytest-httpdbg
- Size: 646 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pytest-httpdbg
A pytest plugin for recording HTTP(S) requests and saving them in your test report.
## installation
```
pip install pytest-httpdbg
```
## Allure report
If you use the [allure-pytest](https://pypi.org/project/allure-pytest/) plugin to generate an [Allure](https://allurereport.org/docs/pytest/) report, you can use [pytest-httpdbg](https://pypi.org/project/pytest-httpdbg/) to include HTTP request traces in your test report without any code modifications.
All you need to do is add the `--httpdbg-allure` option to your pytest command line:
```
pytest ../httpdbg-docs/examples/ --alluredir=./allure-results --httpdbg-allure
```
If an HTTP request is made by the test (or within a fixture, during the setup or teardown phase), a HTTP traces report will be saved in the Allure report under a step called `httpdbg`.
### compact mode
### full mode
## Custom test report
You can add HTTP traces to any test report of your choice. To do this, you can use the HTTP traces saved by the plugin in Markdown format.
When a test finishes (including the teardown step), a log file in Markdown format is generated. The path to this log file is stored in the test item when the test starts (before the setup step), even if the file does not yet exist.
### pytest-html
You can copy the following code in your top-level `conftest.py` to include the logs into your `pytest-html` report.
```python
import os
import pytest
from pytest_httpdbg import httpdbg_record_filename
@pytest.hookimpl(hookwrapper=True)
def pytest_runtest_makereport(item, call):
pytest_html = item.config.pluginmanager.getplugin("html")
outcome = yield
report = outcome.get_result()
extras = getattr(report, "extras", [])
if call.when == "call":
if httpdbg_record_filename in item.stash:
extras.append(
pytest_html.extras.url(
os.path.basename(item.stash[httpdbg_record_filename]),
name="HTTPDBG",
)
)
report.extras = extras
```
This example works if you use the same directory for the html test report file and the httpdbg logs.
`pytest demo/ --httpdbg --httpdbg-dir report --html=report/report.html`
If this is not the case, you must adapt it to your configuration.
## pytest command line options
```
reporting:
--httpdbg record HTTP(S) requests
--httpdbg-dir=HTTPDBG_DIR save httpdbg traces in a directory
--httpdbg-no-clean do not clean the httpdbg directory
--httpdbg-allure save HTTP(S) traces into the allure report
--httpdbg-only-on-failure save the HTTP requests only if the test failed
--httpdbg-initiator=HTTPDBG_INITIATOR add a new initiator (package) for httpdbg
```
## httpdbg
This plugin is based on the [httpdbg](https://pypi.org/project/httpdbg/) Python tool. You can use it to trace all HTTP requests in your tests and view them in a more detailed user interface using the `pyhttpdbg` command.
```
pyhttpdbg -m pytest -v examples/
```
## documentation
https://httpdbg.readthedocs.io/en/latest/test/#pytest-httpdbg