redc 0.1.1.dev1__cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

redc/__init__.py

@@ -0,0 +1,22 @@
+from .callbacks import StreamCallback, ProgressCallback
+from .client import Client
+from .codes import HTTPStatus
+from .exceptions import HTTPError
+from .response import Response
+from . import utils
+
+__all__ = [
+    "Client",
+    "Response",
+    "HTTPError",
+    "HTTPStatus",
+    "StreamCallback",
+    "ProgressCallback",
+    "utils",
+]
+
+__version__ = "0.1.1.dev1"
+__copyright__ = "Copyright (c) 2025 RedC, AYMENJD"
+__license__ = "MIT License"
+
+VERSION = __version__

redc/callback.py

@@ -0,0 +1,19 @@
+import inspect
+from typing import Callable
+
+
+class Callback:
+    def __init__(self, callback: Callable[[bytes, int], None]):
+        self.callback = callback
+        self._validate_callback()
+
+    def _validate_callback(self):
+        signature = inspect.signature(self.callback)
+
+        parameters = signature.parameters
+        num_parameters = len(parameters)
+
+        if num_parameters != 2:
+            raise TypeError(
+                f"Callback function must accept two arguments only callback(data: bytes, total_size: int), but it accepts {num_parameters}."
+            )

redc/callbacks.py

@@ -0,0 +1,81 @@
+import inspect
+from typing import Callable
+
+
+class StreamCallback:
+    """A class for creating a stream callback"""
+
+    def __init__(self, callback: Callable[[bytes, int], None]):
+        """A callback handler for streaming data
+
+        Example:
+            .. code-block:: python
+
+                >>> def callback(data: bytes, data_size: int):
+                ...     print(f"Received {len(data)}")
+                >>> stream_callback = StreamCallback(callback)
+                >>> client.get("https://example.com/", stream_callback=stream_callback)
+
+        Parameters:
+            callback (``Callable[[bytes, int], None]``):
+                A function that accepts two arguments: data (``bytes``) and data_size (``int``)
+                The function cannot be asynchronous
+        """
+
+        self.callback = callback
+        self._validate_callback()
+
+    def _validate_callback(self):
+        if inspect.iscoroutinefunction(self.callback):
+            raise TypeError("Callback function cannot be asynchronous")
+
+        signature = inspect.signature(self.callback)
+
+        parameters = signature.parameters
+        num_parameters = len(parameters)
+
+        if num_parameters != 2:
+            raise TypeError(
+                f"Callback function must accept two arguments only callback(data: bytes, data_size: int) but it accepts {num_parameters}."
+            )
+
+
+class ProgressCallback:
+    """A class for creating a progress callback"""
+
+    def __init__(self, callback: Callable[[int, int, int, int], None]):
+        """A callback handler for progress updates
+
+        Example:
+            .. code-block:: python
+
+                >>> def callback(dltotal: int, dlnow: int, ultotal: int, ulnow: int):
+                ...     print(f"Downloaded {dlnow}/{dltotal}, Uploaded {ulnow}/{ultotal}")
+                >>> progress_callback = ProgressCallback(callback)
+                >>> client.get("https://example.com/", progress_callback=progress_callback)
+
+        Parameters:
+            callback (``Callable[[int, int, int, int], None]``):
+                A function that accepts four arguments:
+                - dltotal (``int``): Total bytes expected to be downloaded
+                - dlnow (``int``): Bytes downloaded so far
+                - ultotal (``int``): Total bytes expected to be uploaded
+                - ulnow (``int``): Bytes uploaded so far
+                The function cannot be asynchronous.
+        """
+
+        self.callback = callback
+        self._validate_callback()
+
+    def _validate_callback(self):
+        if inspect.iscoroutinefunction(self.callback):
+            raise TypeError("Callback function cannot be asynchronous")
+
+        signature = inspect.signature(self.callback)
+        parameters = signature.parameters
+        num_parameters = len(parameters)
+
+        if num_parameters != 4:
+            raise TypeError(
+                f"Callback function must accept exactly four arguments (dltotal: int, dlnow: int, ultotal: int, ulnow: int) but it accepts {num_parameters}."
+            )