limits 4.1__tar.gz → 4.3__tar.gz

{limits-4.1 → limits-4.3}/CLASSIFIERS

@@ -5,7 +5,6 @@ Operating System :: MacOS
 Operating System :: POSIX :: Linux
 Operating System :: OS Independent
 Topic :: Software Development :: Libraries :: Python Modules
-Programming Language :: Python :: 3.9
 Programming Language :: Python :: 3.10
 Programming Language :: Python :: 3.11
 Programming Language :: Python :: 3.12

{limits-4.1 → limits-4.3}/HISTORY.rst

@@ -3,6 +3,30 @@
 Changelog
 =========
 
+v4.3
+----
+Release Date: 2025-03-14
+
+* Feature
+
+  * Add support for ``valkey://`` schemas and using ``valkey-py``
+    dependency
+
+* Compatibility
+
+  * Drop support for python 3.9
+  * Improve typing to use python 3.10+ features
+
+
+v4.2
+----
+Release Date: 2025-03-11
+
+  * Feature
+
+    * Add support for using ``redis-py`` instead of ``coredis``
+      which asyncio + redis storages
+
 v4.1
 ----
 Release Date: 2025-03-07
@@ -781,6 +805,8 @@ Release Date: 2015-01-08
 
 
 
+
+
 
 
 

{limits-4.1 → limits-4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 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,13 +14,12 @@ 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
@@ -35,6 +34,8 @@ 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
@@ -44,17 +45,21 @@ 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
@@ -126,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.1 → limits-4.3}/README.rst

@@ -57,7 +57,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.1 → limits-4.3}/doc/source/async.rst

@@ -10,7 +10,10 @@ A new namespace ``limits.aio`` is available which mirrors the original
 The following async storage backends are implemented:
 
 - In-Memory
-- Redis (via `coredis <https://coredis.readthedocs.org>`_)
+- Redis (via `coredis <https://coredis.readthedocs.org>`_
+  or `redis-py <https://redis-py.readthedocs.io>`_. Refer to
+  :paramref:`limits.aio.storage.RedisStorage.implementation` for
+  details on selecting the dependency)
 - Memcached (via `emcache <https://emcache.readthedocs.org>`_)
 - MongoDB (via `motor <https://motor.readthedocs.org>`_)
 - Etcd (via `aetcd <https://aetcd.readthedocs.org>`_)

{limits-4.1 → limits-4.3}/doc/source/conf.py

@@ -81,4 +81,5 @@ intersphinx_mapping = {
     "pymongo": ("https://pymongo.readthedocs.io/en/stable/", None),
     "python-etcd3": ("https://python-etcd3.readthedocs.io/en/latest/", None),
     "aetcd": ("https://aetcd.readthedocs.io/en/latest/", None),
+    "valkey-py": ("https://valkey-py.readthedocs.io/en/latest/", None),
 }

{limits-4.1 → limits-4.3}/doc/source/index.rst

@@ -55,12 +55,12 @@ To get started
 
 .. code:: console
 
-   $ git clone git://github.com/alisaifee/limits.git
+   $ git clone https://github.com/alisaifee/limits.git
    $ cd limits
    $ pip install -r requirements/dev.txt
 
 Since `limits` integrates with various backend storages, local development and running tests
-requires a a working `docker & docker-compose installation <https://docs.docker.com/compose/gettingstarted/>`_.
+requires a working `docker & docker-compose installation <https://docs.docker.com/compose/gettingstarted/>`_.
 
 Running the tests will start the relevant containers automatically - but will leave them running
 so as to not incur the overhead of starting up on each test run. To run the tests:

{limits-4.1 → limits-4.3}/doc/source/installation.rst

@@ -58,6 +58,16 @@ Install the package with pip:
 
    .. literalinclude:: ../../requirements/storage/etcd.txt
 
+.. tab:: Valkey
+
+   .. code:: console
+
+      $ pip install limits[valkey]
+
+   Includes:
+
+   .. literalinclude:: ../../requirements/storage/valkey.txt
+
 More details around the specifics of each storage backend can be
 found in :ref:`storage`
 
@@ -79,6 +89,12 @@ along with the package using the following extras:
 
    .. literalinclude:: ../../requirements/storage/async-redis.txt
 
+   .. versionadded:: 4.2
+      :pypi:`redis` if installed can be used instead of :pypi:`coredis` by setting
+      :paramref:`~limits.aio.storage.Redis.implementation` to ``redispy``.
+      See :class:`limits.aio.storage.RedisStorage` for more details.
+
+
 .. tab:: Memcached
 
    .. code:: console
@@ -108,3 +124,15 @@ along with the package using the following extras:
    Includes:
 
    .. literalinclude:: ../../requirements/storage/async-etcd.txt
+
+.. tab:: Valkey
+
+   .. code:: console
+
+      $ pip install limits[async-valkey]
+
+   Includes:
+
+   .. literalinclude:: ../../requirements/storage/async-valkey.txt
+
+

{limits-4.1 → limits-4.3}/doc/source/storage.rst

@@ -31,17 +31,22 @@ the results in `github <https://github.com/alisaifee/limits/actions/workflows/co
 
    .. literalinclude:: ../../requirements/storage/async-redis.txt
 
+   .. note::
+     .. versionadded:: 4.2
+        :pypi:`redis` can be used instead of :pypi:`coredis` by setting
+        :paramref:`limits.aio.storage.RedisStorage.implementation` to ``redispy``
+
    `Redis <https://redis.io>`_
 
-   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_REDIS_SERVER_VERSION=[\d\.]+' | cut -d = -f 2"
+   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_REDIS_SERVER_VERSION=[\d\.]+' | cut -d = -f 2 | sort --version-sort | uniq"
 
    Redis with SSL
 
-   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_REDIS_SERVER_SSL_VERSION=[\d\.]+' | cut -d = -f 2"
+   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_REDIS_SERVER_SSL_VERSION=[\d\.]+' | cut -d = -f 2 | sort --version-sort | uniq"
 
    `Redis Sentinel <https://redis.io/topics/sentinel>`_
 
-   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_REDIS_SENTINEL_SERVER_VERSION=[\d\.]+' | cut -d = -f 2"
+   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_REDIS_SENTINEL_SERVER_VERSION=[\d\.]+' | cut -d = -f 2 | sort --version-sort | uniq"
 
 .. tab:: Redis Cluster
 
@@ -53,9 +58,14 @@ the results in `github <https://github.com/alisaifee/limits/actions/workflows/co
 
    .. literalinclude:: ../../requirements/storage/async-redis.txt
 
+   .. note::
+      .. versionadded:: 4.2
+         :pypi:`redis` can be used instead of :pypi:`coredis` by setting
+         :paramref:`limits.aio.storage.RedisClusterStorage.implementation` to ``redispy``
+
    `Redis cluster <https://redis.io/topics/cluster-tutorial>`_
 
-   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_REDIS_SERVER_VERSION=[\d\.]+' | cut -d = -f 2"
+   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_REDIS_SERVER_VERSION=[\d\.]+' | cut -d = -f 2 | sort --version-sort | uniq"
 
 .. tab:: Memcached
 
@@ -69,7 +79,7 @@ the results in `github <https://github.com/alisaifee/limits/actions/workflows/co
 
    `Memcached <https://memcached.org/>`_
 
-   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_MEMCACHED_SERVER_VERSION=[\d\.]+' | cut -d = -f 2"
+   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_MEMCACHED_SERVER_VERSION=[\d\.]+' | cut -d = -f 2 | sort --version-sort | uniq"
 
 .. tab:: MongoDB
 
@@ -83,7 +93,7 @@ the results in `github <https://github.com/alisaifee/limits/actions/workflows/co
 
    `MongoDB <https://www.mongodb.com/>`_
 
-   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_MONGODB_SERVER_VERSION=[\d\.]+' | cut -d = -f 2"
+   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_MONGODB_SERVER_VERSION=[\d\.]+' | cut -d = -f 2 | sort --version-sort | uniq"
 
 .. tab:: Etcd
 
@@ -97,8 +107,21 @@ the results in `github <https://github.com/alisaifee/limits/actions/workflows/co
 
    `Etcd <https://www.etcd.io/>`_
 
-   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_ETCD_SERVER_VERSION=[\d\.]+' | cut -d = -f 2"
+   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_ETCD_SERVER_VERSION=[\d\.]+' | cut -d = -f 2 | sort --version-sort | uniq"
 
+.. tab:: Valkey
+
+   Dependency versions:
+
+   .. literalinclude:: ../../requirements/storage/valkey.txt
+
+   Dependency versions (async):
+
+   .. literalinclude:: ../../requirements/storage/async-valkey.txt
+
+   `Valkey <https://www.valkey.io/>`_
+
+   .. program-output:: bash -c "cat ../../.github/workflows/compatibility.yml | grep -o -P 'LIMITS_VALKEY_SERVER_VERSION=[\d\.]+' | cut -d = -f 2 | sort --version-sort | uniq"
 
 Storage scheme
 ==============
@@ -152,7 +175,7 @@ If the redis server is listening over a unix domain socket you can use :code:`re
 or :code:`redis+unix:///path/to/socket?db=n` (for database `n`).
 
 If the database is password protected the password can be provided in the url, for example
-:code:`redis://:foobared@localhost:6379` or :code:`redis+unix://:foobered/path/to/socket` if using a UDS..
+:code:`redis://:foobared@localhost:6379` or :code:`redis+unix://:foobered/path/to/socket` if using a UDS.
 
 For scenarios where a redis connection pool is already available and can be reused, it can be provided
 in :paramref:`~limits.storage.storage_from_string.options`, for example::
@@ -162,6 +185,12 @@ in :paramref:`~limits.storage.storage_from_string.options`, for example::
 
 Depends on: :pypi:`redis`
 
+
+.. versionadded:: 4.3
+
+   If the database ``uri`` scheme uses ``valkey`` instead of ``redis`` the implementation
+   used will be from :pypi:`valkey` instead of :pypi:`redis`.
+
 Redis+SSL Storage
 -----------------
 
@@ -175,7 +204,7 @@ Depends on: :pypi:`redis`
 Redis+Sentinel Storage
 ----------------------
 
-Requires the location(s) of the redis sentinal instances and the `service-name`
+Requires the location(s) of the redis sentinel instances and the `service-name`
 that is monitored by the sentinels.
 :code:`redis+sentinel://localhost:26379/my-redis-service`
 or :code:`redis+sentinel://localhost:26379,localhost:26380/my-redis-service`.
@@ -187,7 +216,7 @@ When authentication details are provided in the url they will be used for both t
 and as connection arguments for the underlying redis nodes managed by the sentinel.
 
 If you need fine grained control it is recommended to use the additional :paramref:`~limits.storage.storage_from_string.options`
-arguments. More details can be found in the API documentation for :class:`~limits.storage.RedisSentinelStorage` (or the aysnc version: :class:`~limits.aio.storage.RedisSentinelStorage`).
+arguments. More details can be found in the API documentation for :class:`~limits.storage.RedisSentinelStorage` (or the async version: :class:`~limits.aio.storage.RedisSentinelStorage`).
 
 Depends on: :pypi:`redis`
 

{limits-4.1 → limits-4.3}/doc/source/strategies.rst

@@ -57,7 +57,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.1 → limits-4.3}/limits/__init__.py

@@ -2,6 +2,8 @@
 Rate limiting with commonly used storage backends
 """
 
+from __future__ import annotations
+
 from . import _version, aio, storage, strategies
 from .limits import (
     RateLimitItem,
@@ -16,18 +18,18 @@ from .util import WindowStats, parse, parse_many
 
 __all__ = [
     "RateLimitItem",
-    "RateLimitItemPerYear",
-    "RateLimitItemPerMonth",
     "RateLimitItemPerDay",
     "RateLimitItemPerHour",
     "RateLimitItemPerMinute",
+    "RateLimitItemPerMonth",
     "RateLimitItemPerSecond",
+    "RateLimitItemPerYear",
+    "WindowStats",
     "aio",
-    "storage",
-    "strategies",
     "parse",
     "parse_many",
-    "WindowStats",
+    "storage",
+    "strategies",
 ]
 
-__version__ = _version.get_versions()["version"]  # type: ignore
+__version__ = _version.get_versions()["version"]

{limits-4.1 → limits-4.3}/limits/_version.py

@@ -1,5 +1,5 @@
 
-# This file was generated by 'versioneer.py' (0.22) from
+# This file was generated by 'versioneer.py' (0.29) from
 # revision-control system data, or from the parent directory name of an
 # unpacked source archive. Distribution tarballs contain a pre-generated copy
 # of this file.
@@ -8,11 +8,11 @@ import json
 
 version_json = '''
 {
- "date": "2025-03-07T12:07:00-0800",
+ "date": "2025-03-14T16:19:10-0700",
  "dirty": false,
  "error": null,
- "full-revisionid": "aff8ca13e30c9d754690a2931498f023d35dc62f",
- "version": "4.1"
+ "full-revisionid": "0bcebd7b69d035e3df82779a50fb2d1e901b9ef9",
+ "version": "4.3"
 }
 '''  # END VERSION_JSON
 

{limits-4.1 → limits-4.3}/limits/aio/__init__.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 from . import storage, strategies
 
 __all__ = [

{limits-4.1 → limits-4.3}/limits/aio/storage/__init__.py

@@ -3,6 +3,8 @@ Implementations of storage backends to be used with
 :class:`limits.aio.strategies.RateLimiter` strategies
 """
 
+from __future__ import annotations
+
 from .base import MovingWindowSupport, SlidingWindowCounterSupport, Storage
 from .etcd import EtcdStorage
 from .memcached import MemcachedStorage
@@ -11,14 +13,14 @@ from .mongodb import MongoDBStorage
 from .redis import RedisClusterStorage, RedisSentinelStorage, RedisStorage
 
 __all__ = [
-    "Storage",
-    "MovingWindowSupport",
-    "SlidingWindowCounterSupport",
     "EtcdStorage",
     "MemcachedStorage",
     "MemoryStorage",
     "MongoDBStorage",
-    "RedisStorage",
+    "MovingWindowSupport",
     "RedisClusterStorage",
     "RedisSentinelStorage",
+    "RedisStorage",
+    "SlidingWindowCounterSupport",
+    "Storage",
 ]

{limits-4.1 → limits-4.3}/limits/aio/storage/base.py

@@ -11,11 +11,8 @@ from limits.typing import (
     Any,
     Awaitable,
     Callable,
-    Optional,
     P,
     R,
-    Type,
-    Union,
     cast,
 )
 from limits.util import LazyDependency
@@ -43,7 +40,7 @@ class Storage(LazyDependency, metaclass=StorageRegistry):
     Base class to extend when implementing an async storage backend.
     """
 
-    STORAGE_SCHEME: Optional[list[str]]
+    STORAGE_SCHEME: list[str] | None
     """The storage schemes to register against this implementation"""
 
     def __init_subclass__(cls, **kwargs: Any) -> None:  # type:ignore[explicit-any]
@@ -61,9 +58,9 @@ class Storage(LazyDependency, metaclass=StorageRegistry):
 
     def __init__(
         self,
-        uri: Optional[str] = None,
+        uri: str | None = None,
         wrap_exceptions: bool = False,
-        **options: Union[float, str, bool],
+        **options: float | str | bool,
     ) -> None:
         """
         :param wrap_exceptions: Whether to wrap storage exceptions in
@@ -74,7 +71,7 @@ class Storage(LazyDependency, metaclass=StorageRegistry):
 
     @property
     @abstractmethod
-    def base_exceptions(self) -> Union[Type[Exception], tuple[Type[Exception], ...]]:
+    def base_exceptions(self) -> type[Exception] | tuple[type[Exception], ...]:
         raise NotImplementedError
 
     @abstractmethod
@@ -114,7 +111,7 @@ class Storage(LazyDependency, metaclass=StorageRegistry):
         raise NotImplementedError
 
     @abstractmethod
-    async def reset(self) -> Optional[int]:
+    async def reset(self) -> int | None:
         """
         reset storage to clear limits
         """

{limits-4.1 → limits-4.3}/limits/aio/storage/etcd.py

@@ -1,7 +1,9 @@
+from __future__ import annotations
+
 import asyncio
 import time
 import urllib.parse
-from typing import TYPE_CHECKING, Optional, Union
+from typing import TYPE_CHECKING
 
 from limits.aio.storage.base import Storage
 from limits.errors import ConcurrentUpdateError
@@ -44,7 +46,7 @@ class EtcdStorage(Storage):
         """
         parsed = urllib.parse.urlparse(uri)
         self.lib = self.dependencies["aetcd"].module
-        self.storage: "aetcd.Client" = self.lib.Client(
+        self.storage: aetcd.Client = self.lib.Client(
             host=parsed.hostname, port=parsed.port, **options
         )
         self.max_retries = max_retries
@@ -53,7 +55,7 @@ class EtcdStorage(Storage):
     @property
     def base_exceptions(
         self,
-    ) -> Union[type[Exception], tuple[type[Exception], ...]]:  # pragma: no cover
+    ) -> type[Exception] | tuple[type[Exception], ...]:  # pragma: no cover
         return self.lib.ClientError  # type: ignore[no-any-return]
 
     def prefixed_key(self, key: str) -> bytes:
@@ -134,7 +136,7 @@ class EtcdStorage(Storage):
         except:  # noqa
             return False
 
-    async def reset(self) -> Optional[int]:
+    async def reset(self) -> int | None:
         return (await self.storage.delete_prefix(f"{self.PREFIX}/".encode())).deleted
 
     async def clear(self, key: str) -> None:

{limits-4.1 → limits-4.3}/limits/aio/storage/memcached.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import time
 import urllib.parse
 from collections.abc import Iterable
@@ -7,7 +9,7 @@ from deprecated.sphinx import versionadded
 
 from limits.aio.storage.base import SlidingWindowCounterSupport, Storage
 from limits.storage.base import TimestampedSlidingWindow
-from limits.typing import EmcacheClientP, ItemP, Optional, Type, Union
+from limits.typing import EmcacheClientP, ItemP
 
 
 @versionadded(version="2.1")
@@ -27,7 +29,7 @@ class MemcachedStorage(Storage, SlidingWindowCounterSupport, TimestampedSlidingW
         self,
         uri: str,
         wrap_exceptions: bool = False,
-        **options: Union[float, str, bool],
+        **options: float | str | bool,
     ) -> None:
         """
         :param uri: memcached location of the form
@@ -54,7 +56,7 @@ class MemcachedStorage(Storage, SlidingWindowCounterSupport, TimestampedSlidingW
     @property
     def base_exceptions(
         self,
-    ) -> Union[Type[Exception], tuple[Type[Exception], ...]]:  # pragma: no cover
+    ) -> type[Exception] | tuple[type[Exception], ...]:  # pragma: no cover
         return (
             self.dependency.ClusterNoAvailableNodes,
             self.dependency.CommandError,
@@ -204,7 +206,7 @@ class MemcachedStorage(Storage, SlidingWindowCounterSupport, TimestampedSlidingW
         except:  # noqa
             return False
 
-    async def reset(self) -> Optional[int]:
+    async def reset(self) -> int | None:
         raise NotImplementedError
 
     async def acquire_sliding_window_entry(