second commit

env/lib/python3.11/site-packages/ratelimit-2.2.1.dist-info/INSTALLER

@@ -0,0 +1 @@
+pip

env/lib/python3.11/site-packages/ratelimit-2.2.1.dist-info/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Tomas Basham
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

env/lib/python3.11/site-packages/ratelimit-2.2.1.dist-info/METADATA

@@ -0,0 +1,144 @@
+Metadata-Version: 2.1
+Name: ratelimit
+Version: 2.2.1
+Summary: API rate limit decorator
+Home-page: https://github.com/tomasbasham/ratelimit
+Author: Tomas Basham
+Author-email: me@tomasbasham.co.uk
+License: MIT
+Keywords: ratelimit,api,decorator
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Topic :: Software Development
+License-File: LICENSE.txt
+
+ratelimit |build| |maintainability|
+===================================
+
+.. |build| image:: https://travis-ci.org/tomasbasham/ratelimit.svg?branch=master
+    :target: https://travis-ci.org/tomasbasham/ratelimit
+
+.. |maintainability| image:: https://api.codeclimate.com/v1/badges/21dc7c529c35cd7ef732/maintainability
+    :target: https://codeclimate.com/github/tomasbasham/ratelimit/maintainability
+    :alt: Maintainability
+
+APIs are a very common way to interact with web services. As the need to
+consume data grows, so does the number of API calls necessary to remain up to
+date with data sources. However many API providers constrain developers from
+making too many API calls. This is know as rate limiting and in a worst case
+scenario your application can be banned from making further API calls if it
+abuses these limits.
+
+This packages introduces a function decorator preventing a function from being
+called more often than that allowed by the API provider. This should prevent
+API providers from banning your applications by conforming to their rate
+limits.
+
+Installation
+------------
+
+PyPi
+~~~~
+
+To install ratelimit, simply:
+
+.. code:: bash
+
+    $ pip install ratelimit
+
+GitHub
+~~~~~~
+
+Installing the latest version from Github:
+
+.. code:: bash
+
+    $ git clone https://github.com/tomasbasham/ratelimit
+    $ cd ratelimit
+    $ python setup.py install
+
+Usage
+-----
+
+To use this package simply decorate any function that makes an API call:
+
+.. code:: python
+
+    from ratelimit import limits
+
+    import requests
+
+    FIFTEEN_MINUTES = 900
+
+    @limits(calls=15, period=FIFTEEN_MINUTES)
+    def call_api(url):
+        response = requests.get(url)
+
+        if response.status_code != 200:
+            raise Exception('API response: {}'.format(response.status_code))
+        return response
+
+This function will not be able to make more then 15 API call within a 15 minute
+time period.
+
+The arguments passed into the decorator describe the number of function
+invocation allowed over a specified time period (in seconds). If no time period
+is specified then it defaults to 15 minutes (the time window imposed by
+Twitter).
+
+If a decorated function is called more times than that allowed within the
+specified time period then a ``ratelimit.RateLimitException`` is raised. This
+may be used to implement a retry strategy such as an `expoential backoff
+<https://pypi.org/project/backoff/>`_
+
+.. code:: python
+
+    from ratelimit import limits, RateLimitException
+    from backoff import on_exception, expo
+
+    import requests
+
+    FIFTEEN_MINUTES = 900
+
+    @on_exception(expo, RateLimitException, max_tries=8)
+    @limits(calls=15, period=FIFTEEN_MINUTES)
+    def call_api(url):
+        response = requests.get(url)
+
+        if response.status_code != 200:
+            raise Exception('API response: {}'.format(response.status_code))
+        return response
+
+Alternatively to cause the current thread to sleep until the specified time
+period has ellapsed and then retry the function use the ``sleep_and_retry``
+decorator. This ensures that every function invocation is successful at the
+cost of halting the thread.
+
+.. code:: python
+
+    from ratelimit import limits, sleep_and_retry
+
+    import requests
+
+    FIFTEEN_MINUTES = 900
+
+    @sleep_and_retry
+    @limits(calls=15, period=FIFTEEN_MINUTES)
+    def call_api(url):
+        response = requests.get(url)
+
+        if response.status_code != 200:
+            raise Exception('API response: {}'.format(response.status_code))
+        return response
+
+Contributing
+------------
+
+1. Fork it (https://github.com/tomasbasham/ratelimit/fork)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

env/lib/python3.11/site-packages/ratelimit-2.2.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+ratelimit-2.2.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+ratelimit-2.2.1.dist-info/LICENSE.txt,sha256=14uHNBlWdDYLwdOJ_L5WTXt9TtcKJ5tsTeUGF_JaYkA,1079
+ratelimit-2.2.1.dist-info/METADATA,sha256=ppklaCuI5u5jW6RWm5DDiDrXj2Qp3VMIji3Fcjno2xY,4347
+ratelimit-2.2.1.dist-info/RECORD,,
+ratelimit-2.2.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ratelimit-2.2.1.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+ratelimit-2.2.1.dist-info/top_level.txt,sha256=6_2MrjvsAurbjvmuoRAAjLQZJkx359fKsRuhIVSiEbI,10
+ratelimit/__init__.py,sha256=Q0mWaPTJzUPnrks7HmNc3kBK4E0q8DiWu1X9iWnfQNA,678
+ratelimit/__pycache__/__init__.cpython-311.pyc,,
+ratelimit/__pycache__/decorators.cpython-311.pyc,,
+ratelimit/__pycache__/exception.cpython-311.pyc,,
+ratelimit/decorators.py,sha256=bhIxOEF48da8VQWP8y4PsBXiAAX5g2w67sQ0FYdpwss,4391
+ratelimit/exception.py,sha256=0O8hwvLqDH4CnAIW4Ulu-ieO6FYcbUbMFlxkWp2oaI8,641

env/lib/python3.11/site-packages/ratelimit-2.2.1.dist-info/WHEEL

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

env/lib/python3.11/site-packages/ratelimit-2.2.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+ratelimit