29 lines
883 B
Markdown
29 lines
883 B
Markdown
# tests/quarantine/
|
|
|
|
This directory holds tests that have been **quarantined** because they are
|
|
flaky or temporarily broken. Quarantine keeps the main test suite green while
|
|
ensuring no test is silently deleted or forgotten.
|
|
|
|
## Rules
|
|
|
|
1. Every file here must correspond to an open issue.
|
|
2. Every test here must carry `@pytest.mark.quarantine(reason="#NNN")`.
|
|
3. Quarantined tests are **excluded from the default CI run** but are included
|
|
when you pass `--run-quarantine`.
|
|
4. The quarantine is a **temporary holding area**, not a graveyard. If a
|
|
quarantined test's issue has been open for more than 30 days with no
|
|
progress, escalate it.
|
|
|
|
## Adding a test
|
|
|
|
```python
|
|
# tests/quarantine/test_my_flaky_thing.py
|
|
import pytest
|
|
|
|
@pytest.mark.quarantine(reason="Flaky: #1234")
|
|
def test_my_flaky_thing():
|
|
...
|
|
```
|
|
|
|
See `docs/QUARANTINE_PROCESS.md` for the complete workflow.
|