redc 0.1.0.dev0__cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

redc/__init__.py

@@ -0,0 +1,21 @@
+from .callbacks import StreamCallback
+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",
+    "utils",
+]
+
+__version__ = "0.1.0.dev0"
+__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,40 @@
+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}."
+            )