Skip to content

Commit e5f24a3

Browse files
committed
Update AGENTS.md
1 parent 274a467 commit e5f24a3

1 file changed

Lines changed: 22 additions & 1 deletion

File tree

tests/AGENTS.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# TESTS SUITE
22

3+
**Generated:** 2026-03-15
4+
**Commit:** b797332
5+
36
## OVERVIEW
47
Pytest-based test suite validating API integration, dual-mode (sync/async) operations, and error handling for all captcha services.
58

@@ -8,7 +11,7 @@ Pytest-based test suite validating API integration, dual-mode (sync/async) opera
811
tests/
912
├── conftest.py # BaseTest class, fixtures, test utilities
1013
├── test_*.py # Test modules (match source structure)
11-
└── files/ # Test assets (e.g., captcha_example.jpeg)
14+
└── files/ # Test assets (captcha_example.jpeg)
1215
```
1316

1417
## WHERE TO LOOK
@@ -29,3 +32,21 @@ tests/
2932
- **Context Managers**: Test both `with` and `async with` patterns for resource cleanup.
3033
- **Rate Limiting**: Default delays (1s function, 2s class) to avoid API throttling.
3134
- **Error Testing**: Verify `errorId`, `errorCode`, and `solution=None` for invalid keys.
35+
36+
## COMMANDS
37+
```bash
38+
# Run all tests
39+
uv run pytest tests/
40+
41+
# Run with coverage
42+
make tests # Runs coverage + HTML + XML reports
43+
44+
# Coverage reports
45+
coverage/html/ # HTML report
46+
coverage/coverage.xml # XML for CI
47+
```
48+
49+
## NOTES
50+
- **API Key**: Requires `API_KEY` environment variable
51+
- **Test Files**: 15 test modules, ~1.5k lines total
52+
- **Rate Limiting**: Built-in delays prevent API throttling during test runs

0 commit comments

Comments
 (0)