requests-ratelimit-adapter

A ratelimiting Session adapter for requests.

• Free software: MIT license
• Documentation: https://requests-ratelimit-adapter.readthedocs.io.

Example

>>> from requests_ratelimit_adapter import HTTPRateLimitAdapter
>>> import requests
>>> import time

>>> # Create a rate limiting adapter
>>> rate_limiter = HTTPRateLimitAdapter(calls=1, period=1)

>>> s = requests.Session()
>>> s.mount("https://", rate_limiter)

>>> # This first request will start the period.
>>> r = s.get("https://httpbin.org/get")
>>> r.raise_for_status()
>>> time1 = time.time()

>>> # This second request will wait 1 second before executing.
>>> r2 = s.get("https://httpbin.org/get")
>>> r2.raise_for_status()
>>> time2 = time.time()

>>> # For this example, verify the timestamps are more than a second apart.
>>> assert time2 >= time1 + 1

Credits

This package was created with Cookiecutter and the cmeister2/cookiecutter-pypackage project template.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Changed

0.2.0 - 2019-01-06

Added

• Wrap the HTTPAdapter code from requests so there's less boilerplate.

0.1.2 - 2018-12-24

Changed

• Use the correct travis password for deploying to PyPI.

0.1.1 - 2018-12-24

Added

• Add travis password for deploying to PyPI.

0.1.0 - 2018-12-24

Added

• Initial commit of code.