Cursor rule

1---
2description: Testing conventions (pytest, asyncio, unit vs integration)
3globs: tests/**/*.py
4alwaysApply: false
5---
6 
7# Testing Conventions
8 
9- `pytest` with `asyncio_mode = auto` — write `async def test_*` directly, no
10  per-test `@pytest.mark.asyncio` needed.
11- Test functions take **no docstrings** (the name is the description; ruff `D`
12  rules are disabled under `tests/`). Use a clear `test_<behavior>` name instead.
13- Build event payloads via `tests/factories.py`, not inline dicts, so the event
14  shape stays in one place.
15 
16# Unit vs integration
17 
18- **Unit tests** must be hermetic: mock stores/clients, require no Docker, and
19  run under the default `pytest` invocation.
20- **Integration tests** that need real services (testcontainers / Docker) must be
21  marked `@pytest.mark.integration` (or live in a module marked `pytestmark =
22  pytest.mark.integration`). They are deselected by default; run with
23  `pytest -m integration`.
24 
25# What to cover
26 
27Prioritize business logic and error/degradation paths: retry→backoff→DLQ,
28backpressure (`QueueFull` → 429), cache miss→hit, and graceful degradation when
29ES/Redis are down. Don't test framework behavior.
30