init_requests_session

pyhelpers.ops.init_requests_session(url, max_retries=5, backoff_factor=0.1, retry_status='default', **kwargs)[source]

Instantiate a requests session.

Parameters:

url (str) – a valid URL
max_retries (int) – maximum number of retries, defaults to 5
backoff_factor (float) – backoff_factor of urllib3.util.Retry, defaults to 0.1
retry_status – a list of HTTP status codes that force to retry downloading, inherited from status_forcelist of urllib3.util.Retry; when retry_status='default', the list defaults to [429, 500, 502, 503, 504]
kwargs – [optional] parameters of urllib3.util.Retry

Returns:

a requests session

Return type:

requests.Session

Examples:

>>> from pyhelpers.ops import init_requests_session

>>> logo_url = 'https://www.python.org/static/community_logos/python-logo-master-v3-TM.png'

>>> s = init_requests_session(logo_url)

>>> type(s)
requests.sessions.Session