core-https 2.0.2__tar.gz → 2.0.3__tar.gz

{core_https-2.0.2 → core_https-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: core-https
-Version: 2.0.2
+Version: 2.0.3
 Summary: This project/library contains common elements related to HTTP & API services...
 Author-email: Alejandro Cora González <alek.cora.glez@gmail.com>
 Maintainer: Alejandro Cora González
@@ -24,14 +24,17 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: LICENSE
-Requires-Dist: aiohttp<4.0.0,>=3.12.0; python_version >= "3.9"
+Requires-Dist: aiohttp<4.0.0,>=3.12.0
 Requires-Dist: core-mixins>=2.2.2
-Requires-Dist: requests<3.0.0,>=2.32.3; python_version >= "3.9"
-Requires-Dist: urllib3<3.0.0,>=2.2.3; python_version >= "3.9"
+Requires-Dist: requests<3.0.0,>=2.32.3
+Requires-Dist: urllib3<3.0.0,>=2.2.3
 Provides-Extra: dev
+Requires-Dist: aiolimiter<2.0.0,>=1.2.1; extra == "dev"
 Requires-Dist: core-dev-tools>=1.0.1; extra == "dev"
 Requires-Dist: core-tests>=2.0.2; extra == "dev"
 Requires-Dist: types-requests>=2.32.0.20250602; extra == "dev"
+Provides-Extra: extras
+Requires-Dist: aiolimiter<2.0.0,>=1.2.1; extra == "extras"
 Dynamic: license-file
 
 core-https

core_https-2.0.3/core_https/requesters/aiohttp_rate_limit.py

@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*-
+
+from aiohttp import ClientResponse
+from aiolimiter import AsyncLimiter
+
+from core_https.requesters.aiohttp_throttle import AioHttpThrottleRequester
+
+
+class AioHttpRateLimitRequester(AioHttpThrottleRequester):
+    """
+    An HTTP requester that enforces a simple *rate limit* using
+    :class:`aiolimiter.AsyncLimiter`. This class restricts how many
+    requests may be *started* within a given time window. It does **not**
+    limit concurrency; multiple requests may still run in parallel
+    if they acquire permission within the same window.
+    """
+
+    def __init__(
+        self,
+        max_concurrency: int,
+        max_rate: int,
+        time_period: float,
+        **kwargs
+    ) -> None:
+        """
+        Initialize the rate-limited requester.
+
+        :param max_rate: Maximum number of requests allowed within the time window.
+        :param time_period: Duration (in seconds) of the rate-limiting window.
+        :param kwargs: Additional keyword arguments passed to :class:`AioHttpRequester`.
+        """
+
+        if max_rate <= 0:
+            raise ValueError("`max_rate` must be positive!")
+
+        if time_period <= 0:
+            raise ValueError("`time_period` must be positive!")
+
+        super().__init__(max_concurrency=max_concurrency, **kwargs)
+
+        self.max_rate = max_rate
+        self.time_period = time_period
+
+        self._limiter = AsyncLimiter(
+            max_rate=self.max_rate,
+            time_period=self.time_period,
+        )
+
+    async def request(self, *args, **kwargs) -> ClientResponse:
+        """
+        Execute an HTTP request subject to the configured rate limit. The
+        coroutine will wait (non-blocking) until a rate slot becomes available,
+        and then delegate the call to the base :class:`AioHttpRequester`.
+
+        :return: The HTTP response object.
+        :raises Exception: Any exception raised by the underlying HTTP client.
+        """
+
+        async with self._limiter:
+            return await super().request(*args, **kwargs)

core_https-2.0.3/core_https/requesters/aiohttp_throttle.py

@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*-
+
+import asyncio
+
+from aiohttp import ClientResponse
+
+from core_https.requesters.aiohttp_ import AioHttpRequester
+
+
+class AioHttpThrottleRequester(AioHttpRequester):
+    """
+    An `AioHttpRequester` implementation that limits the number of
+    concurrent in-flight HTTP requests using an `asyncio.Semaphore`. This
+    throttler enforces *max_concurrency* at the coroutine level within a
+    single event loop. Each call to :meth:`request` must acquire a semaphore
+    permit before dispatching the actual HTTP request.
+
+    **Notes:**
+
+    - The throttling mechanism limits only concurrent *coroutine execution*. It
+      does not enforce rate limiting (requests per second).
+    - If you override :meth:`request` in a subclass, be aware that
+      `await super().request(...)` calls the parent implementation (so the parent
+      semaphore *will* be used for the actual HTTP call). However, any code you
+      run **before** or **after** that `super()` call executes outside the parent's
+      semaphore (and therefore is not throttled).
+    """
+
+    def __init__(self, max_concurrency: int, **kwargs) -> None:
+        """
+        :param max_concurrency: Maximum number of concurrent requests allowed.
+        :param kwargs: Passed through to :class:`AioHttpRequester`.
+        """
+
+        super().__init__(**kwargs)
+        self.max_concurrency = max_concurrency
+        self._semaphore = asyncio.Semaphore(self.max_concurrency)
+
+    @classmethod
+    def registration_key(cls) -> str:
+        return cls.__name__
+
+    async def request(self, *args, **kwargs) -> ClientResponse:
+        """
+        Execute an HTTP request with concurrency throttling. It acquires
+        a semaphore permit before delegating the actual request to the
+        underlying :class:`AioHttpRequester` implementation.
+
+        :returns: The aiohttp response object.
+        :raises: Any exception raised by the underlying session.
+        """
+
+        async with self._semaphore:
+            return await super().request(*args, **kwargs)

{core_https-2.0.2 → core_https-2.0.3}/core_https.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: core-https
-Version: 2.0.2
+Version: 2.0.3
 Summary: This project/library contains common elements related to HTTP & API services...
 Author-email: Alejandro Cora González <alek.cora.glez@gmail.com>
 Maintainer: Alejandro Cora González
@@ -24,14 +24,17 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: LICENSE
-Requires-Dist: aiohttp<4.0.0,>=3.12.0; python_version >= "3.9"
+Requires-Dist: aiohttp<4.0.0,>=3.12.0
 Requires-Dist: core-mixins>=2.2.2
-Requires-Dist: requests<3.0.0,>=2.32.3; python_version >= "3.9"
-Requires-Dist: urllib3<3.0.0,>=2.2.3; python_version >= "3.9"
+Requires-Dist: requests<3.0.0,>=2.32.3
+Requires-Dist: urllib3<3.0.0,>=2.2.3
 Provides-Extra: dev
+Requires-Dist: aiolimiter<2.0.0,>=1.2.1; extra == "dev"
 Requires-Dist: core-dev-tools>=1.0.1; extra == "dev"
 Requires-Dist: core-tests>=2.0.2; extra == "dev"
 Requires-Dist: types-requests>=2.32.0.20250602; extra == "dev"
+Provides-Extra: extras
+Requires-Dist: aiolimiter<2.0.0,>=1.2.1; extra == "extras"
 Dynamic: license-file
 
 core-https

{core_https-2.0.2 → core_https-2.0.3}/core_https.egg-info/SOURCES.txt

@@ -13,6 +13,8 @@ core_https.egg-info/requires.txt
 core_https.egg-info/top_level.txt
 core_https/requesters/__init__.py
 core_https/requesters/aiohttp_.py
+core_https/requesters/aiohttp_rate_limit.py
+core_https/requesters/aiohttp_throttle.py
 core_https/requesters/base.py
 core_https/requesters/requests_.py
 core_https/requesters/urllib3_.py

{core_https-2.0.2 → core_https-2.0.3}/core_https.egg-info/requires.txt

@@ -1,11 +1,13 @@
-core-mixins>=2.2.2
-
-[:python_version >= "3.9"]
 aiohttp<4.0.0,>=3.12.0
+core-mixins>=2.2.2
 requests<3.0.0,>=2.32.3
 urllib3<3.0.0,>=2.2.3
 
 [dev]
+aiolimiter<2.0.0,>=1.2.1
 core-dev-tools>=1.0.1
 core-tests>=2.0.2
 types-requests>=2.32.0.20250602
+
+[extras]
+aiolimiter<2.0.0,>=1.2.1

{core_https-2.0.2 → core_https-2.0.3}/pyproject.toml

@@ -9,7 +9,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "core-https"
 description = "This project/library contains common elements related to HTTP & API services..."
-version = "2.0.2"
+version = "2.0.3"
 
 authors = [
     {name = "Alejandro Cora González", email = "alek.cora.glez@gmail.com"}
@@ -39,19 +39,24 @@ classifiers = [
 ]
 
 dependencies = [
-    "aiohttp>=3.12.0,<4.0.0; python_version >= '3.9'",
+    "aiohttp>=3.12.0,<4.0.0",
     "core-mixins>=2.2.2",
-    "requests>=2.32.3,<3.0.0; python_version >= '3.9'",
-    "urllib3>=2.2.3,<3.0.0; python_version >= '3.9'",
+    "requests>=2.32.3,<3.0.0",
+    "urllib3>=2.2.3,<3.0.0",
 ]
 
 [project.optional-dependencies]
 dev = [
+    "aiolimiter>=1.2.1,<2.0.0",
     "core-dev-tools>=1.0.1",
     "core-tests>=2.0.2",
     "types-requests>=2.32.0.20250602",
 ]
 
+extras = [
+    "aiolimiter>=1.2.1,<2.0.0",
+]
+
 [project.urls]
 Homepage = "https://gitlab.com/bytecode-solutions/core/core-https"
 Repository = "https://gitlab.com/bytecode-solutions/core/core-https"