limits 5.1.0__py3-none-any.whl → 5.3.0__py3-none-any.whl

limits/_version.py

@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2025-04-23T10:35:38-0700",
+ "date": "2025-06-13T16:23:24-0700",
  "dirty": false,
  "error": null,
- "full-revisionid": "2b76ea0a8aa2a37b2069ab5990e9ae180de6491f",
- "version": "5.1.0"
+ "full-revisionid": "311fe101b2d63c03e8c6a8f0ab363dd49f3e733b",
+ "version": "5.3.0"
 }
 '''  # END VERSION_JSON
 

limits/aio/storage/base.py

@@ -175,7 +175,11 @@ class SlidingWindowCounterSupport(ABC):
     """
 
     def __init_subclass__(cls, **kwargs: Any) -> None:  # type: ignore[explicit-any]
-        for method in {"acquire_sliding_window_entry", "get_sliding_window"}:
+        for method in {
+            "acquire_sliding_window_entry",
+            "get_sliding_window",
+            "clear_sliding_window",
+        }:
             setattr(
                 cls,
                 method,
@@ -218,3 +222,13 @@ class SlidingWindowCounterSupport(ABC):
           - current window TTL
         """
         raise NotImplementedError
+
+    @abstractmethod
+    async def clear_sliding_window(self, key: str, expiry: int) -> None:
+        """
+        Resets the rate limit key(s) for the sliding window
+
+        :param key: the key to clear rate limits for
+        :param expiry: the rate limit expiry, needed to compute the key in some implemenations
+        """
+        ...

limits/aio/storage/memcached/__init__.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import asyncio
 import time
 from math import floor
 
@@ -167,6 +168,11 @@ class MemcachedStorage(Storage, SlidingWindowCounterSupport, TimestampedSlidingW
             previous_key, current_key, expiry, now
         )
 
+    async def clear_sliding_window(self, key: str, expiry: int) -> None:
+        now = time.time()
+        previous_key, current_key = self.sliding_window_keys(key, expiry, now)
+        await asyncio.gather(self.clear(previous_key), self.clear(current_key))
+
     async def _get_sliding_window_info(
         self, previous_key: str, current_key: str, expiry: int, now: float
     ) -> tuple[int, float, int, float]:

limits/aio/storage/memory.py

@@ -65,13 +65,13 @@ class MemoryStorage(
         try:
             now = time.time()
             for key in list(self.events.keys()):
-                cutoff = await asyncio.to_thread(
-                    lambda evts: bisect.bisect_left(
-                        evts, -now, key=lambda event: -event.expiry
-                    ),
-                    self.events[key],
-                )
                 async with self.locks[key]:
+                    cutoff = await asyncio.to_thread(
+                        lambda evts: bisect.bisect_left(
+                            evts, -now, key=lambda event: -event.expiry
+                        ),
+                        self.events[key],
+                    )
                     if self.events.get(key, []):
                         self.events[key] = self.events[key][:cutoff]
                     if not self.events.get(key, None):
@@ -241,6 +241,12 @@ class MemoryStorage(
             previous_key, current_key, expiry, now
         )
 
+    async def clear_sliding_window(self, key: str, expiry: int) -> None:
+        now = time.time()
+        previous_key, current_key = self.sliding_window_keys(key, expiry, now)
+        await self.clear(current_key)
+        await self.clear(previous_key)
+
     async def _get_sliding_window_info(
         self,
         previous_key: str,

limits/aio/storage/mongodb.py

@@ -513,5 +513,8 @@ class MongoDBStorage(Storage, MovingWindowSupport, SlidingWindowCounterSupport):
             )
         return 0, 0.0, 0, 0.0
 
+    async def clear_sliding_window(self, key: str, expiry: int) -> None:
+        return await self.clear(key)
+
     def __del__(self) -> None:
         self.storage and self.storage.close()

limits/aio/storage/redis/__init__.py

@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+import asyncio
+
 from deprecated.sphinx import versionadded, versionchanged
 from packaging.version import Version
 
@@ -219,6 +221,11 @@ class RedisStorage(Storage, MovingWindowSupport, SlidingWindowCounterSupport):
         current_key = self._current_window_key(key)
         return await self.bridge.get_sliding_window(previous_key, current_key, expiry)
 
+    async def clear_sliding_window(self, key: str, expiry: int) -> None:
+        previous_key = self._previous_window_key(key)
+        current_key = self._current_window_key(key)
+        await asyncio.gather(self.clear(previous_key), self.clear(current_key))
+
     async def get_expiry(self, key: str) -> float:
         """
         :param key: the key to get the expiry for

limits/aio/strategies.py

@@ -302,6 +302,11 @@ class SlidingWindowCounterRateLimiter(RateLimiter):
 
         return WindowStats(now + min(previous_reset_in, current_reset_in), remaining)
 
+    async def clear(self, item: RateLimitItem, *identifiers: str) -> None:
+        return await cast(
+            SlidingWindowCounterSupport, self.storage
+        ).clear_sliding_window(item.key_for(*identifiers), item.get_expiry())
+
 
 STRATEGIES = {
     "sliding-window-counter": SlidingWindowCounterRateLimiter,

limits/storage/base.py

@@ -167,7 +167,11 @@ class SlidingWindowCounterSupport(ABC):
     """
 
     def __init_subclass__(cls, **kwargs: Any) -> None:  # type: ignore[explicit-any]
-        for method in {"acquire_sliding_window_entry", "get_sliding_window"}:
+        for method in {
+            "acquire_sliding_window_entry",
+            "get_sliding_window",
+            "clear_sliding_window",
+        }:
             setattr(
                 cls,
                 method,
@@ -207,6 +211,16 @@ class SlidingWindowCounterSupport(ABC):
         """
         raise NotImplementedError
 
+    @abstractmethod
+    def clear_sliding_window(self, key: str, expiry: int) -> None:
+        """
+        Resets the rate limit key(s) for the sliding window
+
+        :param key: the key to clear rate limits for
+        :param expiry: the rate limit expiry, needed to compute the key in some implemenations
+        """
+        ...
+
 
 class TimestampedSlidingWindow:
     """Helper class for storage that support the sliding window counter, with timestamp based keys."""

limits/storage/memcached.py

@@ -282,6 +282,12 @@ class MemcachedStorage(Storage, SlidingWindowCounterSupport, TimestampedSlidingW
         previous_key, current_key = self.sliding_window_keys(key, expiry, now)
         return self._get_sliding_window_info(previous_key, current_key, expiry, now)
 
+    def clear_sliding_window(self, key: str, expiry: int) -> None:
+        now = time.time()
+        previous_key, current_key = self.sliding_window_keys(key, expiry, now)
+        self.clear(previous_key)
+        self.clear(current_key)
+
     def _get_sliding_window_info(
         self, previous_key: str, current_key: str, expiry: int, now: float
     ) -> tuple[int, float, int, float]:

limits/storage/memory.py

@@ -237,6 +237,12 @@ class MemoryStorage(
         previous_key, current_key = self.sliding_window_keys(key, expiry, now)
         return self._get_sliding_window_info(previous_key, current_key, expiry, now)
 
+    def clear_sliding_window(self, key: str, expiry: int) -> None:
+        now = time.time()
+        previous_key, current_key = self.sliding_window_keys(key, expiry, now)
+        self.clear(previous_key)
+        self.clear(current_key)
+
     def check(self) -> bool:
         """
         check if storage is healthy

limits/storage/mongodb.py

@@ -470,6 +470,9 @@ class MongoDBStorageBase(
         )
         return cast(bool, result["_acquired"])
 
+    def clear_sliding_window(self, key: str, expiry: int) -> None:
+        return self.clear(key)
+
     def __del__(self) -> None:
         if self.storage:
             self.storage.close()

limits/storage/redis.py

@@ -200,6 +200,12 @@ class RedisStorage(Storage, MovingWindowSupport, SlidingWindowCounterSupport):
             )
         return 0, 0.0, 0, 0.0
 
+    def clear_sliding_window(self, key: str, expiry: int) -> None:
+        previous_key = self._previous_window_key(key)
+        current_key = self._current_window_key(key)
+        self.clear(previous_key)
+        self.clear(current_key)
+
     def incr(
         self,
         key: str,

limits/strategies.py

@@ -284,6 +284,11 @@ class SlidingWindowCounterRateLimiter(RateLimiter):
 
         return WindowStats(now + min(previous_reset_in, current_reset_in), remaining)
 
+    def clear(self, item: RateLimitItem, *identifiers: str) -> None:
+        return cast(SlidingWindowCounterSupport, self.storage).clear_sliding_window(
+            item.key_for(*identifiers), item.get_expiry()
+        )
+
 
 KnownStrategy = (
     type[SlidingWindowCounterRateLimiter]

{limits-5.1.0.dist-info → limits-5.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: limits
-Version: 5.1.0
+Version: 5.3.0
 Summary: Rate limiting utilities
 Home-page: https://limits.readthedocs.org
 Author: Ali-Akber Saifee

{limits-5.1.0.dist-info → limits-5.3.0.dist-info}/RECORD

@@ -1,23 +1,23 @@
 limits/__init__.py,sha256=gPUFrt02kHF_syLjiVRSs-S4UVGpRMcM2VMFNhF6G24,748
-limits/_version.py,sha256=lLFEUIKCe-XUvEBxgpwkb-a4zLkFZoXtkgamjxeqlCA,497
+limits/_version.py,sha256=zdxTHiQVSU3wNvKwUyOaoK8MMVvzbTzqFicCzdjC7j4,497
 limits/errors.py,sha256=s1el9Vg0ly-z92guvnvYNgKi3_aVqpiw_sufemiLLTI,662
 limits/limits.py,sha256=YzzZP8_ay_zlMMnnY2xhAcFTTFvFe5HEk8NQlvUTru4,4907
 limits/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-limits/strategies.py,sha256=LeZ6lnE73EIQqQ8TfKaTzlxNvBMrZOOSXFB0l8D17fI,9946
+limits/strategies.py,sha256=blVIWefjRmDZvD78tneZ9aHUgCGWddyHjJaPuKxP07s,10169
 limits/typing.py,sha256=pVt5D23MhQSUGqi0MBG5FCSqDwta2ygu18BpKvJFxow,3283
 limits/util.py,sha256=nk5QYvezFuXPq1OTEj04RrZFSWIH-khT0e_Dim6zGCw,6002
 limits/version.py,sha256=YwkF3dtq1KGzvmL3iVGctA8NNtGlK_0arrzZkZGVjUs,47
 limits/aio/__init__.py,sha256=yxvWb_ZmV245Hg2LqD365WC5IDllcGDMw6udJ1jNp1g,118
-limits/aio/strategies.py,sha256=RzZExH2r6jnHra4SpDHqtZCC0Bo3085zUJYo2boAj6Y,9897
+limits/aio/strategies.py,sha256=XSNE0SOSbJDjlodA_8AsL7oBYdfIn3JYh6iuR2z_cyU,10132
 limits/aio/storage/__init__.py,sha256=vKeArUnN1ld_0mQOBBZPCjaQgM5xI1GBPM7_F2Ydz5c,646
-limits/aio/storage/base.py,sha256=VfHpL9Z3RL76eKhoaSQKLKQsqcF5B2bnF6gfa-8ltWA,6296
-limits/aio/storage/memory.py,sha256=sWrDzOe-6Opy9uFmfP1S38IbN2_wNCBaIHTS4UTRy6g,9562
-limits/aio/storage/mongodb.py,sha256=tIMfQrseONRMR2nuRmPO7ocp8dTCABfqBICS_kgp550,19141
-limits/aio/storage/memcached/__init__.py,sha256=VMWsH4XpaPswtPV7cQmsfckhVRbOOrKvoUPYnGt5MRY,6611
+limits/aio/storage/base.py,sha256=56UyNz3I3J-4pQecjsaCK4pUC4L3R_9GzDnutdTrfKs,6706
+limits/aio/storage/memory.py,sha256=-U_GWPWmR77Hzi1Oa1_L1WjiAlROTS8PNG8PROAm13c,9842
+limits/aio/storage/mongodb.py,sha256=0kwDyivA53ZIOUH4DNnCjVG3olLJqAWhXctjPrnHUp0,19252
+limits/aio/storage/memcached/__init__.py,sha256=SjAEgxC6hPjobtyTf7tq3vThPMMbS4lGdtTo5kvoz64,6885
 limits/aio/storage/memcached/bridge.py,sha256=3CEruS6LvZWDQPGPLlwY4hemy6oN0WWduUE7t8vyXBI,2017
 limits/aio/storage/memcached/emcache.py,sha256=J01jP-Udd2fLgamCh2CX9NEIvhN8eZVTzUok096Bbe4,3833
 limits/aio/storage/memcached/memcachio.py,sha256=OoGVqOVG0pVX2McFeTGQ_AbiqQUu_FYwWItpQMtNV7g,3491
-limits/aio/storage/redis/__init__.py,sha256=dU0FsaDv53kKGpZg-CA_F1VjLEdrxGakSHpfuh1cyYM,14756
+limits/aio/storage/redis/__init__.py,sha256=RjGus6rj-RhUR4eqTcnpxgicCt_rPtwFkC_SmbKfoqQ,15032
 limits/aio/storage/redis/bridge.py,sha256=tz6WGViOqIm81hjGPUOBlz-Qw0tSB71NIttn7Xb5lok,3189
 limits/aio/storage/redis/coredis.py,sha256=IzfEyXBvQbr4QUWML9xAd87a2aHCvglOBEjAg-Vq4z0,7420
 limits/aio/storage/redis/redispy.py,sha256=HS1H6E9g0dP3G-8tSUILIFoc8JWpeRQOiBxcpL3I0gM,8310
@@ -29,16 +29,16 @@ limits/resources/redis/lua_scripts/incr_expire.lua,sha256=Uq9NcrrcDI-F87TDAJexoS
 limits/resources/redis/lua_scripts/moving_window.lua,sha256=zlieQwfET0BC7sxpfiOuzPa1wwmrwWLy7IF8LxNa_Lw,717
 limits/resources/redis/lua_scripts/sliding_window.lua,sha256=qG3Yg30Dq54QpRUcR9AOrKQ5bdJiaYpCacTm6Kxblvc,713
 limits/storage/__init__.py,sha256=9iNxIlwzLQw2d54EcMa2LBJ47wiWCPOnHgn6ddqKkDI,2652
-limits/storage/base.py,sha256=IdOL_iqR9KhaJO73M_h9c6OYe8Ox632pxx5uXaL9Dbo,6860
-limits/storage/memcached.py,sha256=5GUKGWS_BYTwUss2WmOlCwBtOieGT7AFUcpX65WYXdQ,10217
-limits/storage/memory.py,sha256=rVlsirSp9LDhuqNFp6KMLR85fJc9xwrU58IHIVz6eq4,8719
-limits/storage/mongodb.py,sha256=V4Ib_AwPFX6JpNI7oUUGJx_3MxD8EmYAi4Q6QcWnQ5U,18071
-limits/storage/redis.py,sha256=GwD1fODE8pZxm403UwEuhbRHG1bprqoxyuFkIp_K5QQ,10552
+limits/storage/base.py,sha256=QFVhOS8VdR7PDhaYMSc77SLg8yaGm0PCNNrMu4ZamfY,7264
+limits/storage/memcached.py,sha256=AzT3vz-MnkFxS0mF3C0QjGPzCnmUt29qTnuOKhKVKYI,10455
+limits/storage/memory.py,sha256=4W8hWIEzwQpoh1z0LcfwuP6DqeFoVuOEM2u8WpZkfdQ,8957
+limits/storage/mongodb.py,sha256=Cg_Vj33N7Ozxdmq7RGMCerg1XuVOhRAU7eusfhiSZBc,18170
+limits/storage/redis.py,sha256=zTwxV5qosxGBTrkZmD4UWQdvavDbWpYHXY7H3hXH-Sw,10791
 limits/storage/redis_cluster.py,sha256=GkL8GCQFfxDriMzsPMkaj6pMEX5FvQXYpUtXLY5q8fQ,4621
 limits/storage/redis_sentinel.py,sha256=OSb61DxgUxMgXSIjaM_pF5-entD8XntD56xt0rFu89k,4479
 limits/storage/registry.py,sha256=CxSaDBGR5aBJPFAIsfX9axCnbcThN3Bu-EH4wHrXtu8,650
-limits-5.1.0.dist-info/licenses/LICENSE.txt,sha256=T6i7kq7F5gIPfcno9FCxU5Hcwm22Bjq0uHZV3ElcjsQ,1061
-limits-5.1.0.dist-info/METADATA,sha256=Me_Gk0sTOOVK8weSyIufZ1ie9SpIKiEA2bQIMQrwBbo,10900
-limits-5.1.0.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
-limits-5.1.0.dist-info/top_level.txt,sha256=C7g5ahldPoU2s6iWTaJayUrbGmPK1d6e9t5Nn0vQ2jM,7
-limits-5.1.0.dist-info/RECORD,,
+limits-5.3.0.dist-info/licenses/LICENSE.txt,sha256=T6i7kq7F5gIPfcno9FCxU5Hcwm22Bjq0uHZV3ElcjsQ,1061
+limits-5.3.0.dist-info/METADATA,sha256=saaz-nkRG9gi-N5HyQ2eFhNjvPe2TrJnScsaZTkowEM,10900
+limits-5.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+limits-5.3.0.dist-info/top_level.txt,sha256=C7g5ahldPoU2s6iWTaJayUrbGmPK1d6e9t5Nn0vQ2jM,7
+limits-5.3.0.dist-info/RECORD,,

{limits-5.1.0.dist-info → limits-5.3.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (79.0.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any