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

limits-4.1.dist-info/METADATA

@@ -0,0 +1,268 @@
+Metadata-Version: 2.1
+Name: limits
+Version: 4.1
+Summary: Rate limiting utilities
+Home-page: https://limits.readthedocs.org
+Author: Ali-Akber Saifee
+Author-email: ali@indydevs.org
+License: MIT
+Project-URL: Source, https://github.com/alisaifee/limits
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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
+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'
+Provides-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'
+
+.. |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
+.. |codecov| image:: https://codecov.io/gh/alisaifee/limits/branch/master/graph/badge.svg
+   :target: https://codecov.io/gh/alisaifee/limits
+.. |pypi| image:: https://img.shields.io/pypi/v/limits.svg?style=flat-square
+    :target: https://pypi.python.org/pypi/limits
+.. |pypi-versions| image:: https://img.shields.io/pypi/pyversions/limits?style=flat-square
+    :target: https://pypi.python.org/pypi/limits
+.. |license| image:: https://img.shields.io/pypi/l/limits.svg?style=flat-square
+    :target: https://pypi.python.org/pypi/limits
+.. |docs| image:: https://readthedocs.org/projects/limits/badge/?version=latest
+   :target: https://limits.readthedocs.org
+
+limits
+------
+|docs| |ci| |codecov| |pypi| |pypi-versions| |license|
+
+
+**limits** is a python library for rate limiting via multiple strategies
+with commonly used storage backends (Redis, Memcached, MongoDB & Etcd).
+
+The library provides identical APIs for use in sync and
+`async <https://limits.readthedocs.io/en/stable/async.html>`_ codebases.
+
+
+Supported Strategies
+====================
+
+All strategies support the follow methods:
+
+- `hit <https://limits.readthedocs.io/en/stable/api.html#limits.strategies.RateLimiter.hit>`_: consume a request.
+- `test <https://limits.readthedocs.io/en/stable/api.html#limits.strategies.RateLimiter.test>`_: check if a request is allowed.
+- `get_window_stats <https://limits.readthedocs.io/en/stable/api.html#limits.strategies.RateLimiter.get_window_stats>`_: retrieve remaining quota and reset time.
+
+Fixed Window
+------------
+`Fixed Window <https://limits.readthedocs.io/en/latest/strategies.html#fixed-window>`_
+
+This strategy is the most memory‑efficient because it uses a single counter per resource and
+rate limit. When the first request arrives, a window is started for a fixed duration
+(e.g., for a rate limit of 10 requests per minute the window expires in 60 seconds from the first request).
+All requests in that window increment the counter and when the window expires, the counter resets.
+
+Burst traffic that bypasses the rate limit may occur at window boundaries.
+
+For example, with a rate limit of 10 requests per minute:
+
+- At **00:00:45**, the first request arrives, starting a window from **00:00:45** to **00:01:45**.
+- All requests between **00:00:45** and **00:01:45** count toward the limit.
+- If 10 requests occur at any time in that window, any further request before **00:01:45** is rejected.
+- At **00:01:45**, the counter resets and a new window starts which would allow 10 requests
+  until **00:02:45**.
+
+Moving Window
+-------------
+`Moving Window <https://limits.readthedocs.io/en/latest/strategies.html#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
+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:
+
+- At **00:00:10**, a client sends 1 requests which are allowed.
+- At **00:00:20**, a client sends 2 requests which are allowed.
+- At **00:00:30**, the client sends 4 requests which are allowed.
+- At **00:00:50**, the client sends 3 requests which are allowed (total = 10).
+- At **00:01:11**, the client sends 1 request. The strategy checks the timestamp of the
+  10th oldest entry (**00:00:10**) which is now 61 seconds old and thus expired. The request
+  is allowed.
+- At **00:01:12**, the client sends 1 request. The 10th oldest entry's timestamp is **00:00:20**
+  which is only 52 seconds old. The request is rejected.
+
+Sliding Window Counter
+------------------------
+`Sliding Window Counter <https://limits.readthedocs.io/en/latest/strategies.html#sliding-window-counter>`_
+
+This strategy approximates the moving window while using less memory by maintaining
+two counters:
+
+- **Current bucket:** counts requests in the ongoing period.
+- **Previous bucket:** counts requests in the immediately preceding period.
+
+When a request arrives, the effective request count is calculated as::
+
+    weighted_count = current_count + floor(previous_count * weight)
+
+The weight is based on how much time has elapsed in the current bucket::
+
+    weight = (bucket_duration - elapsed_time) / bucket_duration
+
+If ``weighted_count`` is below the limit, the request is allowed.
+
+For example, with a rate limit of 10 requests per minute:
+
+Assume:
+
+- The current bucket (spanning **00:01:00** to **00:02:00**) has 8 hits.
+- The previous bucket (spanning **00:00:00** to **00:01:00**) has 4 hits.
+
+Scenario 1:
+
+- A new request arrives at **00:01:30**, 30 seconds into the current bucket.
+- ``weight = (60 - 30) / 60 = 0.5``.
+- ``weighted_count = floor(8 + (4 * 0.5)) = floor(8 + 2) = 10``.
+- Since the weighted count equals the limit, the request is rejected.
+
+Scenario 2:
+
+- A new request arrives at **00:01:40**, 40 seconds into the current bucket.
+- ``weight = (60 - 40) / 60 ≈ 0.33``.
+- ``weighted_count = floor(8 + (4 * 0.33)) = floor(8 + 1.32) = 9``.
+- Since the weighted count is below the limit, the request is allowed.
+
+Storage backends
+================
+
+- `Redis <https://limits.readthedocs.io/en/latest/storage.html#redis-storage>`_
+- `Memcached <https://limits.readthedocs.io/en/latest/storage.html#memcached-storage>`_
+- `MongoDB <https://limits.readthedocs.io/en/latest/storage.html#mongodb-storage>`_
+- `Etcd <https://limits.readthedocs.io/en/latest/storage.html#etcd-storage>`_
+- `In-Memory <https://limits.readthedocs.io/en/latest/storage.html#in-memory-storage>`_
+
+Dive right in
+=============
+
+Initialize the storage backend
+
+.. code-block:: python
+
+   from limits import storage
+   backend = storage.MemoryStorage()
+   # or memcached
+   backend = storage.MemcachedStorage("memcached://localhost:11211")
+   # or redis
+   backend = storage.RedisStorage("redis://localhost:6379")
+   # or mongodb
+   backend = storage.MongoDbStorage("mongodb://localhost:27017")
+   # or use the factory
+   storage_uri = "memcached://localhost:11211"
+   backend = storage.storage_from_string(storage_uri)
+
+Initialize a rate limiter with a strategy
+
+.. code-block:: python
+
+   from limits import strategies
+   strategy = strategies.MovingWindowRateLimiter(backend)
+   # or fixed window
+   strategy = strategies.FixedWindowRateLimiter(backend)
+   # or sliding window
+   strategy = strategies.SlidingWindowCounterRateLimiter(backend)
+
+
+Initialize a rate limit
+
+.. code-block:: python
+
+    from limits import parse
+    one_per_minute = parse("1/minute")
+
+Initialize a rate limit explicitly
+
+.. code-block:: python
+
+    from limits import RateLimitItemPerSecond
+    one_per_second = RateLimitItemPerSecond(1, 1)
+
+Test the limits
+
+.. code-block:: python
+
+    import time
+    assert True == strategy.hit(one_per_minute, "test_namespace", "foo")
+    assert False == strategy.hit(one_per_minute, "test_namespace", "foo")
+    assert True == strategy.hit(one_per_minute, "test_namespace", "bar")
+
+    assert True == strategy.hit(one_per_second, "test_namespace", "foo")
+    assert False == strategy.hit(one_per_second, "test_namespace", "foo")
+    time.sleep(1)
+    assert True == strategy.hit(one_per_second, "test_namespace", "foo")
+
+Check specific limits without hitting them
+
+.. code-block:: python
+
+    assert True == strategy.hit(one_per_second, "test_namespace", "foo")
+    while not strategy.test(one_per_second, "test_namespace", "foo"):
+        time.sleep(0.01)
+    assert True == strategy.hit(one_per_second, "test_namespace", "foo")
+
+Query available capacity and reset time for a limit
+
+.. code-block:: python
+
+   assert True == strategy.hit(one_per_minute, "test_namespace", "foo")
+   window = strategy.get_window_stats(one_per_minute, "test_namespace", "foo")
+   assert window.remaining == 0
+   assert False == strategy.hit(one_per_minute, "test_namespace", "foo")
+   time.sleep(window.reset_time - time.time())
+   assert True == strategy.hit(one_per_minute, "test_namespace", "foo")
+
+
+Links
+=====
+
+* `Documentation <http://limits.readthedocs.org/en/latest>`_
+* `Changelog <http://limits.readthedocs.org/en/stable/changelog.html>`_
+

limits-4.1.dist-info/RECORD

@@ -0,0 +1,39 @@
+limits/__init__.py,sha256=j_yVhgN9pdz8o5rQjVwdJTBSq8F-CTzof9kkiYgjRbw,728
+limits/_version.py,sha256=PIGOsmzILcAnImlW2gkexgfobAMt1PHUP-qZuYYI6Es,495
+limits/errors.py,sha256=xCKGOVJiD-g8FlsQQb17AW2pTUvalYSuizPpvEVoYJE,626
+limits/limits.py,sha256=YzzZP8_ay_zlMMnnY2xhAcFTTFvFe5HEk8NQlvUTru4,4907
+limits/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+limits/strategies.py,sha256=18DpCMqDGaZDMYJYY9RuFCA20SINT3az8G-IWCG9bQE,10877
+limits/typing.py,sha256=Me0f4A544qM73fgcr1PU3lrO9zj4EaNaQ6aQVAHfjuc,4193
+limits/util.py,sha256=XAl7V8vZtxL4WSZ7nyFau0R6-gMUDeSV3QQ531T1tYI,6059
+limits/version.py,sha256=YwkF3dtq1KGzvmL3iVGctA8NNtGlK_0arrzZkZGVjUs,47
+limits/aio/__init__.py,sha256=IOetunwQy1c5GefzitK8lewbTzHGiE-kmE9NlqSdr3U,82
+limits/aio/strategies.py,sha256=bY_F-fv0CgQjOHJJPA3iNFuomBvBiTC-3KQ-jSfV_0Y,10744
+limits/aio/storage/__init__.py,sha256=QFoni6CYQMN-UPmja2UXiJmB_Fr6JiVWerDz3uS_HOQ,659
+limits/aio/storage/base.py,sha256=HK6TjsJhar_6y22SBmrJJGMCmFdCmhe69LUOoWhkr3E,6494
+limits/aio/storage/etcd.py,sha256=TEtuPP6l31e5zI7k6dGzNJVM6Vmt0wrm-QzkZvkPPvg,5004
+limits/aio/storage/memcached.py,sha256=dQmSfBRQoUJn4Sj4kYTHd7vEQuMzY3tTp-bnSzfLsZw,10362
+limits/aio/storage/memory.py,sha256=7qrI3cg7QnWmaLLryvqoxCLP1221ExD8UMkh7uCfuuE,9152
+limits/aio/storage/mongodb.py,sha256=6SPdleRWhk0eqQoRZJPEgbRrrt9Pb5IOdrK0tvLxIo4,19371
+limits/aio/storage/redis.py,sha256=sff6HZoEJXLR175lV9k14HjWgmf7Q4hK68N1ZL9BFtE,18746
+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=mGbsTP5P8beXXKqYxsicNW8leU9wfotCy-GIcN7pdKs,2662
+limits/storage/base.py,sha256=pqH9ARhu35oTLew0K1WfT6QHPLMp4NzxHrHBWZ2mRDM,7113
+limits/storage/etcd.py,sha256=F66CdOlZMapEvAF55D8fn3jktkx-yEqAfLza-n2T6NY,4668
+limits/storage/memcached.py,sha256=wIegarAR6-19N6T-_YzV0zBd3-W3kf6osVSCQ5DMBRw,11233
+limits/storage/memory.py,sha256=a6kbG2f5lg9aG3oRWXPyzYjwFBn_aD_n0ejbqoEj-b8,8734
+limits/storage/mongodb.py,sha256=RRK9NXg2Sq-sLAfOQp9S1jVbbheL8yGGJLvwfgWsi-g,18304
+limits/storage/redis.py,sha256=Pp5o3yLDiTHomHu1pUL6Ghz4TZOcoDirqSN-UnDZKv4,9652
+limits/storage/redis_cluster.py,sha256=hAwBGsU1FkG4w2xjtzUJF8g3f_iP_qzCz1B4ZW63I9A,3733
+limits/storage/redis_sentinel.py,sha256=h1wpBM3NYosBPSavTrhH16yFw17911YID04AB6WYSJM,3561
+limits/storage/registry.py,sha256=Az-0CkVv9b5uZAvIVDYabilngIsChdFdtnTOur1JA94,689
+limits-4.1.dist-info/LICENSE.txt,sha256=T6i7kq7F5gIPfcno9FCxU5Hcwm22Bjq0uHZV3ElcjsQ,1061
+limits-4.1.dist-info/METADATA,sha256=u7wxlD0LDCr1uoi4e6nS9rKMtjzGmfHUvO4Tkz9-DI4,10992
+limits-4.1.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
+limits-4.1.dist-info/top_level.txt,sha256=C7g5ahldPoU2s6iWTaJayUrbGmPK1d6e9t5Nn0vQ2jM,7
+limits-4.1.dist-info/RECORD,,

limits-4.0.0.dist-info/METADATA

@@ -1,192 +0,0 @@
-Metadata-Version: 2.1
-Name: limits
-Version: 4.0.0
-Summary: Rate limiting utilities
-Home-page: https://limits.readthedocs.org
-Author: Ali-Akber Saifee
-Author-email: ali@indydevs.org
-License: MIT
-Project-URL: Source, https://github.com/alisaifee/limits
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-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.8
-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 :: Implementation :: PyPy
-Requires-Python: >=3.9
-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'
-Provides-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'
-
-.. |ci| image:: https://github.com/alisaifee/limits/workflows/CI/badge.svg?branch=master
-    :target: https://github.com/alisaifee/limits/actions?query=branch%3Amaster+workflow%3ACI
-.. |codecov| image:: https://codecov.io/gh/alisaifee/limits/branch/master/graph/badge.svg
-   :target: https://codecov.io/gh/alisaifee/limits
-.. |pypi| image:: https://img.shields.io/pypi/v/limits.svg?style=flat-square
-    :target: https://pypi.python.org/pypi/limits
-.. |pypi-versions| image:: https://img.shields.io/pypi/pyversions/limits?style=flat-square
-    :target: https://pypi.python.org/pypi/limits
-.. |license| image:: https://img.shields.io/pypi/l/limits.svg?style=flat-square
-    :target: https://pypi.python.org/pypi/limits
-.. |docs| image:: https://readthedocs.org/projects/limits/badge/?version=latest
-   :target: https://limits.readthedocs.org
-
-limits
-------
-|docs| |ci| |codecov| |pypi| |pypi-versions| |license|
-
-
-**limits** is a python library to perform rate limiting with commonly used storage backends (Redis, Memcached, MongoDB & Etcd).
-
-
-Supported Strategies
-====================
-`Fixed Window <https://limits.readthedocs.io/en/latest/strategies.html#fixed-window>`_
-   This strategy resets at a fixed interval (start of minute, hour, day etc).
-   For example, given a rate limit of ``10/minute`` the strategy will:
-
-   - Allow 10 requests between ``00:01:00`` and ``00:02:00``
-   - Allow 10 requests at ``00:00:59`` and 10 more requests at ``00:01:00``
-
-
-`Fixed Window (Elastic) <https://limits.readthedocs.io/en/latest/strategies.html#fixed-window-with-elastic-expiry>`_
-   Identical to Fixed window, except every breach of rate limit results in an extension
-   to the time out. For example a rate limit of `1/minute` hit twice within a minute will
-   result in a lock-out for two minutes.
-
-`Moving Window <https://limits.readthedocs.io/en/latest/strategies.html#moving-window>`_
-   Sliding window strategy enforces a rate limit of N/(m time units)
-   on the **last m** time units at the second granularity.
-
-   For example, with a rate limit of ``10/minute``:
-
-   - Allow 9 requests that arrive at ``00:00:59``
-   - Allow another request that arrives at ``00:01:00``
-   - Reject the request that arrives at ``00:01:01``
-
-Storage backends
-================
-
-- `Redis <https://limits.readthedocs.io/en/latest/storage.html#redis-storage>`_
-- `Memcached <https://limits.readthedocs.io/en/latest/storage.html#memcached-storage>`_
-- `MongoDB <https://limits.readthedocs.io/en/latest/storage.html#mongodb-storage>`_
-- `Etcd <https://limits.readthedocs.io/en/latest/storage.html#etcd-storage>`_
-- `In-Memory <https://limits.readthedocs.io/en/latest/storage.html#in-memory-storage>`_
-
-Dive right in
-=============
-
-Initialize the storage backend
-
-.. code-block:: python
-
-   from limits import storage
-   memory_storage = storage.MemoryStorage()
-   # or memcached
-   memcached_storage = storage.MemcachedStorage("memcached://localhost:11211")
-   # or redis
-   redis_storage = storage.RedisStorage("redis://localhost:6379")
-   # or use the factory
-   storage_uri = "memcached://localhost:11211"
-   some_storage = storage.storage_from_string(storage_uri)
-
-Initialize a rate limiter with the Moving Window Strategy
-
-.. code-block:: python
-
-   from limits import strategies
-   moving_window = strategies.MovingWindowRateLimiter(memory_storage)
-
-
-Initialize a rate limit
-
-.. code-block:: python
-
-    from limits import parse
-    one_per_minute = parse("1/minute")
-
-Initialize a rate limit explicitly
-
-.. code-block:: python
-
-    from limits import RateLimitItemPerSecond
-    one_per_second = RateLimitItemPerSecond(1, 1)
-
-Test the limits
-
-.. code-block:: python
-
-    assert True == moving_window.hit(one_per_minute, "test_namespace", "foo")
-    assert False == moving_window.hit(one_per_minute, "test_namespace", "foo")
-    assert True == moving_window.hit(one_per_minute, "test_namespace", "bar")
-
-    assert True == moving_window.hit(one_per_second, "test_namespace", "foo")
-    assert False == moving_window.hit(one_per_second, "test_namespace", "foo")
-    time.sleep(1)
-    assert True == moving_window.hit(one_per_second, "test_namespace", "foo")
-
-Check specific limits without hitting them
-
-.. code-block:: python
-
-    assert True == moving_window.hit(one_per_second, "test_namespace", "foo")
-    while not moving_window.test(one_per_second, "test_namespace", "foo"):
-        time.sleep(0.01)
-    assert True == moving_window.hit(one_per_second, "test_namespace", "foo")
-
-Query available capacity and reset time for a limit
-
-.. code-block:: python
-
-   assert True == moving_window.hit(one_per_minute, "test_namespace", "foo")
-   window = moving_window.get_window_stats(one_per_minute, "test_namespace", "foo")
-   assert window.remaining == 0
-   assert False == moving_window.hit(one_per_minute, "test_namespace", "foo")
-   time.sleep(window.reset_time - time.time())
-   assert True == moving_window.hit(one_per_minute, "test_namespace", "foo")
-
-
-Links
-=====
-
-* `Documentation <http://limits.readthedocs.org/en/latest>`_
-* `Changelog <http://limits.readthedocs.org/en/stable/changelog.html>`_
-

limits-4.0.0.dist-info/RECORD

@@ -1,37 +0,0 @@
-limits/__init__.py,sha256=j_yVhgN9pdz8o5rQjVwdJTBSq8F-CTzof9kkiYgjRbw,728
-limits/_version.py,sha256=bGcuGXkHFvjcc-8fCFZ7Jl28gop0tHquuV_Enu505jw,497
-limits/errors.py,sha256=xCKGOVJiD-g8FlsQQb17AW2pTUvalYSuizPpvEVoYJE,626
-limits/limits.py,sha256=ZsXESq2e1ji7c2ZKjSkIAasCjiLdjVLPUa9oah_I8U4,4943
-limits/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-limits/strategies.py,sha256=Zy6PIhkysPbxnMzFjyXEsxMM6jhRoQ5XT5WskTNruK0,6949
-limits/typing.py,sha256=4yitf6iwDK-QEfSxv3EbTdGLOrqowLFffHAqYRUqiYY,3275
-limits/util.py,sha256=fTx0JQBT6ZY3fxGefjT07CLimUVCFjS1jLqskXmb7Eo,5726
-limits/version.py,sha256=YwkF3dtq1KGzvmL3iVGctA8NNtGlK_0arrzZkZGVjUs,47
-limits/aio/__init__.py,sha256=IOetunwQy1c5GefzitK8lewbTzHGiE-kmE9NlqSdr3U,82
-limits/aio/strategies.py,sha256=SHjmJnmy7Nh4tBydkA-0qPaULYcLOAM91T4RPybq0Sg,6768
-limits/aio/storage/__init__.py,sha256=CbtuSlVl1jPyN_vsEI_ApWblDblVaL46xcZ2M_oM0V8,595
-limits/aio/storage/base.py,sha256=V1Ur9Cu29_vP5IYBIsWHTgrc4riW8FEyz5Dcvv6fPoc,4821
-limits/aio/storage/etcd.py,sha256=krqjWujvybuaFa2g_FkPr2ZtX9Ac1-oJzErfGW3h27o,4783
-limits/aio/storage/memcached.py,sha256=n8b9GVtXMWdc-w4-xP1_MPJ9dgVcgoJ5j53mTdU6E3E,4799
-limits/aio/storage/memory.py,sha256=4ah9RpE5r7Q2yOLT-OndhP4ZHmvcwV3rKvCicnK2CJc,5845
-limits/aio/storage/mongodb.py,sha256=pXS2JFqMPkfPLYhQatG2ImAeYas8CelTwiOGo-3eFpM,10701
-limits/aio/storage/redis.py,sha256=JQm4pkwynSo1k6wFVB7SyRsh7yav0_61Px1FqUwuGl4,15658
-limits/resources/redis/lua_scripts/acquire_moving_window.lua,sha256=5CFJX7D6T6RG5SFr6eVZ6zepmI1EkGWmKeVEO4QNrWo,483
-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/storage/__init__.py,sha256=XAW1jVDMLFkPr_Tl1SXpg_p4Y3nhEatTSYq1MlnYJcA,2564
-limits/storage/base.py,sha256=E7ZInoGZqoM1QIpd1f8lvytlic4sMOQdl_eTzD-mlWk,4631
-limits/storage/etcd.py,sha256=Q1tndCAAJp0jnir-b-ZBN3-7Kf3v_uwNAqQJLmqB96Q,4440
-limits/storage/memcached.py,sha256=1maTeD7EbSWq0NgSZcukn-4QdVGcU7-sxZIpUDuh3kw,6637
-limits/storage/memory.py,sha256=ButyS6v7o7DB55bwM3CltFK4Fc5mwKuFEBPgat51CXU,5550
-limits/storage/mongodb.py,sha256=7z5I2kkPaGDKKkQqHD9vp1z1G6842SbtHFaHfVRQUF0,9830
-limits/storage/redis.py,sha256=R7UbE5ng1NjIHEO17gu-vIZ4qgy91JctbPYGEkZ2iM0,8483
-limits/storage/redis_cluster.py,sha256=MsiEpwHphQd0P88AwGw1NVSi3UwVrhsg-pvzkHxU2kw,3739
-limits/storage/redis_sentinel.py,sha256=665CvL3UZYB2sB_vVkZ4CCaPKcbIXvQUWuDWnBoSOLU,4124
-limits/storage/registry.py,sha256=xcBcxuu6srqmoS4WqDpkCXnRLB19ctH98v21P8S9kS8,708
-limits-4.0.0.dist-info/LICENSE.txt,sha256=T6i7kq7F5gIPfcno9FCxU5Hcwm22Bjq0uHZV3ElcjsQ,1061
-limits-4.0.0.dist-info/METADATA,sha256=KraoprBoY3V_JScEnVSxHI5KRbmc3rkwsMZiPhwfgeM,7662
-limits-4.0.0.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
-limits-4.0.0.dist-info/top_level.txt,sha256=C7g5ahldPoU2s6iWTaJayUrbGmPK1d6e9t5Nn0vQ2jM,7
-limits-4.0.0.dist-info/RECORD,,