python3-capsolver 1.1.1__tar.gz → 1.2.1__tar.gz

{python3_capsolver-1.1.1/src/python3_capsolver.egg-info → python3_capsolver-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python3-capsolver
-Version: 1.1.1
+Version: 1.2.1
 Summary: Python 3.8+ Capsolver library with AIO module.
 Author-email: AndreiDrang <python-captcha@pm.me>
 License: MIT License
@@ -30,7 +30,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.21.0
 Requires-Dist: aiohttp>=3.9.2
-Requires-Dist: msgspec<=0.21,>=0.18
+Requires-Dist: msgspec>=0.18
 Requires-Dist: tenacity<10,>=8
 Dynamic: license-file
 
@@ -61,11 +61,31 @@ Tested on UNIX based OS.
 
 The library is intended for software developers and is used to work with the [Capsolver](https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1) service API.
 
+## Features
+- **Modern Tooling**: Uses `uv` for fast, reliable dependency management and environment isolation.
+- **Sync & Async Support**: Full support for both synchronous (`requests`) and asynchronous (`aiohttp`) operations.
+- **Type Safety**: Enums for captcha types and response statuses.
+- **Resilience**: Built-in retries using `tenacity`.
+- **Performance**: High-speed JSON serialization with `msgspec`.
+- **Coverage**: Supports ReCaptcha (V2/V3), Cloudflare, DataDome, GeeTest, MtCaptcha, AWS WAF, Yandex, and ImageToText.
+
 ## How to install?
 
-We recommend using the latest version of Python. `python3-capsolver` supports Python 3.7+.
+We recommend using the latest version of Python. `python3-capsolver` supports Python 3.8+.
+
+### Development (using uv)
 
-### pip
+This project uses [uv](https://github.com/astral-sh/uv) for fast, reliable dependency management.
+
+```bash
+# Install uv (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install project dependencies
+uv sync --all-groups
+```
+
+### Production (pip)
 
 ```bash
 pip install python3-capsolver
@@ -73,18 +93,99 @@ pip install python3-capsolver
 
 ## How to use?
 
-Is described in the [documentation-website](https://andreidrang.github.io/python3-capsolver/).
+Detailed documentation is available on the [website](https://andreidrang.github.io/python3-capsolver/).
+
+### Quick Start
+
+#### Synchronous Example (ImageToText)
+```python
+from python3_capsolver.image_to_text import ImageToText
 
+# 1. Initialize with API Key
+solver = ImageToText(api_key="YOUR_API_KEY")
+
+# 2. Solve
+result = solver.captcha_handler(
+    task_payload={
+        "body": "base64_encoded_image_string"
+    }
+)
+
+# 3. Check result
+if result["errorId"] == 0:
+    print("Solution:", result["solution"])
+else:
+    print("Error:", result["errorCode"])
+```
+
+#### Asynchronous Example (ReCaptcha)
+```python
+import asyncio
+from python3_capsolver.recaptcha import ReCaptcha
+from python3_capsolver.core.enum import CaptchaTypeEnm
+
+async def main():
+    # 1. Initialize
+    solver = ReCaptcha(
+        api_key="YOUR_API_KEY", 
+        captcha_type=CaptchaTypeEnm.ReCaptchaV2TaskProxyLess
+    )
+
+    # 2. Solve
+    result = await solver.aio_captcha_handler(
+        task_payload={
+            "websiteURL": "https://example.com",
+            "websiteKey": "SITE_KEY"
+        }
+    )
+    
+    print(result)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Supported Captcha Types
+- **ReCaptcha**: V2 (Task/Enterprise), V3 (Task/Enterprise)
+- **HCaptcha**: Task, Enterprise
+- **Cloudflare**: Turnstile
+- **GeeTest**: V3, V4
+- **DataDome**: Slider
+- **MtCaptcha**
+- **AWS WAF**
+- **Yandex SmartCaptcha**
+- **ImageToText**: General image CAPTCHAs
+
+## Documentation & Context (For LLMs)
+- **Project Structure**: See `AGENTS.md` in root and subdirectories for internal architecture.
+- **Entry Points**: `src/python3_capsolver/*.py` contains service-specific classes (e.g., `ReCaptcha`, `HCaptcha`).
+- **Core Logic**: `src/python3_capsolver/core/base.py` handles the API communication loop.
+- **Enums**: Use `python3_capsolver.core.enum` for type-safe parameters.
 
 ## How to test?
 
-1. You need set ``API_KEY`` in your environment(get this value from you account).
-2. Run command ``make tests``, from root directory.
+The project uses `uv` for testing and development tasks.
+
+```bash
+# 1. Set API_KEY in your environment (get this value from your account)
+export API_KEY="your_api_key_here"
+
+# 2. Run tests (uses uv internally)
+make tests
+
+# Other useful make targets:
+# make install     # Install dependencies with uv sync
+# make lint        # Run linting checks
+# make build       # Build the package
+# make doc         # Generate documentation
+```
+
+All `make` commands automatically use `uv` to run commands in the isolated environment.
 
 
 ### Changelog
 
-Check [releases page](https://github.com/AndreiDrang/python3-capsolver/releases).
+See [CHANGELOG.md](https://github.com/AndreiDrang/python3-capsolver/blob/main/CHANGELOG.md) for version history and detailed changes.
 
 ### How to get API Key to work with the library
 1. On the page - https://dashboard.capsolver.com/overview/user-center

python3_capsolver-1.2.1/README.md

@@ -0,0 +1,162 @@
+# python3-capsolver
+
+[![Capsolver.png](https://s.vyjava.xyz/files/2024/12-December/17/109278aa/Capsolver.png)](https://vyjava.xyz/dashboard/image/109278aa-961a-4503-bed0-0a9c838dcef2)
+
+<hr>
+
+[![PyPI version](https://badge.fury.io/py/python3-capsolver.svg)](https://badge.fury.io/py/python3-capsolver)
+[![Python versions](https://img.shields.io/pypi/pyversions/python3-capsolver.svg?logo=python&logoColor=FBE072)](https://badge.fury.io/py/python3-capsolver)
+[![Downloads](https://static.pepy.tech/badge/python3-capsolver/month)](https://pepy.tech/project/python3-capsolver)
+[![Static Badge](https://img.shields.io/badge/docs-Sphinx-green?label=Documentation&labelColor=gray)](https://andreidrang.github.io/python3-capsolver/)
+
+[![Maintainability](https://api.codeclimate.com/v1/badges/3c30167b5fb37a0775ea/maintainability)](https://codeclimate.com/github/AndreiDrang/python3-capsolver/maintainability)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/323d4eda0fe1477bbea8fe8902b9e97e)](https://www.codacy.com/gh/AndreiDrang/python3-capsolver/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=AndreiDrang/python3-capsolver&amp;utm_campaign=Badge_Grade)
+[![codecov](https://codecov.io/gh/AndreiDrang/python3-capsolver/branch/main/graph/badge.svg?token=2L4VVIF4G8)](https://codecov.io/gh/AndreiDrang/python3-capsolver)
+
+[![Sphinx build](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/sphinx.yml/badge.svg?branch=release)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/sphinx.yml)
+[![Build](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/build.yml)
+[![Installation](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/install.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/install.yml)
+[![Tests](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/test.yml)
+[![Lint](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/lint.yml)
+
+
+Python 3 library for [Capsolver](https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1) service API.
+Tested on UNIX based OS.
+
+The library is intended for software developers and is used to work with the [Capsolver](https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1) service API.
+
+## Features
+- **Modern Tooling**: Uses `uv` for fast, reliable dependency management and environment isolation.
+- **Sync & Async Support**: Full support for both synchronous (`requests`) and asynchronous (`aiohttp`) operations.
+- **Type Safety**: Enums for captcha types and response statuses.
+- **Resilience**: Built-in retries using `tenacity`.
+- **Performance**: High-speed JSON serialization with `msgspec`.
+- **Coverage**: Supports ReCaptcha (V2/V3), Cloudflare, DataDome, GeeTest, MtCaptcha, AWS WAF, Yandex, and ImageToText.
+
+## How to install?
+
+We recommend using the latest version of Python. `python3-capsolver` supports Python 3.8+.
+
+### Development (using uv)
+
+This project uses [uv](https://github.com/astral-sh/uv) for fast, reliable dependency management.
+
+```bash
+# Install uv (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install project dependencies
+uv sync --all-groups
+```
+
+### Production (pip)
+
+```bash
+pip install python3-capsolver
+```
+
+## How to use?
+
+Detailed documentation is available on the [website](https://andreidrang.github.io/python3-capsolver/).
+
+### Quick Start
+
+#### Synchronous Example (ImageToText)
+```python
+from python3_capsolver.image_to_text import ImageToText
+
+# 1. Initialize with API Key
+solver = ImageToText(api_key="YOUR_API_KEY")
+
+# 2. Solve
+result = solver.captcha_handler(
+    task_payload={
+        "body": "base64_encoded_image_string"
+    }
+)
+
+# 3. Check result
+if result["errorId"] == 0:
+    print("Solution:", result["solution"])
+else:
+    print("Error:", result["errorCode"])
+```
+
+#### Asynchronous Example (ReCaptcha)
+```python
+import asyncio
+from python3_capsolver.recaptcha import ReCaptcha
+from python3_capsolver.core.enum import CaptchaTypeEnm
+
+async def main():
+    # 1. Initialize
+    solver = ReCaptcha(
+        api_key="YOUR_API_KEY", 
+        captcha_type=CaptchaTypeEnm.ReCaptchaV2TaskProxyLess
+    )
+
+    # 2. Solve
+    result = await solver.aio_captcha_handler(
+        task_payload={
+            "websiteURL": "https://example.com",
+            "websiteKey": "SITE_KEY"
+        }
+    )
+    
+    print(result)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Supported Captcha Types
+- **ReCaptcha**: V2 (Task/Enterprise), V3 (Task/Enterprise)
+- **HCaptcha**: Task, Enterprise
+- **Cloudflare**: Turnstile
+- **GeeTest**: V3, V4
+- **DataDome**: Slider
+- **MtCaptcha**
+- **AWS WAF**
+- **Yandex SmartCaptcha**
+- **ImageToText**: General image CAPTCHAs
+
+## Documentation & Context (For LLMs)
+- **Project Structure**: See `AGENTS.md` in root and subdirectories for internal architecture.
+- **Entry Points**: `src/python3_capsolver/*.py` contains service-specific classes (e.g., `ReCaptcha`, `HCaptcha`).
+- **Core Logic**: `src/python3_capsolver/core/base.py` handles the API communication loop.
+- **Enums**: Use `python3_capsolver.core.enum` for type-safe parameters.
+
+## How to test?
+
+The project uses `uv` for testing and development tasks.
+
+```bash
+# 1. Set API_KEY in your environment (get this value from your account)
+export API_KEY="your_api_key_here"
+
+# 2. Run tests (uses uv internally)
+make tests
+
+# Other useful make targets:
+# make install     # Install dependencies with uv sync
+# make lint        # Run linting checks
+# make build       # Build the package
+# make doc         # Generate documentation
+```
+
+All `make` commands automatically use `uv` to run commands in the isolated environment.
+
+
+### Changelog
+
+See [CHANGELOG.md](https://github.com/AndreiDrang/python3-capsolver/blob/main/CHANGELOG.md) for version history and detailed changes.
+
+### How to get API Key to work with the library
+1. On the page - https://dashboard.capsolver.com/overview/user-center
+2. Find it: [![img.png](https://s.vyjava.xyz/files/2024/12-December/17/ae8d4fbf/img.png)](https://vyjava.xyz/dashboard/image/ae8d4fbf-7451-441d-8984-79b1a7adbe27)
+
+### Contacts
+
+If you have any questions, please send a message to the [Telegram](https://t.me/pythoncaptcha) chat room.
+
+Or email python-captcha@pm.me

{python3_capsolver-1.1.1 → python3_capsolver-1.2.1}/pyproject.toml

@@ -86,7 +86,7 @@ classifiers = [
 dependencies = [
     "requests>=2.21.0",
     "aiohttp>=3.9.2",
-    "msgspec>=0.18,<=0.21",
+    "msgspec>=0.18",
     "tenacity>=8,<10"
 ]
 
@@ -103,3 +103,18 @@ Documentation = "https://andreidrang.github.io/python3-capsolver/"
 Repository = "https://github.com/AndreiDrang/python3-capsolver"
 Issues = "https://github.com/AndreiDrang/python3-capsolver/issues"
 Changelog = "https://github.com/AndreiDrang/python3-capsolver/releases"
+
+[dependency-groups]
+dev = [
+    "autoflake>=2.3.1",
+    "black>=24.8.0",
+    "coverage>=7.6.1",
+    "isort>=5.13.2",
+    "pytest>=8.3.5",
+    "pytest-asyncio>=0.24.0",
+]
+docs = [
+    "myst-parser>=3.0.1",
+    "pallets-sphinx-themes>=2.3.0",
+    "sphinx>=7.1.2",
+]

python3_capsolver-1.2.1/src/python3_capsolver/__version__.py

@@ -0,0 +1 @@
+__version__ = "1.2.1"

{python3_capsolver-1.1.1 → python3_capsolver-1.2.1}/src/python3_capsolver/core/aio_captcha_instrument.py

@@ -30,6 +30,8 @@ class AIOCaptchaInstrument(CaptchaInstrumentBase):
 
         # if task created and already ready - return result
         if self.created_task_data.errorId == 0:
+            if str(self.created_task_data.status).lower() == ResponseStatusEnm.Ready.value:
+                return self.created_task_data.to_dict()
             return (await self.__get_result()).to_dict()
         else:
             self.created_task_data.status = ResponseStatusEnm.Failed
@@ -72,7 +74,10 @@ class AIOCaptchaInstrument(CaptchaInstrumentBase):
                     ) as resp:
                         if resp.status in VALID_STATUS_CODES:
                             result_data = CaptchaResponseSer(**await resp.json())
-                            if result_data.status in (ResponseStatusEnm.Ready, ResponseStatusEnm.Failed):
+                            if result_data.status in (
+                                ResponseStatusEnm.Ready,
+                                ResponseStatusEnm.Failed,
+                            ):
                                 # if captcha ready\failed or have unknown status - return exist data
                                 return result_data
                         else:
@@ -90,10 +95,12 @@ class AIOCaptchaInstrument(CaptchaInstrumentBase):
         self.result.errorDescription = self.CAPTCHA_UNSOLVABLE_DESCRIPTION
         self.result.taskId = self.created_task_data.taskId
         self.result.status = ResponseStatusEnm.Failed
+        return self.result
 
     @staticmethod
     async def send_post_request(
-        payload: Optional[dict] = None, url_postfix: EndpointPostfixEnm = EndpointPostfixEnm.GET_BALANCE
+        payload: Optional[dict] = None,
+        url_postfix: EndpointPostfixEnm = EndpointPostfixEnm.GET_BALANCE,
     ) -> dict:
         """
         Function send ASYNC request to service and wait for result

{python3_capsolver-1.1.1 → python3_capsolver-1.2.1}/src/python3_capsolver/core/captcha_instrument.py

@@ -83,7 +83,10 @@ class FileInstrument:
             async for attempt in ASYNC_RETRIES:
                 with attempt:
                     async with session.get(url=url, **kwargs) as resp:
-                        return await resp.content.read()
+                        if resp.status == 200:
+                            return await resp.content.read()
+                        return b""
+        return b""
 
     def file_processing(
         self,

{python3_capsolver-1.1.1 → python3_capsolver-1.2.1}/src/python3_capsolver/core/serializer.py

@@ -1,12 +1,18 @@
 from enum import Enum
-from typing import Any, Dict, Literal, Optional
+from typing import Any, Dict, Union, Optional
 
 from msgspec import Struct
 
 from .enum import ResponseStatusEnm
 from .const import APP_ID
 
-__all__ = ("PostRequestSer", "TaskSer", "RequestCreateTaskSer", "CaptchaResponseSer", "RequestGetTaskResultSer")
+__all__ = (
+    "PostRequestSer",
+    "TaskSer",
+    "RequestCreateTaskSer",
+    "CaptchaResponseSer",
+    "RequestGetTaskResultSer",
+)
 
 
 class MyBaseModel(Struct):
@@ -36,7 +42,7 @@ class TaskSer(MyBaseModel):
 
 
 class RequestCreateTaskSer(PostRequestSer):
-    appId: Literal[APP_ID] = APP_ID
+    appId: str = APP_ID
 
 
 class RequestGetTaskResultSer(MyBaseModel):
@@ -58,5 +64,5 @@ class ResponseSer(MyBaseModel):
 
 class CaptchaResponseSer(ResponseSer):
     taskId: Optional[str] = None
-    status: ResponseStatusEnm = ResponseStatusEnm.Processing
+    status: Union[ResponseStatusEnm, str] = ResponseStatusEnm.Processing
     solution: Optional[Dict[str, Any]] = None

{python3_capsolver-1.1.1 → python3_capsolver-1.2.1}/src/python3_capsolver/core/sio_captcha_instrument.py

@@ -24,6 +24,7 @@ class SIOCaptchaInstrument(CaptchaInstrumentBase):
         super().__init__()
         self.captcha_params = captcha_params
         self.created_task_data = CaptchaResponseSer
+
         # prepare session
         self.session = requests.Session()
         self.session.mount("http://", HTTPAdapter(max_retries=RETRIES))
@@ -37,6 +38,8 @@ class SIOCaptchaInstrument(CaptchaInstrumentBase):
 
         # if task created and ready - return result
         if self.created_task_data.errorId == 0:
+            if str(self.created_task_data.status).lower() == ResponseStatusEnm.Ready.value:
+                return self.created_task_data.to_dict()
             return self.__get_result().to_dict()
         else:
             self.created_task_data.status = ResponseStatusEnm.Failed
@@ -78,7 +81,10 @@ class SIOCaptchaInstrument(CaptchaInstrumentBase):
                 )
                 if resp.status_code in VALID_STATUS_CODES:
                     result_data = CaptchaResponseSer(**resp.json())
-                    if result_data.status in (ResponseStatusEnm.Ready, ResponseStatusEnm.Failed):
+                    if result_data.status in (
+                        ResponseStatusEnm.Ready,
+                        ResponseStatusEnm.Failed,
+                    ):
                         # if captcha ready\failed or have unknown status - return exist data
                         return result_data
                 else:
@@ -89,12 +95,14 @@ class SIOCaptchaInstrument(CaptchaInstrumentBase):
 
             # if captcha just created or in processing now - wait
             time.sleep(self.captcha_params.sleep_time)
+
         # default response if server is silent
         self.result.errorId = 1
         self.result.errorCode = self.CAPTCHA_UNSOLVABLE
         self.result.errorDescription = self.CAPTCHA_UNSOLVABLE_DESCRIPTION
         self.result.taskId = self.created_task_data.taskId
         self.result.status = ResponseStatusEnm.Failed
+        return self.result
 
     @staticmethod
     def send_post_request(

{python3_capsolver-1.1.1 → python3_capsolver-1.2.1}/src/python3_capsolver/image_to_text.py

@@ -83,7 +83,12 @@ class ImageToText(CaptchaParams):
     """
 
     def __init__(
-        self, api_key: str, captcha_type: Union[CaptchaTypeEnm, str] = CaptchaTypeEnm.ImageToTextTask, **kwargs
+        self,
+        api_key: str,
+        captcha_type: Union[CaptchaTypeEnm, str] = CaptchaTypeEnm.ImageToTextTask,
+        **kwargs,
     ):
+        if isinstance(captcha_type, str):
+            captcha_type = CaptchaTypeEnm(captcha_type)
 
         super().__init__(api_key=api_key, captcha_type=captcha_type, **kwargs)

{python3_capsolver-1.1.1 → python3_capsolver-1.2.1/src/python3_capsolver.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python3-capsolver
-Version: 1.1.1
+Version: 1.2.1
 Summary: Python 3.8+ Capsolver library with AIO module.
 Author-email: AndreiDrang <python-captcha@pm.me>
 License: MIT License
@@ -30,7 +30,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.21.0
 Requires-Dist: aiohttp>=3.9.2
-Requires-Dist: msgspec<=0.21,>=0.18
+Requires-Dist: msgspec>=0.18
 Requires-Dist: tenacity<10,>=8
 Dynamic: license-file
 
@@ -61,11 +61,31 @@ Tested on UNIX based OS.
 
 The library is intended for software developers and is used to work with the [Capsolver](https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1) service API.
 
+## Features
+- **Modern Tooling**: Uses `uv` for fast, reliable dependency management and environment isolation.
+- **Sync & Async Support**: Full support for both synchronous (`requests`) and asynchronous (`aiohttp`) operations.
+- **Type Safety**: Enums for captcha types and response statuses.
+- **Resilience**: Built-in retries using `tenacity`.
+- **Performance**: High-speed JSON serialization with `msgspec`.
+- **Coverage**: Supports ReCaptcha (V2/V3), Cloudflare, DataDome, GeeTest, MtCaptcha, AWS WAF, Yandex, and ImageToText.
+
 ## How to install?
 
-We recommend using the latest version of Python. `python3-capsolver` supports Python 3.7+.
+We recommend using the latest version of Python. `python3-capsolver` supports Python 3.8+.
+
+### Development (using uv)
 
-### pip
+This project uses [uv](https://github.com/astral-sh/uv) for fast, reliable dependency management.
+
+```bash
+# Install uv (if not already installed)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install project dependencies
+uv sync --all-groups
+```
+
+### Production (pip)
 
 ```bash
 pip install python3-capsolver
@@ -73,18 +93,99 @@ pip install python3-capsolver
 
 ## How to use?
 
-Is described in the [documentation-website](https://andreidrang.github.io/python3-capsolver/).
+Detailed documentation is available on the [website](https://andreidrang.github.io/python3-capsolver/).
+
+### Quick Start
+
+#### Synchronous Example (ImageToText)
+```python
+from python3_capsolver.image_to_text import ImageToText
 
+# 1. Initialize with API Key
+solver = ImageToText(api_key="YOUR_API_KEY")
+
+# 2. Solve
+result = solver.captcha_handler(
+    task_payload={
+        "body": "base64_encoded_image_string"
+    }
+)
+
+# 3. Check result
+if result["errorId"] == 0:
+    print("Solution:", result["solution"])
+else:
+    print("Error:", result["errorCode"])
+```
+
+#### Asynchronous Example (ReCaptcha)
+```python
+import asyncio
+from python3_capsolver.recaptcha import ReCaptcha
+from python3_capsolver.core.enum import CaptchaTypeEnm
+
+async def main():
+    # 1. Initialize
+    solver = ReCaptcha(
+        api_key="YOUR_API_KEY", 
+        captcha_type=CaptchaTypeEnm.ReCaptchaV2TaskProxyLess
+    )
+
+    # 2. Solve
+    result = await solver.aio_captcha_handler(
+        task_payload={
+            "websiteURL": "https://example.com",
+            "websiteKey": "SITE_KEY"
+        }
+    )
+    
+    print(result)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Supported Captcha Types
+- **ReCaptcha**: V2 (Task/Enterprise), V3 (Task/Enterprise)
+- **HCaptcha**: Task, Enterprise
+- **Cloudflare**: Turnstile
+- **GeeTest**: V3, V4
+- **DataDome**: Slider
+- **MtCaptcha**
+- **AWS WAF**
+- **Yandex SmartCaptcha**
+- **ImageToText**: General image CAPTCHAs
+
+## Documentation & Context (For LLMs)
+- **Project Structure**: See `AGENTS.md` in root and subdirectories for internal architecture.
+- **Entry Points**: `src/python3_capsolver/*.py` contains service-specific classes (e.g., `ReCaptcha`, `HCaptcha`).
+- **Core Logic**: `src/python3_capsolver/core/base.py` handles the API communication loop.
+- **Enums**: Use `python3_capsolver.core.enum` for type-safe parameters.
 
 ## How to test?
 
-1. You need set ``API_KEY`` in your environment(get this value from you account).
-2. Run command ``make tests``, from root directory.
+The project uses `uv` for testing and development tasks.
+
+```bash
+# 1. Set API_KEY in your environment (get this value from your account)
+export API_KEY="your_api_key_here"
+
+# 2. Run tests (uses uv internally)
+make tests
+
+# Other useful make targets:
+# make install     # Install dependencies with uv sync
+# make lint        # Run linting checks
+# make build       # Build the package
+# make doc         # Generate documentation
+```
+
+All `make` commands automatically use `uv` to run commands in the isolated environment.
 
 
 ### Changelog
 
-Check [releases page](https://github.com/AndreiDrang/python3-capsolver/releases).
+See [CHANGELOG.md](https://github.com/AndreiDrang/python3-capsolver/blob/main/CHANGELOG.md) for version history and detailed changes.
 
 ### How to get API Key to work with the library
 1. On the page - https://dashboard.capsolver.com/overview/user-center

{python3_capsolver-1.1.1 → python3_capsolver-1.2.1}/src/python3_capsolver.egg-info/requires.txt

@@ -1,4 +1,4 @@
 requests>=2.21.0
 aiohttp>=3.9.2
-msgspec<=0.21,>=0.18
+msgspec>=0.18
 tenacity<10,>=8

python3_capsolver-1.2.1/tests/test_control.py

@@ -0,0 +1,175 @@
+import pytest
+from unittest.mock import patch, MagicMock, AsyncMock
+
+from tests.conftest import BaseTest
+from python3_capsolver.control import Control
+
+
+class TestControl(BaseTest):
+    """
+    Success tests
+    """
+
+    def test_get_balance_exist(self):
+        assert "get_balance" in Control.__dict__.keys()
+        assert "aio_get_balance" in Control.__dict__.keys()
+
+    def test_get_balance(self):
+        result = Control(api_key=self.API_KEY).get_balance()
+        assert isinstance(result, dict)
+        assert result["errorId"] == 0
+        assert result["balance"] != 0.0
+
+    async def test_aio_get_balance(self):
+        result = await Control(api_key=self.API_KEY).aio_get_balance()
+        assert isinstance(result, dict)
+        assert result["errorId"] == 0
+        assert result["balance"] != 0.0
+
+    """
+    Failed tests
+    """
+
+    def test_get_balance_api_key_err(self):
+        with pytest.raises(ValueError):
+            Control(api_key=self.get_random_string(36)).get_balance()
+
+    async def test_aio_get_balance_api_key_err(self):
+        with pytest.raises(ValueError):
+            await Control(api_key=self.get_random_string(36)).aio_get_balance()
+
+
+class TestControlMock(BaseTest):
+    """
+    Mocked Unit tests for Control class
+    """
+
+    @patch("python3_capsolver.core.sio_captcha_instrument.requests.Session.post")
+    def test_create_task(self, mock_post):
+        mock_response = MagicMock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {"errorId": 0, "taskId": "test-task-id"}
+        mock_post.return_value = mock_response
+
+        control = Control(api_key="test-key")
+        result = control.create_task({"type": "ImageToTextTask", "body": "base64..."})
+
+        assert result["taskId"] == "test-task-id"
+        assert result["errorId"] == 0
+        mock_post.assert_called_once()
+
+    @patch("python3_capsolver.core.aio_captcha_instrument.aiohttp.ClientSession.post")
+    async def test_aio_create_task(self, mock_post):
+        mock_resp = MagicMock()
+        mock_resp.status = 200
+        mock_resp.json = AsyncMock(
+            return_value={"errorId": 0, "taskId": "test-task-id"}
+        )
+        # Mock async context manager
+        mock_resp.__aenter__.return_value = mock_resp
+        mock_post.return_value = mock_resp
+
+        control = Control(api_key="test-key")
+        result = await control.aio_create_task(
+            {"type": "ImageToTextTask", "body": "base64..."}
+        )
+
+        assert result["taskId"] == "test-task-id"
+        assert result["errorId"] == 0
+
+    @patch("python3_capsolver.core.sio_captcha_instrument.requests.Session.post")
+    def test_get_task_result(self, mock_post):
+        mock_response = MagicMock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {
+            "errorId": 0,
+            "status": "ready",
+            "solution": {"text": "abc"},
+        }
+        mock_post.return_value = mock_response
+
+        control = Control(api_key="test-key")
+        result = control.get_task_result(task_id="test-id")
+
+        assert result["status"] == "ready"
+        assert result["solution"]["text"] == "abc"
+
+    @patch("python3_capsolver.core.aio_captcha_instrument.aiohttp.ClientSession.post")
+    async def test_aio_get_task_result(self, mock_post):
+        mock_resp = MagicMock()
+        mock_resp.status = 200
+        mock_resp.json = AsyncMock(
+            return_value={
+                "errorId": 0,
+                "status": "ready",
+                "solution": {"text": "abc"},
+            }
+        )
+        mock_resp.__aenter__.return_value = mock_resp
+        mock_post.return_value = mock_resp
+
+        control = Control(api_key="test-key")
+        result = await control.aio_get_task_result(task_id="test-id")
+
+        assert result["status"] == "ready"
+        assert result["solution"]["text"] == "abc"
+
+    @patch("python3_capsolver.core.sio_captcha_instrument.requests.Session.post")
+    def test_get_token(self, mock_post):
+        mock_response = MagicMock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {"errorId": 0, "taskId": "token-task-id"}
+        mock_post.return_value = mock_response
+
+        control = Control(api_key="test-key")
+        result = control.get_token(
+            {"type": "ReCaptchaV3TaskProxyLess", "websiteURL": "..."}
+        )
+
+        assert result["taskId"] == "token-task-id"
+
+    @patch("python3_capsolver.core.aio_captcha_instrument.aiohttp.ClientSession.post")
+    async def test_aio_get_token(self, mock_post):
+        mock_resp = MagicMock()
+        mock_resp.status = 200
+        mock_resp.json = AsyncMock(
+            return_value={"errorId": 0, "taskId": "token-task-id"}
+        )
+        mock_resp.__aenter__.return_value = mock_resp
+        mock_post.return_value = mock_resp
+
+        control = Control(api_key="test-key")
+        result = await control.aio_get_token(
+            {"type": "ReCaptchaV3TaskProxyLess", "websiteURL": "..."}
+        )
+
+        assert result["taskId"] == "token-task-id"
+
+    @patch("python3_capsolver.core.sio_captcha_instrument.requests.Session.post")
+    def test_feedback_task(self, mock_post):
+        mock_response = MagicMock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {"errorId": 0, "message": "okay"}
+        mock_post.return_value = mock_response
+
+        control = Control(api_key="test-key")
+        result = control.feedback_task(
+            task_id="test-id", result_payload={"invalid": True}
+        )
+
+        assert result["message"] == "okay"
+
+    @patch("python3_capsolver.core.aio_captcha_instrument.aiohttp.ClientSession.post")
+    async def test_aio_feedback_task(self, mock_post):
+        mock_resp = MagicMock()
+        mock_resp.status = 200
+        mock_resp.json = AsyncMock(return_value={"errorId": 0, "message": "okay"})
+        mock_resp.__aenter__.return_value = mock_resp
+        mock_post.return_value = mock_resp
+
+        control = Control(api_key="test-key")
+        result = await control.aio_feedback_task(
+            task_id="test-id", result_payload={"invalid": True}
+        )
+
+        assert result["message"] == "okay"

python3_capsolver-1.1.1/README.md

@@ -1,61 +0,0 @@
-# python3-capsolver
-
-[![Capsolver.png](https://s.vyjava.xyz/files/2024/12-December/17/109278aa/Capsolver.png)](https://vyjava.xyz/dashboard/image/109278aa-961a-4503-bed0-0a9c838dcef2)
-
-<hr>
-
-[![PyPI version](https://badge.fury.io/py/python3-capsolver.svg)](https://badge.fury.io/py/python3-capsolver)
-[![Python versions](https://img.shields.io/pypi/pyversions/python3-capsolver.svg?logo=python&logoColor=FBE072)](https://badge.fury.io/py/python3-capsolver)
-[![Downloads](https://static.pepy.tech/badge/python3-capsolver/month)](https://pepy.tech/project/python3-capsolver)
-[![Static Badge](https://img.shields.io/badge/docs-Sphinx-green?label=Documentation&labelColor=gray)](https://andreidrang.github.io/python3-capsolver/)
-
-[![Maintainability](https://api.codeclimate.com/v1/badges/3c30167b5fb37a0775ea/maintainability)](https://codeclimate.com/github/AndreiDrang/python3-capsolver/maintainability)
-[![Codacy Badge](https://app.codacy.com/project/badge/Grade/323d4eda0fe1477bbea8fe8902b9e97e)](https://www.codacy.com/gh/AndreiDrang/python3-capsolver/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=AndreiDrang/python3-capsolver&amp;utm_campaign=Badge_Grade)
-[![codecov](https://codecov.io/gh/AndreiDrang/python3-capsolver/branch/main/graph/badge.svg?token=2L4VVIF4G8)](https://codecov.io/gh/AndreiDrang/python3-capsolver)
-
-[![Sphinx build](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/sphinx.yml/badge.svg?branch=release)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/sphinx.yml)
-[![Build](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/build.yml)
-[![Installation](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/install.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/install.yml)
-[![Tests](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/test.yml)
-[![Lint](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-capsolver/actions/workflows/lint.yml)
-
-
-Python 3 library for [Capsolver](https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1) service API.
-Tested on UNIX based OS.
-
-The library is intended for software developers and is used to work with the [Capsolver](https://dashboard.capsolver.com/passport/register?inviteCode=kQTn-tG07Jb1) service API.
-
-## How to install?
-
-We recommend using the latest version of Python. `python3-capsolver` supports Python 3.7+.
-
-### pip
-
-```bash
-pip install python3-capsolver
-```
-
-## How to use?
-
-Is described in the [documentation-website](https://andreidrang.github.io/python3-capsolver/).
-
-
-## How to test?
-
-1. You need set ``API_KEY`` in your environment(get this value from you account).
-2. Run command ``make tests``, from root directory.
-
-
-### Changelog
-
-Check [releases page](https://github.com/AndreiDrang/python3-capsolver/releases).
-
-### How to get API Key to work with the library
-1. On the page - https://dashboard.capsolver.com/overview/user-center
-2. Find it: [![img.png](https://s.vyjava.xyz/files/2024/12-December/17/ae8d4fbf/img.png)](https://vyjava.xyz/dashboard/image/ae8d4fbf-7451-441d-8984-79b1a7adbe27)
-
-### Contacts
-
-If you have any questions, please send a message to the [Telegram](https://t.me/pythoncaptcha) chat room.
-
-Or email python-captcha@pm.me

python3_capsolver-1.1.1/src/python3_capsolver/__version__.py

@@ -1 +0,0 @@
-__version__ = "1.1.1"

python3_capsolver-1.1.1/tests/test_control.py

@@ -1,38 +0,0 @@
-import pytest
-
-from tests.conftest import BaseTest
-from python3_capsolver.control import Control
-
-
-class TestControl(BaseTest):
-    """
-    Success tests
-    """
-
-    def test_get_balance_exist(self):
-        assert "get_balance" in Control.__dict__.keys()
-        assert "aio_get_balance" in Control.__dict__.keys()
-
-    def test_get_balance(self):
-        result = Control(api_key=self.API_KEY).get_balance()
-        assert isinstance(result, dict)
-        assert result["errorId"] == 0
-        assert result["balance"] != 0.0
-
-    async def test_aio_get_balance(self):
-        result = await Control(api_key=self.API_KEY).aio_get_balance()
-        assert isinstance(result, dict)
-        assert result["errorId"] == 0
-        assert result["balance"] != 0.0
-
-    """
-    Failed tests
-    """
-
-    def test_get_balance_api_key_err(self):
-        with pytest.raises(ValueError):
-            Control(api_key=self.get_random_string(36)).get_balance()
-
-    async def test_aio_get_balance_api_key_err(self):
-        with pytest.raises(ValueError):
-            await Control(api_key=self.get_random_string(36)).aio_get_balance()