61 lines
2.1 KiB
Python
61 lines
2.1 KiB
Python
"""Assorted utilities shared between parts of apitools."""
|
|
|
|
import random
|
|
|
|
|
|
def calculate_wait_for_retry(retry_attempt, max_wait=60):
|
|
"""Calculate the amount of time to wait before a retry attempt.
|
|
|
|
Wait time grows exponentially with the number of attempts. A
|
|
random amount of jitter is added to spread out retry attempts from
|
|
different clients.
|
|
|
|
:type retry_attempt: integer
|
|
:param retry_attempt: Retry attempt counter.
|
|
|
|
:type max_wait: integer
|
|
:param max_wait: Upper bound for wait time [seconds].
|
|
|
|
:rtype: integer
|
|
:returns: Number of seconds to wait before retrying request.
|
|
"""
|
|
|
|
wait_time = 2 ** retry_attempt
|
|
max_jitter = wait_time / 4.0
|
|
wait_time += random.uniform(-max_jitter, max_jitter)
|
|
return max(1, min(wait_time, max_wait))
|
|
|
|
|
|
def acceptable_mime_type(accept_patterns, mime_type):
|
|
"""Check that ``mime_type`` matches one of ``accept_patterns``.
|
|
|
|
Note that this function assumes that all patterns in accept_patterns
|
|
will be simple types of the form "type/subtype", where one or both
|
|
of these can be "*". We do not support parameters (i.e. "; q=") in
|
|
patterns.
|
|
|
|
:type accept_patterns: list of string
|
|
:param accept_patterns: acceptable MIME types.
|
|
|
|
:type mime_type: string
|
|
:param mime_type: the MIME being checked
|
|
|
|
:rtype: boolean
|
|
:returns: True if the supplied MIME type matches at least one of the
|
|
patterns, else False.
|
|
"""
|
|
if '/' not in mime_type:
|
|
raise ValueError(
|
|
'Invalid MIME type: "%s"' % mime_type)
|
|
unsupported_patterns = [p for p in accept_patterns if ';' in p]
|
|
if unsupported_patterns:
|
|
raise ValueError(
|
|
'MIME patterns with parameter unsupported: "%s"' % ', '.join(
|
|
unsupported_patterns))
|
|
|
|
def _match(pattern, mime_type):
|
|
"""Return True iff mime_type is acceptable for pattern."""
|
|
return all(accept in ('*', provided) for accept, provided
|
|
in zip(pattern.split('/'), mime_type.split('/')))
|
|
|
|
return any(_match(pattern, mime_type) for pattern in accept_patterns)
|