python3-capsolver 0.9.4__tar.gz → 1.0.1__tar.gz

{python3_capsolver-0.9.4/src/python3_capsolver.egg-info → python3_capsolver-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: python3-capsolver
-Version: 0.9.4
+Version: 1.0.1
 Summary: Python 3.8+ Capsolver library with AIO module.
 Author-email: AndreiDrang <python-captcha@pm.me>
 License: MIT License
@@ -30,18 +30,19 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.21.0
 Requires-Dist: aiohttp>=3.9.2
-Requires-Dist: pydantic>=2.5.0
+Requires-Dist: msgspec<0.20,>=0.18
 Requires-Dist: tenacity<10,>=8
 
 # python3-capsolver
 
-![Logo](https://red-panda-dev.xyz/media/images/Capsolver_ugBYrN0.original.png)
+[![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)
@@ -55,17 +56,10 @@ Requires-Dist: tenacity<10,>=8
 
 
 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.
 
-***
-
-If you have any questions, please send a message to the [Telegram](https://t.me/pythoncaptcha) chat room.
-
-Or email python-captcha@pm.me
-
 ## How to install?
 
 We recommend using the latest version of Python. `python3-capsolver` supports Python 3.7+.
@@ -93,4 +87,10 @@ 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](files/img.png)
+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-0.9.4 → python3_capsolver-1.0.1}/README.md

@@ -1,12 +1,13 @@
 # python3-capsolver
 
-![Logo](https://red-panda-dev.xyz/media/images/Capsolver_ugBYrN0.original.png)
+[![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)
@@ -20,17 +21,10 @@
 
 
 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.
 
-***
-
-If you have any questions, please send a message to the [Telegram](https://t.me/pythoncaptcha) chat room.
-
-Or email python-captcha@pm.me
-
 ## How to install?
 
 We recommend using the latest version of Python. `python3-capsolver` supports Python 3.7+.
@@ -58,4 +52,10 @@ 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](files/img.png)
+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-0.9.4 → python3_capsolver-1.0.1}/pyproject.toml

@@ -24,6 +24,7 @@ length_sort = true
 [tool.pytest.ini_options]
 minversion = "7.0"
 asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
 testpaths = [
     "tests",
 ]
@@ -85,7 +86,7 @@ classifiers = [
 dependencies = [
     "requests>=2.21.0",
     "aiohttp>=3.9.2",
-    "pydantic>=2.5.0",
+    "msgspec>=0.18,<0.20",
     "tenacity>=8,<10"
 ]
 

python3_capsolver-1.0.1/src/python3_capsolver/__version__.py

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

python3_capsolver-1.0.1/src/python3_capsolver/aws_waf.py

@@ -0,0 +1,138 @@
+from typing import Union
+
+from .core.base import CaptchaParams
+from .core.enum import CaptchaTypeEnm
+
+__all__ = ("AwsWaf",)
+
+
+class AwsWaf(CaptchaParams):
+    """
+    The class is used to work with Capsolver AwsWaf methods:
+     - AntiAwsWafTask
+     - AntiAwsWafTaskProxyLess
+     - AwsWafClassification
+
+    Args:
+        api_key: Capsolver API key
+        captcha_type: Captcha type name, like ``AntiAwsWafTask`` and etc.
+        kwargs: additional params for client, like captcha waiting time
+                    available keys:
+                     - sleep_time: int - captcha solution waintig time in sec
+                     - request_url: str - API address for sending requests,
+                                            else official will be used
+
+
+    Examples:
+        >>> from python3_capsolver.aws_waf import AwsWaf
+        >>> from python3_capsolver.core.captcha_instrument import FileInstrument
+        >>> image = FileInstrument().file_processing(captcha_file="waf_captcha.png")
+        >>>  AwsWaf(api_key="CAP-XXXXX",
+        ...         captcha_type=CaptchaTypeEnm.AwsWafClassification
+        ...         ).captcha_handler(task_payload={
+        ...                                 "images": [image],
+        ...                                 "question": "some question",
+        ...                                 "websiteURL": "https://xxxx.com",
+        ...                         })
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                //carcity point
+                "box": [
+                    116.7,
+                    164.1
+                ],
+                // grid type, objects means the image index that matches the question
+                "objects": [0, 1, 3, 4, 6],
+                //if question include `bifurcatedzoo`
+                "distance": 500
+            }
+        }
+
+
+        >>> import asyncio
+        >>> from python3_capsolver.aws_waf import AwsWaf
+        >>> from python3_capsolver.core.captcha_instrument import FileInstrument
+        >>> image = FileInstrument().file_processing(captcha_file="waf_captcha.png")
+        >>> asyncio.run(AwsWaf(api_key="CAP-XXXXX",
+        ...         captcha_type=CaptchaTypeEnm.AwsWafClassification
+        ...         ).aio_captcha_handler(task_payload={
+        ...                                 "images": [image],
+        ...                                 "question": "some question",
+        ...                                 "websiteURL": "https://xxxx.com",
+        ...                         }))
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                //carcity point
+                "box": [
+                    116.7,
+                    164.1
+                ],
+                // grid type, objects means the image index that matches the question
+                "objects": [0, 1, 3, 4, 6],
+                //if question include `bifurcatedzoo`
+                "distance": 500
+            }
+        }
+
+        >>> from python3_capsolver.aws_waf import AwsWaf
+        >>> from python3_capsolver.core.captcha_instrument import FileInstrument
+        >>> image = FileInstrument().file_processing(captcha_file="waf_captcha.png")
+        >>>  AwsWaf(api_key="CAP-XXXXX",
+        ...         captcha_type=CaptchaTypeEnm.AntiAwsWafTaskProxyLess
+        ...         ).captcha_handler(task_payload={
+        ...                                 "websiteURL": "https://xxxxxx/latest",
+        ...                                 "awsKey": "AQIDAHjcYu/GjX+QlghicBg......shMIKvZswZemrVVqA==",
+        ...                                 "awsChallengeJS": "https://xxxxx/challenge.js",
+        ...                         })
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                "cookie": "223d1f60-xxxxxxxx"
+            }
+        }
+
+        >>> from python3_capsolver.aws_waf import AwsWaf
+        >>> from python3_capsolver.core.captcha_instrument import FileInstrument
+        >>> image = FileInstrument().file_processing(captcha_file="waf_captcha.png")
+        >>>  AwsWaf(api_key="CAP-XXXXX",
+        ...         captcha_type=CaptchaTypeEnm.AntiAwsWafTask
+        ...         ).captcha_handler(task_payload={
+        ...                                 "websiteURL": "https://xxxxxx/latest",
+        ...                                 "awsKey": "AQIDAHjcYu/GjX+QlghicBg......shMIKvZswZemrVVqA==",
+        ...                                 "awsChallengeJS": "https://xxxxx/challenge.js",
+        ...                                 "proxy": "ip:port:user:pass"
+        ...                         })
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                "cookie": "223d1f60-xxxxxxxx"
+            }
+        }
+
+    Notes:
+        https://docs.capsolver.com/en/guide/captcha/awsWaf/
+
+        https://docs.capsolver.com/en/guide/recognition/AwsWafClassification/
+    """
+
+    def __init__(self, api_key: str, captcha_type: Union[CaptchaTypeEnm, str], **kwargs):
+
+        super().__init__(api_key=api_key, captcha_type=captcha_type, **kwargs)

python3_capsolver-1.0.1/src/python3_capsolver/cloudflare.py

@@ -0,0 +1,131 @@
+from typing import Union
+
+from .core.base import CaptchaParams
+from .core.enum import CaptchaTypeEnm
+
+__all__ = ("Cloudflare",)
+
+
+class Cloudflare(CaptchaParams):
+    """
+    The class is used to work with Capsolver AntiTurnstileTaskProxyLess captcha solving method
+
+    Args:
+        api_key: Capsolver API key
+        captcha_type: Captcha type name, like ``AntiTurnstileTaskProxyLess`` and etc.
+        kwargs: additional params for client, like captcha waiting time
+                    available keys:
+                     - sleep_time: int - captcha solution waintig time in sec
+                     - request_url: str - API address for sending requests,
+                                            else official will be used
+
+    Examples:
+        >>> from python3_capsolver.cloudflare import Cloudflare
+        >>> from python3_capsolver.core.enum import CaptchaTypeEnm
+        >>> Cloudflare(api_key="CAI-12345....",
+        ...             captcha_type=CaptchaTypeEnm.AntiTurnstileTaskProxyLess)
+        ...         .captcha_handler(task_payload={
+        ...                     "websiteKey": "0x4XXXXXXXXXXXXXXXXX",
+        ...                     "metadata": {
+        ...                         "action": "login",
+        ...                         "cdata": "0000-1111-2222-3333-example-cdata"
+        ...                     }
+        ...         })
+        {
+           "errorId":0,
+           "errorCode":"None",
+           "errorDescription":"None",
+           "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+           "status":"ready",
+           "solution":{
+                "token": "0.mF74FV8wEufAWxxxx",
+                "type": "turnstile",
+                "userAgent": "Mozilla/5.0 xxxx"
+           }
+        }
+
+        >>> from python3_capsolver.cloudflare import Cloudflare
+        >>> from python3_capsolver.core.enum import CaptchaTypeEnm
+        >>> Cloudflare(api_key="CAI-12345....",
+        ...             captcha_type=CaptchaTypeEnm.AntiCloudflareTask)
+        ...         .captcha_handler(task_payload={
+        ...                     "websiteURL": "https://www.yourwebsite.com",
+        ...                     "proxy": "ip:port:user:pass",
+        ...         })
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                "cookies": "cf_clearance=_VPxxxx",
+                "headers": {
+                    "sec-ch-ua": "\"Chromium\";v=\"130\", \"Google Chrome\";v=\"130\", \"Not?A_Brand\";v=\"99\"",
+                    "sec-ch-ua-platform": "\"Windows\"",
+                    "accept": "text/html,axxxx",
+                    "User-Agent": "Mozilla/5.0xxxx",
+                    "sec-ch-ua-mobile": "?0",
+                    "sec-fetch-user": "?1",
+                    "referer": "https://www.yourwebsite.com",
+                    "Sec-Fetch-Dest": "document",
+                    "Sec-Fetch-Mode": "navigate",
+                    "Sec-Fetch-Site": "same-origin",
+                    "accept-language": "en",
+                },
+                "page_url": "https://www.yourwebsite.com",
+                "proxy": "your proxyxxxx",
+                "token": "_VPCTZXP5bhinxxxx"
+            }
+        }
+
+        >>> import asyncio
+        >>> from python3_capsolver.cloudflare import Cloudflare
+        >>> from python3_capsolver.core.enum import CaptchaTypeEnm
+        >>> asyncio.run(Cloudflare(api_key="CAI-12345....",
+        ...             captcha_type=CaptchaTypeEnm.AntiCloudflareTask)
+        ...         .aio_captcha_handler(task_payload={
+        ...                     "websiteURL": "https://www.yourwebsite.com",
+        ...                     "proxy": "ip:port:user:pass",
+        ...         }))
+        {
+            "errorId":0,
+            "errorCode":"None",
+            "errorDescription":"None",
+            "taskId":"db0a3153-621d-4f5e-8554-a1c032597ee7",
+            "status":"ready",
+            "solution":{
+                "cookies": "cf_clearance=_VPxxxx",
+                "headers": {
+                    "sec-ch-ua": "\"Chromium\";v=\"130\", \"Google Chrome\";v=\"130\", \"Not?A_Brand\";v=\"99\"",
+                    "sec-ch-ua-platform": "\"Windows\"",
+                    "accept": "text/html,axxxx",
+                    "User-Agent": "Mozilla/5.0xxxx",
+                    "sec-ch-ua-mobile": "?0",
+                    "sec-fetch-user": "?1",
+                    "referer": "https://www.yourwebsite.com",
+                    "Sec-Fetch-Dest": "document",
+                    "Sec-Fetch-Mode": "navigate",
+                    "Sec-Fetch-Site": "same-origin",
+                    "accept-language": "en",
+                },
+                "page_url": "https://www.yourwebsite.com",
+                "proxy": "your proxyxxxx",
+                "token": "_VPCTZXP5bhinxxxx"
+            }
+        }
+
+    Notes:
+        https://docs.capsolver.com/en/guide/captcha/cloudflare_turnstile/
+
+        https://docs.capsolver.com/en/guide/captcha/cloudflare_challenge/
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        captcha_type: Union[CaptchaTypeEnm, str] = CaptchaTypeEnm.AntiTurnstileTaskProxyLess,
+        **kwargs,
+    ):
+
+        super().__init__(api_key=api_key, captcha_type=captcha_type, **kwargs)

python3_capsolver-1.0.1/src/python3_capsolver/control.py

@@ -0,0 +1,68 @@
+from .core.base import CaptchaParams
+from .core.enum import CaptchaTypeEnm
+from .core.const import GET_BALANCE_POSTFIX
+from .core.aio_captcha_instrument import AIOCaptchaInstrument
+from .core.sio_captcha_instrument import SIOCaptchaInstrument
+
+__all__ = ("Control",)
+
+
+class Control(CaptchaParams):
+    """
+    The class is used to work with Capsolver control methods.
+
+    Args:
+        api_key: Capsolver API key
+
+    Notes:
+        https://docs.capsolver.com/en/guide/api-getbalance/
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+    ):
+        super().__init__(api_key=api_key, captcha_type=CaptchaTypeEnm.Control)
+
+    def get_balance(self) -> dict:
+        """
+        Synchronous method to view the balance
+
+        Examples:
+            >>> from python3_capsolver.control import Control
+            >>> Control(api_key="CAI-1324...").get_balance()
+            {'balance': 48.6361, 'errorId': 0, 'packages': []}
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            Check class docstring for more info
+        """
+        self._captcha_handling_instrument = SIOCaptchaInstrument(captcha_params=self)
+        return self._captcha_handling_instrument.send_post_request(
+            session=self._captcha_handling_instrument.session,
+            url_postfix=GET_BALANCE_POSTFIX,
+            payload={"clientKey": self.create_task_payload.clientKey},
+        )
+
+    async def aio_get_balance(self) -> dict:
+        """
+        Asynchronous method to view the balance
+
+        Examples:
+        >>> import asyncio
+        >>> from python3_capsolver.control import Control
+        >>> asyncio.run(Control(api_key="CAI-1324...").aio_get_balance())
+        {'balance': 48.6361, 'errorId': 0, 'packages': []}
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            Check class docstring for more info
+        """
+        return await AIOCaptchaInstrument.send_post_request(
+            url_postfix=GET_BALANCE_POSTFIX,
+            payload={"clientKey": self.create_task_payload.clientKey},
+        )

python3_capsolver-1.0.1/src/python3_capsolver/core/aio_captcha_instrument.py

@@ -0,0 +1,109 @@
+import asyncio
+import logging
+from typing import Optional
+from urllib import parse
+
+import aiohttp
+
+from .enum import ResponseStatusEnm, EndpointPostfixEnm
+from .const import REQUEST_URL, VALID_STATUS_CODES, GET_BALANCE_POSTFIX
+from .utils import attempts_generator
+from .serializer import CaptchaResponseSer
+from .captcha_instrument import CaptchaInstrument
+
+__all__ = ("AIOCaptchaInstrument",)
+
+
+class AIOCaptchaInstrument(CaptchaInstrument):
+    """
+    Instrument for working with async captcha
+    """
+
+    def __init__(self, captcha_params: "CaptchaParams"):
+        super().__init__()
+        self.captcha_params = captcha_params
+        self.created_task_data = CaptchaResponseSer
+
+    async def processing_captcha(self) -> dict:
+        self.captcha_params.create_task_payload.task = self.captcha_params.task_params
+        self.created_task_data = CaptchaResponseSer(**await self.__create_task())
+
+        # if task created and already ready - return result
+        if self.created_task_data.errorId == 0 and self.created_task_data.status == ResponseStatusEnm.Processing.value:
+            return (await self.__get_result()).to_dict()
+        elif self.created_task_data.errorId != 0:
+            self.created_task_data.status = ResponseStatusEnm.Failed
+
+        return self.created_task_data.to_dict()
+
+    async def __create_task(self, url_postfix: str = EndpointPostfixEnm.CREATE_TASK.value) -> dict:
+        """
+        Function send the ASYNC request to service and wait for result
+        """
+        async with aiohttp.ClientSession() as session:
+            try:
+                async with session.post(
+                    parse.urljoin(self.captcha_params.request_url, url_postfix),
+                    json=self.captcha_params.create_task_payload.to_dict(),
+                ) as resp:
+                    if resp.status in VALID_STATUS_CODES:
+                        return await resp.json()
+                    else:
+                        raise ValueError(resp.reason)
+            except Exception as error:
+                logging.exception(error)
+                raise
+
+    async def __get_result(self, url_postfix: str = EndpointPostfixEnm.GET_TASK_RESULT.value) -> CaptchaResponseSer:
+        """
+        Function send the ASYNC request to service and wait for result
+        """
+        # initial waiting
+        await asyncio.sleep(self.captcha_params.sleep_time)
+
+        self.captcha_params.get_result_params.taskId = self.created_task_data.taskId
+        attempts = attempts_generator()
+        async with aiohttp.ClientSession() as session:
+            for _ in attempts:
+                try:
+                    async with session.post(
+                        parse.urljoin(self.captcha_params.request_url, url_postfix),
+                        json=self.captcha_params.get_result_params.to_dict(),
+                    ) 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 captcha ready\failed or have unknown status - return exist data
+                                return result_data
+                        else:
+                            raise ValueError(resp.reason)
+                except Exception as error:
+                    logging.exception(error)
+                    raise
+
+                # if captcha just created or in processing now - wait
+                await asyncio.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 = "Captcha not recognized"
+            self.result.taskId = self.created_task_data.taskId
+            self.result.status = ResponseStatusEnm.Failed
+
+    @staticmethod
+    async def send_post_request(payload: Optional[dict] = None, url_postfix: str = GET_BALANCE_POSTFIX) -> dict:
+        """
+        Function send ASYNC request to service and wait for result
+        """
+
+        async with aiohttp.ClientSession() as session:
+            try:
+                async with session.post(parse.urljoin(REQUEST_URL, url_postfix), json=payload) as resp:
+                    if resp.status == 200:
+                        return await resp.json()
+                    else:
+                        raise ValueError(resp.status)
+            except Exception as error:
+                logging.exception(error)
+                raise

python3_capsolver-1.0.1/src/python3_capsolver/core/base.py

@@ -0,0 +1,82 @@
+from typing import Any, Dict
+
+from python3_capsolver.core.enum import CaptchaTypeEnm
+from python3_capsolver.core.serializer import TaskSer
+
+from .const import REQUEST_URL
+from .serializer import RequestCreateTaskSer, RequestGetTaskResultSer
+from .context_instr import AIOContextManager, SIOContextManager
+from .captcha_instrument import CaptchaInstrument
+from .aio_captcha_instrument import AIOCaptchaInstrument
+from .sio_captcha_instrument import SIOCaptchaInstrument
+
+__all__ = ("CaptchaParams",)
+
+
+class CaptchaParams(SIOContextManager, AIOContextManager):
+    """
+    Basic Captcha solving class
+
+    Args:
+        api_key: Capsolver API key
+        captcha_type: Captcha type name, like `ReCaptchaV2Task` and etc.
+        sleep_time: The waiting time between requests to get the result of the Captcha
+        request_url: API address for sending requests
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        captcha_type: CaptchaTypeEnm,
+        sleep_time: int = 5,
+        request_url: str = REQUEST_URL,
+    ):
+        # assign args to validator
+        self.create_task_payload = RequestCreateTaskSer(clientKey=api_key)
+        # `task` body for task creation payload
+        self.task_params = TaskSer(type=captcha_type.value).to_dict()
+        # prepare `get task result` payload
+        self.get_result_params = RequestGetTaskResultSer(clientKey=api_key)
+        self.request_url = request_url
+        self._captcha_handling_instrument = CaptchaInstrument()
+        self.sleep_time = sleep_time
+
+    def captcha_handler(self, task_payload: Dict) -> Dict[str, Any]:
+        """
+        Synchronous method for captcha solving
+
+        Args:
+            task_payload: Some additional parameters that will be used in creating the task
+                            and will be passed to the payload under ``task`` key.
+                            Like ``websiteURL``, ``image``, ``proxyPassword``, ``websiteKey`` and etc.
+                            more info in service docs
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            Check class docstirng for more info
+        """
+        self.task_params.update(task_payload)
+        self._captcha_handling_instrument = SIOCaptchaInstrument(captcha_params=self)
+        return self._captcha_handling_instrument.processing_captcha()
+
+    async def aio_captcha_handler(self, task_payload: Dict) -> Dict[str, Any]:
+        """
+        Asynchronous method for captcha solving
+
+        Args:
+            task_payload: Some additional parameters that will be used in creating the task
+                            and will be passed to the payload under ``task`` key.
+                            Like ``websiteURL``, ``image``, ``proxyPassword``, ``websiteKey`` and etc.
+                            more info in service docs
+
+        Returns:
+            Dict with full server response
+
+        Notes:
+            Check class docstirng for more info
+        """
+        self.task_params.update(task_payload)
+        self._captcha_handling_instrument = AIOCaptchaInstrument(captcha_params=self)
+        return await self._captcha_handling_instrument.processing_captcha()