retryable-requests

Easy to use retryable requests sessions.

Quickstart

Common case

from retryable_requests import RetryableSession

session = RetryableSession()
session.get('https://httpbin.org/get')  # will be retried up to 5 times

Only retry on 429 errors

from requests.packages.urllib3.util.retry import Retry
from retryable_requests import RetryableSession

retry_strategy = Retry(
    total=5,
    status_forcelist=[429],
    backoff_factor=0.1,
)

session = RetryableSession(retry_strategy=retry_strategy)
session.get('https://httpbin.org/get')  # will be retried up to 5 times, only for 429 errors

Automatically use a base URL for every request

from retryable_requests import RetryableBaseUrlSession

session = RetryableBaseUrlSession('https://httpbin.org/')
session.get('get')  # 'https://httpbin.org/get' will be retried up to 5 times
session.post('post')  # 'https://httpbin.org/post' won't be retried (POST request)

Features

• Automatic backing off retries for failed requests that can be safely retried
• Quick timeouts for non-responsive requests
• BaseUrl compatible version of a RetryableSession

See also

• urllib3.util.Retry
• requests.Session
• requests_toolbelt.sessions.BaseUrlSession
• Timeouts in Requests