redc 0.1.1__cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

redc/ext/utils/curl_utils.h

@@ -0,0 +1,84 @@
+#ifndef CURL_UTILS_H
+#define CURL_UTILS_H
+
+#include <curl/curl.h>
+
+struct CurlSlist {
+  curl_slist *slist = nullptr;
+
+  CurlSlist() = default;
+
+  ~CurlSlist() {
+    if (slist) {
+      curl_slist_free_all(slist);
+    }
+  }
+
+  CurlSlist(const CurlSlist &) = delete;
+  CurlSlist &operator=(const CurlSlist &) = delete;
+
+  CurlSlist(CurlSlist &&other) noexcept : slist(other.slist) {
+    other.slist = nullptr;
+  }
+
+  CurlSlist &operator=(CurlSlist &&other) noexcept {
+    if (this != &other) {
+      if (slist) {
+        curl_slist_free_all(slist);
+      }
+      slist = other.slist;
+      other.slist = nullptr;
+    }
+    return *this;
+  }
+};
+
+struct CurlMime {
+  curl_mime *mime = nullptr;
+
+  CurlMime() = default;
+
+  ~CurlMime() {
+    if (mime) {
+      curl_mime_free(mime);
+    }
+  }
+
+  CurlMime(const CurlMime &) = delete;
+  CurlMime &operator=(const CurlMime &) = delete;
+
+  CurlMime(CurlMime &&other) noexcept : mime(other.mime) {
+    other.mime = nullptr;
+  }
+
+  CurlMime &operator=(CurlMime &&other) noexcept {
+    if (this != &other) {
+      if (mime) {
+        curl_mime_free(mime);
+      }
+      mime = other.mime;
+      other.mime = nullptr;
+    }
+    return *this;
+  }
+};
+
+class CurlGlobalInit {
+ public:
+  CurlGlobalInit() {
+#if LIBCURL_VERSION_NUM >= 0x070800
+    curl_global_init(CURL_GLOBAL_DEFAULT);
+#endif
+  }
+
+  ~CurlGlobalInit() {
+#if LIBCURL_VERSION_NUM >= 0x070800
+    curl_global_cleanup();
+#endif
+  }
+
+  CurlGlobalInit(const CurlGlobalInit &) = delete;
+  CurlGlobalInit &operator=(const CurlGlobalInit &) = delete;
+};
+
+#endif  // CURL_UTILS_H

redc/response.py

@@ -0,0 +1,68 @@
+from .exceptions import HTTPError
+from .utils import Headers, json_loads
+
+
+class Response:
+    def __init__(
+        self,
+        status_code: int,
+        headers: bytes,
+        response: bytes,
+        curl_code: int,
+        curl_error_message: str,
+        raise_for_status: bool = False,
+    ):
+        """Represents an HTTP response of RedC"""
+
+        self.status_code = status_code
+        """HTTP response status code; If the value is ``-1``, it indicates a cURL error occurred"""
+
+        self.headers = None if status_code == -1 else Headers.parse_headers(headers)
+        """HTTP response headers"""
+
+        self.__response = response
+
+        self.curl_code = curl_code
+        """CURL return code"""
+        self.curl_error_message = curl_error_message
+        """CURL error message"""
+
+        if raise_for_status:
+            self.raise_for_status()
+
+    @property
+    def content(self) -> bytes:
+        """Returns the raw response content"""
+        return self.__response
+
+    @property
+    def ok(self):
+        """Checks if the request is successful and with no errors"""
+        return bool(self)
+
+    def text(self, encoding: str = "utf-8"):
+        """Decodes the response content into a string
+
+        Parameters:
+            encoding (``str``, *optional*):
+                The encoding to use for decoding. Default is "utf-8"
+
+        Returns:
+            ``str``
+        """
+
+        if self.status_code != -1:
+            return self.__response.decode(encoding=encoding)
+
+    def json(self):
+        """Parses the response content as JSON"""
+        if self.status_code != -1:
+            return json_loads(self.__response)
+
+    def raise_for_status(self):
+        """Raises an HTTPError if the response status indicates an error"""
+        if self.status_code == -1 or (400 <= self.status_code <= 599):
+            raise HTTPError(self.status_code, self.curl_code, self.curl_error_message)
+
+    def __bool__(self):
+        return self.status_code != -1 and 200 <= self.status_code <= 299

redc/utils/__init__.py

@@ -0,0 +1,5 @@
+__all__ = ["check_key_dict", "Headers", "json_dumps", "json_loads", "parse_base_url"]
+
+from .headers import check_key_dict, Headers
+from .json_encoder import json_dumps, json_loads
+from .http import parse_base_url

redc/utils/headers.py

@@ -0,0 +1,60 @@
+def check_key_dict(key: str, data: dict):
+    key = key.lower()
+    for k in data.keys():
+        if key == k.lower():
+            return True
+
+    return False
+
+
+class Headers(dict):
+    def __init__(self, *args, **kwargs):
+        super().__init__()
+        self.update(*args, **kwargs)
+
+    def __setitem__(self, key, value):
+        super().__setitem__(key.lower(), value)
+
+    def __getitem__(self, key):
+        return super().__getitem__(key.lower())
+
+    def __delitem__(self, key):
+        super().__delitem__(key.lower())
+
+    def __contains__(self, key):
+        return super().__contains__(key.lower())
+
+    def get(self, key, default=None):
+        return super().get(key.lower(), default)
+
+    def pop(self, key, default=None):
+        return super().pop(key.lower(), default)
+
+    def setdefault(self, key, default=None):
+        return super().setdefault(key.lower(), default)
+
+    def update(self, *args, **kwargs):
+        if args:
+            if len(args) > 1:
+                raise TypeError(f"update expected at most 1 arguments, got {len(args)}")
+            other = args[0]
+            if isinstance(other, dict):
+                for key, value in other.items():
+                    self[key] = value
+            elif hasattr(other, "__iter__"):
+                for key, value in other:
+                    self[key] = value
+            else:
+                raise TypeError(f"'dict' object expected, got {type(other).__name__}")
+        for key, value in kwargs.items():
+            self[key] = value
+
+    @staticmethod
+    def parse_headers(headers_str: bytes):
+        lines = headers_str.decode().splitlines()
+        headers = Headers()
+        for line in lines[1:]:
+            if ":" in line:
+                key, value = line.split(":", 1)
+                headers[key] = value.strip()
+        return headers

redc/utils/http.py

@@ -0,0 +1,12 @@
+from urllib.parse import urlparse
+
+
+def parse_base_url(url: str) -> str:
+    res = urlparse(url)
+
+    if not res.scheme:
+        raise ValueError("URL is missing a scheme (e.g., 'http://' or 'https://')")
+    if not res.netloc:
+        raise ValueError("URL is missing a network location (e.g., 'example.com')")
+
+    return f"{url.rstrip('/')}/"

redc/utils/json_encoder.py

@@ -0,0 +1,17 @@
+try:
+    import orjson as json
+
+    def json_dumps(obj):
+        return json.dumps(obj).decode()
+except ImportError:
+    try:
+        import ujson as json
+    except ImportError:
+        import json
+
+    def json_dumps(obj):
+        return json.dumps(obj)
+
+
+def json_loads(obj):
+    return json.loads(obj)

redc-0.1.1.dist-info/METADATA

@@ -0,0 +1,65 @@
+Metadata-Version: 2.1
+Name: redc
+Version: 0.1.1
+Summary: RedC is a high-performance, asynchronous HTTP client library for Python, built on top of the powerful curl library
+Keywords: asyncio,http,client,http-client,curl,libcurl
+Author-Email: AYMEN Mohammed <let.me.code.safe@gmail.com>
+License: MIT
+Project-URL: Source, https://github.com/AYMENJD/redc
+Project-URL: Tracker, https://github.com/AYMENJD/redc/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/AYMENJD/redc/refs/heads/main/assets/images/redc-logo.png">
+</div>
+
+[![Version](https://img.shields.io/pypi/v/redc?style=flat&logo=curl&logoColor=red&color=red)](https://pypi.org/project/RedC) [![CURL version](https://img.shields.io/badge/Curl-v8.12.0-red?logo=curl)](https://curl.se/ch/8.12.0.html) [![Downloads](https://static.pepy.tech/personalized-badge/redc?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/redc)
+
+**RedC** is a **high-performance**, asynchronous **HTTP** client library for **Python**, built on top of the powerful **curl** library. It provides a simple and intuitive interface for making HTTP requests and handling responses
+
+## Features
+
+- **Asynchronous by Design**: Built with `asyncio` for non-blocking HTTP requests
+- **HTTP/2 Support**: Fully compatible with `HTTP/2` for faster and more efficient communication
+- **curl Backend**: Leverages the speed and reliability of curl for HTTP operations
+- **Streaming Support**: Stream large responses with ease using callback functions
+- **Proxy Support**: Easily configure proxies for your requests
+
+## Installation
+
+You can install RedC via pip:
+
+```bash
+pip install redc
+```
+
+## Quick Start
+
+```python
+import asyncio
+from redc import Client
+
+async def main():
+    async with Client(base_url="https://jsonplaceholder.typicode.com") as client:
+        # Make a GET request
+        response = await client.get("/posts/1")
+        response.raise_for_status()
+        print(response.status_code)  # 200
+        print(response.json())  # {'userId': 1, 'id': 1, 'title': '...', 'body': '...'}
+
+        # Make a POST request with JSON data
+        response = await client.post(
+            "/posts",
+            json={"title": "foo", "body": "bar", "userId": 1},
+        )
+        response.raise_for_status()
+        print(response.status_code)  # 201
+        print(response.json())  # {'id': 101, ...}
+
+asyncio.run(main())
+```
+
+## License
+
+MIT [LICENSE](https://github.com/AYMENJD/redc/blob/main/LICENSE)

redc-0.1.1.dist-info/RECORD

@@ -0,0 +1,27 @@
+redc-0.1.1.dist-info/WHEEL,sha256=IklvFvow-fIjjRRsxjKgYsPeAo3uRB_FQqgnasSUIME,158
+redc-0.1.1.dist-info/RECORD,,
+redc-0.1.1.dist-info/METADATA,sha256=TYgeJSgdQlBRo677QMW9TBVV9d5nTRpALlCKNfMaio8,2578
+redc-0.1.1.dist-info/licenses/LICENSE,sha256=3yXboOp4DHykX75K9Rhnw_6LXjMa3EW2CQgKV9HhpUA,1068
+redc.libs/libicuuc-1796a535.so.50.2,sha256=ZPT2z0tpkV6chLxylDTz47Zaw3Gt15-izOGUkLni31M,1796193
+redc.libs/libnghttp2-cc579893.so.14.17.0,sha256=-G-ASfSzSSeZYNSVG5F4mC0bts_nVmt3N9TgKmw8Gvc,175065
+redc.libs/libssl-ebec6e5c.so.3,sha256=InQFpfmQ3TBN-xqnhrzYNDbPreYOdZu-lFlv8zzVONY,1281721
+redc.libs/libpsl-9527e555.so.0.2.4,sha256=6MsYFIUZczcz3ck8Bww9x8-dMXWvnHryv-Uv4A9OGMM,500633
+redc.libs/libicudata-cb3ba60c.so.50.2,sha256=mi096d4G6tWwhWUE-5Q8VeNA2WoUS8GRbeOhH-IBpSk,20787817
+redc.libs/libcurl-a0db5b13.so.4.8.0,sha256=QrutVPmxBPMPOAnBrSLkjgNFF9cGis_TKBT0sAeOt4E,897473
+redc.libs/libcrypto-2321a809.so.3,sha256=AsyVX-fnJyEmdHZoFb3A7oGbBMfX_GJ4b0la2_phl6g,6751329
+redc/codes.py,sha256=GIRC1cBIIBfiwOKwfnW-Xh7MXLAdB_jvITnJXlNb9gg,3862
+redc/callback.py,sha256=1bjw4ZzYRztF2Jm3lXGbabNT71-gPnoEjGrLXAVBWWI,581
+redc/response.py,sha256=TN2nAZf4h7eVPOOIDzWZS60BvNSEKg5s0B3h-j246M4,2021
+redc/redc_ext.cpython-313t-x86_64-linux-gnu.so,sha256=aQvQn-lq_CVRXqIQMeXpim2R4N9HUgpQbLa-C4-ofoY,262209
+redc/__init__.py,sha256=C-Kz-dnixxmzE6LuUEHriWtwLLrooQCy9A8Zi4oeFbQ,462
+redc/callbacks.py,sha256=j13_4QbJH_SAVTDtf_Tflsfy4YIuDQuutbSzaaw4ZDU,3037
+redc/client.py,sha256=SawnsyU8-nUPfyIlaHXrHyCA_ucCZcTJoS1L6cA3IJU,28416
+redc/ext/redc.cpp,sha256=8f-8yWt1zCVzZYxnC-T4H3u0PwXUIz71fCpfotPMJPQ,11128
+redc/ext/redc.h,sha256=q3taUAklU85kVTzsR6g91pIYWdKn6V9EaQ6_IDw96RE,2411
+redc/ext/utils/concurrentqueue.h,sha256=UkvC3lgezJXmMu5qrCZ21qECmmkqnBtKMuSoBgirrV4,152879
+redc/ext/utils/curl_utils.h,sha256=-hOQ-lMHM6nn-T7rm3jaQt6317qytptkxtZh0e61mH4,1566
+redc/utils/__init__.py,sha256=R1AUdbRF4O2BFy-DeU59UKW11Nu0DtI4YhKAivhdZuI,214
+redc/utils/json_encoder.py,sha256=D1pEFXqjq9TlZ5jeVXP24c7iSQS9Oks-dXTHIE5s8WE,306
+redc/utils/headers.py,sha256=YY-yvyKFX5p3cSiAhveP_G5E4BKJ_ZMMnQQHPv55e0k,1840
+redc/utils/http.py,sha256=D2F7eWtvI4vKJX0Bk0ax0JWCsfI8IWJQjqLhT58ROoc,346
+redc/exceptions/__init__.py,sha256=frYN6YwAIuivKlresWzIuCFHuDpXPpRbAK6aHA2OWVQ,792

redc-0.1.1.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: scikit-build-core 0.10.7
+Root-Is-Purelib: false
+Tag: cp313-cp313t-manylinux_2_17_x86_64
+Tag: cp313-cp313t-manylinux2014_x86_64
+

redc-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 RedC, AYMEN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.