limits 4.1__py3-none-any.whl → 4.3__py3-none-any.whl

limits/typing.py

@@ -1,21 +1,21 @@
+from __future__ import annotations
+
 from collections import Counter
-from collections.abc import Awaitable, Iterable
+from collections.abc import Awaitable, Callable, Iterable
 from typing import (
     TYPE_CHECKING,
     Any,
-    Callable,
     ClassVar,
+    Literal,
     NamedTuple,
-    Optional,
-    Type,
+    ParamSpec,
+    Protocol,
+    TypeAlias,
     TypeVar,
-    Union,
     cast,
 )
 
-from typing_extensions import ParamSpec, Protocol, TypeAlias
-
-Serializable = Union[int, str, float]
+Serializable = int | str | float
 
 R = TypeVar("R")
 R_co = TypeVar("R_co", covariant=True)
@@ -24,16 +24,16 @@ P = ParamSpec("P")
 
 if TYPE_CHECKING:
     import coredis
-    import coredis.commands.script
     import pymongo.collection
     import pymongo.database
+    import pymongo.mongo_client
     import redis
 
 
 class ItemP(Protocol):
     value: bytes
-    flags: Optional[int]
-    cas: Optional[int]
+    flags: int | None
+    cas: int | None
 
 
 class EmcacheClientP(Protocol):
@@ -47,19 +47,19 @@ class EmcacheClientP(Protocol):
         noreply: bool = False,
     ) -> None: ...
 
-    async def get(self, key: bytes, return_flags: bool = False) -> Optional[ItemP]: ...
+    async def get(self, key: bytes, return_flags: bool = False) -> ItemP | None: ...
 
     async def get_many(self, keys: Iterable[bytes]) -> dict[bytes, ItemP]: ...
 
-    async def gets(self, key: bytes, return_flags: bool = False) -> Optional[ItemP]: ...
+    async def gets(self, key: bytes, return_flags: bool = False) -> ItemP | None: ...
 
     async def increment(
         self, key: bytes, value: int, *, noreply: bool = False
-    ) -> Optional[int]: ...
+    ) -> int | None: ...
 
     async def decrement(
         self, key: bytes, value: int, *, noreply: bool = False
-    ) -> Optional[int]: ...
+    ) -> int | None: ...
 
     async def delete(self, key: bytes, *, noreply: bool = False) -> None: ...
 
@@ -83,65 +83,72 @@ class MemcachedClientP(Protocol):
         self,
         key: str,
         value: Serializable,
-        expire: Optional[int] = 0,
-        noreply: Optional[bool] = None,
-        flags: Optional[int] = None,
+        expire: int | None = 0,
+        noreply: bool | None = None,
+        flags: int | None = None,
     ) -> bool: ...
 
-    def get(self, key: str, default: Optional[str] = None) -> bytes: ...
+    def get(self, key: str, default: str | None = None) -> bytes: ...
 
     def get_many(self, keys: Iterable[str]) -> dict[str, Any]: ...  # type:ignore[explicit-any]
 
     def incr(
-        self, key: str, value: int, noreply: Optional[bool] = False
-    ) -> Optional[int]: ...
+        self, key: str, value: int, noreply: bool | None = False
+    ) -> int | None: ...
 
     def decr(
         self,
         key: str,
         value: int,
-        noreply: Optional[bool] = False,
-    ) -> Optional[int]: ...
+        noreply: bool | None = False,
+    ) -> int | None: ...
 
-    def delete(self, key: str, noreply: Optional[bool] = None) -> Optional[bool]: ...
+    def delete(self, key: str, noreply: bool | None = None) -> bool | None: ...
 
     def set(
         self,
         key: str,
         value: Serializable,
         expire: int = 0,
-        noreply: Optional[bool] = None,
-        flags: Optional[int] = None,
+        noreply: bool | None = None,
+        flags: int | None = None,
     ) -> bool: ...
 
     def touch(
-        self, key: str, expire: Optional[int] = 0, noreply: Optional[bool] = None
+        self, key: str, expire: int | None = 0, noreply: bool | None = None
     ) -> bool: ...
 
 
 class RedisClientP(Protocol):
     def incrby(self, key: str, amount: int) -> int: ...
-    def get(self, key: str) -> Optional[bytes]: ...
+    def get(self, key: str) -> bytes | None: ...
     def delete(self, key: str) -> int: ...
     def ttl(self, key: str) -> int: ...
     def expire(self, key: str, seconds: int) -> bool: ...
     def ping(self) -> bool: ...
-    def register_script(self, script: bytes) -> "redis.commands.core.Script": ...
+    def register_script(self, script: bytes) -> redis.commands.core.Script: ...
 
 
-AsyncRedisClient = Union["coredis.Redis[bytes]", "coredis.RedisCluster[bytes]"]
-RedisClient = RedisClientP
+class AsyncRedisClientP(Protocol):
+    async def incrby(self, key: str, amount: int) -> int: ...
+    async def get(self, key: str) -> bytes | None: ...
+    async def delete(self, key: str) -> int: ...
+    async def ttl(self, key: str) -> int: ...
+    async def expire(self, key: str, seconds: int) -> bool: ...
+    async def ping(self) -> bool: ...
+    def register_script(self, script: bytes) -> redis.commands.core.Script: ...
 
 
-class ScriptP(Protocol[R_co]):
-    def __call__(self, keys: list[Serializable], args: list[Serializable]) -> R_co: ...
+RedisClient: TypeAlias = RedisClientP
+AsyncRedisClient: TypeAlias = AsyncRedisClientP
+AsyncCoRedisClient: TypeAlias = "coredis.Redis[bytes] | coredis.RedisCluster[bytes]"
 
-
-MongoClient: TypeAlias = "pymongo.MongoClient[dict[str, Any]]"  # type:ignore[explicit-any]
+MongoClient: TypeAlias = "pymongo.mongo_client.MongoClient[dict[str, Any]]"  # type:ignore[explicit-any]
 MongoDatabase: TypeAlias = "pymongo.database.Database[dict[str, Any]]"  # type:ignore[explicit-any]
 MongoCollection: TypeAlias = "pymongo.collection.Collection[dict[str, Any]]"  # type:ignore[explicit-any]
 
 __all__ = [
+    "TYPE_CHECKING",
     "Any",
     "AsyncRedisClient",
     "Awaitable",
@@ -150,24 +157,20 @@ __all__ = [
     "Counter",
     "EmcacheClientP",
     "ItemP",
+    "Literal",
     "MemcachedClientP",
     "MongoClient",
     "MongoCollection",
     "MongoDatabase",
     "NamedTuple",
-    "Optional",
     "P",
     "ParamSpec",
     "Protocol",
-    "ScriptP",
-    "Serializable",
-    "TypeVar",
     "R",
     "R_co",
     "RedisClient",
-    "Type",
+    "Serializable",
+    "TypeAlias",
     "TypeVar",
-    "TYPE_CHECKING",
-    "Union",
     "cast",
 ]

limits/util.py

@@ -1,5 +1,7 @@
 """ """
 
+from __future__ import annotations
+
 import dataclasses
 import importlib.resources
 import re
@@ -10,7 +12,7 @@ from typing import TYPE_CHECKING
 
 from packaging.version import Version
 
-from limits.typing import NamedTuple, Optional, Type, Union
+from limits.typing import NamedTuple
 
 from .errors import ConfigurationError
 from .limits import GRANULARITIES, RateLimitItem
@@ -25,9 +27,7 @@ SINGLE_EXPR = re.compile(
     re.IGNORECASE | re.VERBOSE,
 )
 EXPR = re.compile(
-    r"^{SINGLE}(:?{SEPARATORS}{SINGLE})*$".format(
-        SINGLE=SINGLE_EXPR.pattern, SEPARATORS=SEPARATORS.pattern
-    ),
+    rf"^{SINGLE_EXPR.pattern}(:?{SEPARATORS.pattern}{SINGLE_EXPR.pattern})*$",
     re.IGNORECASE | re.VERBOSE,
 )
 
@@ -46,8 +46,8 @@ class WindowStats(NamedTuple):
 @dataclasses.dataclass
 class Dependency:
     name: str
-    version_required: Optional[Version]
-    version_found: Optional[Version]
+    version_required: Version | None
+    version_found: Version | None
     module: ModuleType
 
 
@@ -96,7 +96,7 @@ class LazyDependency:
     without having to import them explicitly.
     """
 
-    DEPENDENCIES: Union[dict[str, Optional[Version]], list[str]] = []
+    DEPENDENCIES: dict[str, Version | None] | list[str] = []
     """
     The python modules this class has a dependency on.
     Used to lazily populate the :attr:`dependencies`
@@ -117,7 +117,7 @@ class LazyDependency:
 
         if not getattr(self, "_dependencies", None):
             dependencies = DependencyDict()
-            mapping: dict[str, Optional[Version]]
+            mapping: dict[str, Version | None]
 
             if isinstance(self.DEPENDENCIES, list):
                 mapping = {dependency: None for dependency in self.DEPENDENCIES}
@@ -135,7 +135,7 @@ class LazyDependency:
         return self._dependencies
 
 
-def get_dependency(module_path: str) -> tuple[ModuleType, Optional[Version]]:
+def get_dependency(module_path: str) -> tuple[ModuleType, Version | None]:
     """
     safe function to import a module at runtime
     """
@@ -165,7 +165,7 @@ def parse_many(limit_string: str) -> list[RateLimitItem]:
     """
 
     if not (isinstance(limit_string, str) and EXPR.match(limit_string)):
-        raise ValueError("couldn't parse rate limit string '%s'" % limit_string)
+        raise ValueError(f"couldn't parse rate limit string '{limit_string}'")
     limits = []
 
     for limit in SEPARATORS.split(limit_string):
@@ -194,7 +194,7 @@ def parse(limit_string: str) -> RateLimitItem:
     return list(parse_many(limit_string))[0]
 
 
-def granularity_from_string(granularity_string: str) -> Type[RateLimitItem]:
+def granularity_from_string(granularity_string: str) -> type[RateLimitItem]:
     """
 
     :param granularity_string:
@@ -204,4 +204,4 @@ def granularity_from_string(granularity_string: str) -> Type[RateLimitItem]:
     for granularity in GRANULARITIES.values():
         if granularity.check_granularity_string(granularity_string):
             return granularity
-    raise ValueError("no granularity matched for %s" % granularity_string)
+    raise ValueError(f"no granularity matched for {granularity_string}")

{limits-4.1.dist-info → limits-4.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: limits
-Version: 4.1
+Version: 4.3
 Summary: Rate limiting utilities
 Home-page: https://limits.readthedocs.org
 Author: Ali-Akber Saifee
@@ -14,47 +14,63 @@ Classifier: Operating System :: MacOS
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 License-File: LICENSE.txt
-Requires-Dist: deprecated >=1.2
-Requires-Dist: packaging <25,>=21
-Requires-Dist: typing-extensions
-Provides-Extra: all
-Requires-Dist: redis !=4.5.2,!=4.5.3,<6.0.0,>3 ; extra == 'all'
-Requires-Dist: redis !=4.5.2,!=4.5.3,>=4.2.0 ; extra == 'all'
-Requires-Dist: pymemcache <5.0.0,>3 ; extra == 'all'
-Requires-Dist: pymongo <5,>4.1 ; extra == 'all'
-Requires-Dist: etcd3 ; extra == 'all'
-Requires-Dist: coredis <5,>=3.4.0 ; extra == 'all'
-Requires-Dist: motor <4,>=3 ; extra == 'all'
-Requires-Dist: aetcd ; extra == 'all'
-Requires-Dist: emcache >=0.6.1 ; (python_version < "3.11") and extra == 'all'
-Requires-Dist: emcache >=1 ; (python_version >= "3.11" and python_version < "3.13.0") and extra == 'all'
-Provides-Extra: async-etcd
-Requires-Dist: aetcd ; extra == 'async-etcd'
-Provides-Extra: async-memcached
-Requires-Dist: emcache >=0.6.1 ; (python_version < "3.11") and extra == 'async-memcached'
-Requires-Dist: emcache >=1 ; (python_version >= "3.11" and python_version < "3.13.0") and extra == 'async-memcached'
-Provides-Extra: async-mongodb
-Requires-Dist: motor <4,>=3 ; extra == 'async-mongodb'
-Provides-Extra: async-redis
-Requires-Dist: coredis <5,>=3.4.0 ; extra == 'async-redis'
-Provides-Extra: etcd
-Requires-Dist: etcd3 ; extra == 'etcd'
-Provides-Extra: memcached
-Requires-Dist: pymemcache <5.0.0,>3 ; extra == 'memcached'
-Provides-Extra: mongodb
-Requires-Dist: pymongo <5,>4.1 ; extra == 'mongodb'
+Requires-Dist: deprecated>=1.2
+Requires-Dist: packaging<25,>=21
+Requires-Dist: typing_extensions
 Provides-Extra: redis
-Requires-Dist: redis !=4.5.2,!=4.5.3,<6.0.0,>3 ; extra == 'redis'
+Requires-Dist: redis!=4.5.2,!=4.5.3,<6.0.0,>3; extra == "redis"
 Provides-Extra: rediscluster
-Requires-Dist: redis !=4.5.2,!=4.5.3,>=4.2.0 ; extra == 'rediscluster'
+Requires-Dist: redis!=4.5.2,!=4.5.3,>=4.2.0; extra == "rediscluster"
+Provides-Extra: memcached
+Requires-Dist: pymemcache<5.0.0,>3; extra == "memcached"
+Provides-Extra: mongodb
+Requires-Dist: pymongo<5,>4.1; extra == "mongodb"
+Provides-Extra: etcd
+Requires-Dist: etcd3; extra == "etcd"
+Provides-Extra: valkey
+Requires-Dist: valkey>=6; extra == "valkey"
+Provides-Extra: async-redis
+Requires-Dist: coredis<5,>=3.4.0; extra == "async-redis"
+Provides-Extra: async-memcached
+Requires-Dist: emcache>=0.6.1; python_version < "3.11" and extra == "async-memcached"
+Requires-Dist: emcache>=1; (python_version >= "3.11" and python_version < "3.13.0") and extra == "async-memcached"
+Provides-Extra: async-mongodb
+Requires-Dist: motor<4,>=3; extra == "async-mongodb"
+Provides-Extra: async-etcd
+Requires-Dist: aetcd; extra == "async-etcd"
+Provides-Extra: async-valkey
+Requires-Dist: valkey>=6; extra == "async-valkey"
+Provides-Extra: all
+Requires-Dist: redis!=4.5.2,!=4.5.3,<6.0.0,>3; extra == "all"
+Requires-Dist: redis!=4.5.2,!=4.5.3,>=4.2.0; extra == "all"
+Requires-Dist: pymemcache<5.0.0,>3; extra == "all"
+Requires-Dist: pymongo<5,>4.1; extra == "all"
+Requires-Dist: etcd3; extra == "all"
+Requires-Dist: valkey>=6; extra == "all"
+Requires-Dist: coredis<5,>=3.4.0; extra == "all"
+Requires-Dist: emcache>=0.6.1; python_version < "3.11" and extra == "all"
+Requires-Dist: emcache>=1; (python_version >= "3.11" and python_version < "3.13.0") and extra == "all"
+Requires-Dist: motor<4,>=3; extra == "all"
+Requires-Dist: aetcd; extra == "all"
+Requires-Dist: valkey>=6; extra == "all"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 .. |ci| image:: https://github.com/alisaifee/limits/actions/workflows/main.yml/badge.svg?branch=master
     :target: https://github.com/alisaifee/limits/actions?query=branch%3Amaster+workflow%3ACI
@@ -115,7 +131,7 @@ Moving Window
 
 This strategy adds each request’s timestamp to a log if the ``nth`` oldest entry (where ``n``
 is the limit) is either not present or is older than the duration of the window (for example with a rate limit of
-``10 requests per minute`` if there are either less than 10 entries or the 10th oldest entry is atleast
+``10 requests per minute`` if there are either less than 10 entries or the 10th oldest entry is at least
 60 seconds old). Upon adding a new entry to the log "expired" entries are truncated.
 
 For example, with a rate limit of 10 requests per minute:

limits-4.3.dist-info/RECORD

@@ -0,0 +1,43 @@
+limits/__init__.py,sha256=gPUFrt02kHF_syLjiVRSs-S4UVGpRMcM2VMFNhF6G24,748
+limits/_version.py,sha256=LXQLnVdyn9TpqfaPWYkIpMLktR3ythlsHOPlSYBiX70,495
+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=14k8CFu9mfoVokEVxD48MjF61gBl-hr895brpL4XZUc,10899
+limits/typing.py,sha256=7G4-1MIh0pLOjBMG-gjNhpAqmX-hgQRzhD5_8ROVkls,4459
+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=9jnVU_nynm0zL1EjQLE3fus1vFbLqA-19ZRQhhexAGo,10776
+limits/aio/storage/__init__.py,sha256=gL4DGTV-XDksZxofaP__sGvwehN8MuuJQuRZeuGwiOQ,695
+limits/aio/storage/base.py,sha256=376Bs7l285vRTRa3-DqcVRnqOPdf3BpoCqbJr3XA9u8,6439
+limits/aio/storage/etcd.py,sha256=9Mp2mvLKOZhuozVC6pBB7-85WMbPytmtZyS6Wg7KUPI,5012
+limits/aio/storage/memcached.py,sha256=kSX7B0CRS-qDVCQot4AW0rF3YwomXRyWg6W0_RyaHhM,10361
+limits/aio/storage/memory.py,sha256=cBWk9P8_Dtm8YJpsZWScVuJQN93IJyno0fFVd5ubcRc,9759
+limits/aio/storage/mongodb.py,sha256=EvwYBu9YoNX7j6A8XB8ik8SqMx0n4oWmBYhh4LHMYaI,19310
+limits/aio/storage/redis/__init__.py,sha256=p6amEcujcImDUxcYCsfBaLBKp1qH9xDXDjv3FWWfGow,14203
+limits/aio/storage/redis/bridge.py,sha256=cKs77RoCxUPfYD6_o1AiHfqpkeq_DFqMtVQKMLhEWdY,3183
+limits/aio/storage/redis/coredis.py,sha256=YT8cBx25MeSy9ApSJBfOK8VKduABTRefsnd9GhWscsI,7494
+limits/aio/storage/redis/redispy.py,sha256=ZAxHOFGAjRHsPzjfLowq5nMlVkK_YhVGHOOV8K4gMmU,8547
+limits/aio/storage/redis/valkey.py,sha256=f_-HPZhzNspywGybMNIL0F5uDZk76v8_K9wuC5ZeKhc,248
+limits/resources/redis/lua_scripts/acquire_moving_window.lua,sha256=5CFJX7D6T6RG5SFr6eVZ6zepmI1EkGWmKeVEO4QNrWo,483
+limits/resources/redis/lua_scripts/acquire_sliding_window.lua,sha256=OhVI1MAN_gT92P6r-2CEmvy1yvQVjYCCZxWIxfXYceY,1329
+limits/resources/redis/lua_scripts/clear_keys.lua,sha256=zU0cVfLGmapRQF9x9u0GclapM_IB2pJLszNzVQ1QRK4,184
+limits/resources/redis/lua_scripts/incr_expire.lua,sha256=Uq9NcrrcDI-F87TDAJexoSJn2SDgeXIUEYozCp9S3oA,195
+limits/resources/redis/lua_scripts/moving_window.lua,sha256=5hUZghISDh8Cbg8HJediM_OKjjNMF-0CBywWmsc93vA,430
+limits/resources/redis/lua_scripts/sliding_window.lua,sha256=qG3Yg30Dq54QpRUcR9AOrKQ5bdJiaYpCacTm6Kxblvc,713
+limits/storage/__init__.py,sha256=DArgeRfGilHWsfKz5qT_6OimP3S5u2E9lnzVst0n8Bw,2701
+limits/storage/base.py,sha256=6MprvcdNaTIPyN0ei9emcJLajYq07vDGSIKrmiaU6dU,7003
+limits/storage/etcd.py,sha256=-Zg3KUeXSI8m6VujgIUfa5VeaaiB8Ytbq30p7Voucxk,4676
+limits/storage/memcached.py,sha256=NJqHpbfZjT7YpjlK0dUX1-k_nb7HxPMQvBBapgUaHhY,11217
+limits/storage/memory.py,sha256=xLg3NDsnVEI3ds4QGS7MpH-VjjEJqwroOnz3LA8UQQ8,9226
+limits/storage/mongodb.py,sha256=NqXFRj6h8fk8r_dznV-h9gqh95MLNtd5VRmtFncdzT0,18224
+limits/storage/redis.py,sha256=b2m5TrPNwS7NBY5btwCN0esGyCVQTwwgCn6f-sTcgFQ,10613
+limits/storage/redis_cluster.py,sha256=z6aONMl4p1AY78G3J0BbtK--uztz88krwnpiOsU61BM,4447
+limits/storage/redis_sentinel.py,sha256=AN0WtwHN88TvXk0C2uUE8l5Jhsd1ZxU8XSqrEyQSR20,4327
+limits/storage/registry.py,sha256=CxSaDBGR5aBJPFAIsfX9axCnbcThN3Bu-EH4wHrXtu8,650
+limits-4.3.dist-info/LICENSE.txt,sha256=T6i7kq7F5gIPfcno9FCxU5Hcwm22Bjq0uHZV3ElcjsQ,1061
+limits-4.3.dist-info/METADATA,sha256=ykP0e77goPvIVXKgonDLMcTA95Me_zpbrlfDtFC96Vs,11355
+limits-4.3.dist-info/WHEEL,sha256=52BFRY2Up02UkjOa29eZOS2VxUrpPORXg1pkohGGUS8,91
+limits-4.3.dist-info/top_level.txt,sha256=C7g5ahldPoU2s6iWTaJayUrbGmPK1d6e9t5Nn0vQ2jM,7
+limits-4.3.dist-info/RECORD,,

{limits-4.1.dist-info → limits-4.3.dist-info}/WHEEL

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