Skip to content

Commit 0595f31

Browse files
committed
Update AGENTS.md
1 parent 634a11c commit 0595f31

1 file changed

Lines changed: 9 additions & 3 deletions

File tree

src/python3_capsolver/core/AGENTS.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# CORE MODULE
22

3-
**Generated:** 2026-01-13
3+
**Generated:** 2026-03-15
4+
**Commit:** b797332
45

56
## OVERVIEW
67
Core module provides foundational classes for synchronous (`requests`) and asynchronous (`aiohttp`) captcha solving operations.
@@ -11,13 +12,15 @@ Base classes establish patterns for Sync/Async instruments, enabling dual concur
1112
```
1213
src/python3_capsolver/core/
1314
├── base.py # CaptchaParams entry class (Sync/Async handlers)
14-
├── captcha_instrument.py # CaptchaInstrumentBase, FileInstrument
15+
├── captcha_instrument.py # CaptchaInstrumentBase, FileInstrument (9.3k lines)
1516
├── aio_captcha_instrument.py # AIOCaptchaInstrument (async implementation)
1617
├── sio_captcha_instrument.py # SIOCaptchaInstrument (sync implementation)
1718
├── serializer.py # Request/Response msgspec Struct classes
1819
├── enum.py # EndpointPostfixEnm, CaptchaTypeEnm, ResponseStatusEnm
1920
├── const.py # API URLs, retry configurations
20-
└── utils.py # Utility functions (attempts_generator)
21+
├── utils.py # Utility functions (attempts_generator)
22+
├── context_instr.py # Context manager instrumentation
23+
└── __init__.py # Empty (anti-pattern)
2124
```
2225

2326
## WHERE TO LOOK
@@ -38,3 +41,6 @@ src/python3_capsolver/core/
3841
- **Retries**: `tenacity` for async, `requests.Retry` for sync (5 attempts, exponential backoff)
3942
- **File Processing**: `FileInstrument` handles local files, URLs, and base64 in both sync/async contexts
4043
- **Session Management**: Instruments maintain their own HTTP sessions with retry adapters
44+
45+
## ANTI-PATTERNS (THIS MODULE)
46+
- **Empty `__init__.py`**: Does NOT re-export base classes. Users must import via full path `from python3_capsolver.core.base import CaptchaParams`

0 commit comments

Comments
 (0)