python3-capsolver 1.1.0__tar.gz → 1.2.0__tar.gz

{python3_capsolver-1.1.0/src/python3_capsolver.egg-info → python3_capsolver-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python3-capsolver
-Version: 1.1.0
+Version: 1.2.0
 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.20,>=0.18
+Requires-Dist: msgspec<=0.21,>=0.18
 Requires-Dist: tenacity<10,>=8
 Dynamic: license-file
 
@@ -61,6 +61,13 @@ 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
+- **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+.
@@ -73,8 +80,74 @@ 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?
 

{python3_capsolver-1.1.0 → python3_capsolver-1.2.0}/README.md

@@ -25,6 +25,13 @@ 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
+- **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+.
@@ -37,8 +44,74 @@ 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?
 

{python3_capsolver-1.1.0 → python3_capsolver-1.2.0}/pyproject.toml

@@ -86,7 +86,7 @@ classifiers = [
 dependencies = [
     "requests>=2.21.0",
     "aiohttp>=3.9.2",
-    "msgspec>=0.18,<0.20",
+    "msgspec>=0.18,<=0.21",
     "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.0/src/python3_capsolver/__version__.py

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

{python3_capsolver-1.1.0 → python3_capsolver-1.2.0}/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.0 → python3_capsolver-1.2.0}/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.0 → python3_capsolver-1.2.0}/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.0 → python3_capsolver-1.2.0}/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.0 → python3_capsolver-1.2.0}/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.0 → python3_capsolver-1.2.0/src/python3_capsolver.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python3-capsolver
-Version: 1.1.0
+Version: 1.2.0
 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.20,>=0.18
+Requires-Dist: msgspec<=0.21,>=0.18
 Requires-Dist: tenacity<10,>=8
 Dynamic: license-file
 
@@ -61,6 +61,13 @@ 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
+- **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+.
@@ -73,8 +80,74 @@ 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?
 

{python3_capsolver-1.1.0 → python3_capsolver-1.2.0}/src/python3_capsolver.egg-info/requires.txt

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

python3_capsolver-1.2.0/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.0/src/python3_capsolver/__version__.py

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

python3_capsolver-1.1.0/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()