added callbackUrl

Author: AndreiDrang

docs/index.rst

@@ -38,5 +38,6 @@ Check our other projects here - `RedPandaDev group <https://red-panda-dev.xyz/bl
    :maxdepth: 2
    :caption: Additional modules
 
+   modules/core/info.rst
    modules/enum/info.rst
    modules/serializer/info.rst

docs/modules/core/info.rst

@@ -0,0 +1,12 @@
+Core
+====
+
+To import this module:
+
+.. code-block:: python
+
+    from python3_anticaptcha.core import base
+
+
+.. autoclass:: core.base.CaptchaParams
+    :members:

src/python3_anticaptcha/config.py

@@ -4,8 +4,6 @@
 
 urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
 
-callbackUrl: str = ""
-
 
 # Connection retry generator
 def attempts_generator(amount: int = 5) -> Generator:

src/python3_anticaptcha/core/base.py

@@ -9,7 +9,7 @@
 
 class CaptchaParams(SIOContextManager, AIOContextManager):
     """
-    Basic Captcha solving class
+    Basic Captcha params class
 
     Args:
         api_key: Capsolver API key
@@ -29,6 +29,20 @@ def __init__(self, api_key: str, sleep_time: int = 15, *args, **kwargs):
 
         self._captcha_handling_instrument = CaptchaInstrument()
 
+    def set_callback_url(self, callbackUrl: str) -> None:
+        """
+        Method for `callbackUrl` param set.
+
+        Args:
+            callbackUrl: Optional web address where we can send the results of captcha task processing.
+                            Contents are sent by AJAX POST request and are identical
+                                to the contents of getTaskResult method.
+
+        Notes:
+            https://anti-captcha.com/apidoc/methods/createTask
+        """
+        self.create_task_payload.callbackUrl = callbackUrl
+
     def captcha_handler(self, **additional_params) -> dict:
         """
         Synchronous method for captcha solving

src/python3_anticaptcha/core/serializer.py

@@ -4,7 +4,6 @@
 
 from .enum import ResponseStatusEnm
 from .const import APP_KEY
-from ..config import callbackUrl
 
 
 class MyBaseModel(Struct):
@@ -24,7 +23,7 @@ class BaseAPIRequestSer(MyBaseModel):
 class CreateTaskBaseSer(BaseAPIRequestSer):
     task: Dict = {}
     softId: Literal[APP_KEY] = APP_KEY
-    callbackUrl: str = callbackUrl
+    callbackUrl: str = ""
 
 
 class BaseAPIResponseSer(MyBaseModel):

tests/test_core.py

@@ -45,6 +45,16 @@ async def test_aio_create_base_context(self):
         ) as instance:
             pass
 
+    def test_set_callback_url(self):
+        callback_string = self.get_random_string()
+        instance = CaptchaParams(
+            api_key=self.get_random_string(32),
+            sleep_time=self.sleep_time,
+        )
+        instance.set_callback_url(callbackUrl=callback_string)
+
+        assert instance.create_task_payload.callbackUrl == callback_string
+
 
 class TestConfig(BaseTest):
     def test_attempts_generator(self):