import importlib
import sys
from functools import wraps
from inspect import isfunction
from random import random
from time import sleep
from types import FunctionType, ModuleType, WrapperDescriptorType
from typing import Any, Callable, Dict, Sequence, Type, Union, no_type_check
[docs]def get_topic(cls: type) -> str:
"""
Returns a string that locates the given class.
"""
topic = f"{cls.__module__}:{cls.__qualname__}"
_objs_cache[topic] = cls
return topic
# Todo: Implement substitutions, so classes can be moved to another module.
[docs]def resolve_topic(topic: str) -> Any:
"""
Returns an object located by the given string.
"""
try:
obj = _objs_cache[topic]
except KeyError:
module_name, _, class_name = topic.partition(":")
module = get_module(module_name)
obj = resolve_attr(module, class_name)
_objs_cache[topic] = obj
return obj
_objs_cache: Dict[str, Any] = {}
def get_module(module_name: str) -> ModuleType:
try:
module = _modules_cache[module_name]
except KeyError:
module = importlib.import_module(module_name)
_modules_cache[module_name] = module
return module
_modules_cache: Dict[str, Any] = {}
def resolve_attr(obj: Any, path: str) -> Any:
if not path:
return obj
else:
head, _, tail = path.partition(".")
obj = getattr(obj, head)
return resolve_attr(obj, tail)
[docs]def retry(
exc: Union[Type[Exception], Sequence[Type[Exception]]] = Exception,
max_attempts: int = 1,
wait: float = 0,
stall: float = 0,
verbose: bool = False,
) -> Callable:
"""
Retry decorator.
:param exc: List of exceptions that will cause the call to be retried if raised.
:param max_attempts: Maximum number of attempts to try.
:param wait: Amount of time to wait before retrying after an exception.
:param stall: Amount of time to wait before the first attempt.
:param verbose: If True, prints a message to STDOUT when retries occur.
:return: Returns the value returned by decorated function.
"""
@no_type_check
def _retry(func):
@wraps(func)
def wrapper(*args, **kwargs):
if stall:
sleep(stall)
attempts = 0
while True:
try:
return func(*args, **kwargs)
except exc as e:
attempts += 1
if max_attempts is None or attempts < max_attempts:
sleep(wait * (1 + 0.1 * (random() - 0.5)))
else:
# Max retries exceeded.
raise e
return wrapper
# If using decorator in bare form, the decorated
# function is the first arg, so check 'exc'.
if isfunction(exc):
# Remember the given function.
_func = exc
# Set 'exc' to a sensible exception class for _retry().
exc = Exception
# Wrap and return.
return _retry(func=_func)
else:
# Check decorator args, and return _retry,
# to be called with the decorated function.
if isinstance(exc, (list, tuple)):
for _exc in exc:
if not (isinstance(_exc, type) and issubclass(_exc, Exception)):
raise TypeError("not an exception class: {}".format(_exc))
else:
if not (isinstance(exc, type) and issubclass(exc, Exception)):
raise TypeError("not an exception class: {}".format(exc))
if not isinstance(max_attempts, int):
raise TypeError("'max_attempts' must be an int: {}".format(max_attempts))
if not isinstance(wait, (float, int)):
raise TypeError("'wait' must be a float: {}".format(max_attempts))
if not isinstance(stall, (float, int)):
raise TypeError("'stall' must be a float: {}".format(max_attempts))
return _retry
[docs]def strtobool(val: str) -> bool:
"""Convert a string representation of truth to True or False.
True values are 'y', 'yes', 't', 'true', 'on', and '1'; false values
are 'n', 'no', 'f', 'false', 'off', and '0'. Raises ValueError if
'val' is anything else.
"""
if not isinstance(val, str):
raise TypeError(f"{val} is not a str")
val = val.lower()
if val in ("y", "yes", "t", "true", "on", "1"):
return True
elif val in ("n", "no", "f", "false", "off", "0"):
return False
else:
raise ValueError("invalid truth value %r" % (val,))
def is_py310() -> bool:
return sys.version_info[0:2] == (3, 10)
def get_method_name(method: Union[FunctionType, WrapperDescriptorType]) -> str:
return is_py310() and method.__qualname__ or method.__name__