11# CORE MODULE
22
3- ** Generated:** 2026-01-13
3+ ** Generated:** 2026-03-15
4+ ** Commit:** b797332
45
56## OVERVIEW
67Core 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```
1213src/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