Metadata-Version: 2.4
Name: pytest-testinel
Version: 0.5.1
Summary: Testinel’s pytest plugin captures structured test execution data directly from pytest and sends it to Testinel, where your test results become searchable, comparable, and actually useful.
Author: Volodymyr Obrizan
Author-email: Volodymyr Obrizan <obrizan@first.institute>
License-Expression: MIT
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Pytest
Classifier: Topic :: Software Development :: Testing
Requires-Dist: pytest>=7
Requires-Dist: requests>=2
Requires-Python: >=3.10
Project-URL: Homepage, https://testinel.first.institute
Project-URL: Repository, https://github.com/Testinel/pytest-testinel
Project-URL: Issues, https://github.com/Testinel/pytest-testinel/issues
Description-Content-Type: text/markdown

## Official Testinel plugin for pytest

Testinel’s pytest plugin captures structured test execution data directly from pytest and sends it to Testinel, where your test results become searchable, comparable, and actually useful. No log scraping. No brittle CI hacks. Just deterministic test analytics.

## 📦 Getting Started
### Prerequisites

You need a Testinel [account](https://testinel.first.institute/accounts/signup/?next=/projects/) and [project](https://testinel.first.institute/projects/).

### Installation

Getting Testinel into your project is straightforward. Just run this command in your terminal:

```
pip install --upgrade pytest-testinel
```

### Configuration

Set Testinel reporter DSN environment variable `TESTINEL_DSN`.

Examples:

```
# Report to Testinel (HTTPS)
export TESTINEL_DSN="https://your.testinel.endpoint/ingest"
```

```
# Report to a local file (JSON)
export TESTINEL_DSN="file:///tmp/testinel-results.json"
```

```
# Or use a direct file path
export TESTINEL_DSN="./testinel-results.json"
```

### Recommended pytest flags

For better debugging and richer failure context, it is highly recommended to run pytest with:

`--showlocals --tb=long -vv`

Why:

- `--showlocals`: includes local variable values in tracebacks, which makes root-cause analysis much faster.
- `--tb=long`: shows full, non-truncated tracebacks so you can see complete failure paths.
- `-vv`: increases verbosity, showing more detailed test identifiers and execution output.

Example:

```bash
pytest --showlocals --tb=long -vv
```
