Files
the-nexus/tests/quarantine

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

# 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.