Вспомогательные средства

class yadisk.utils.CaseInsensitiveDict(*args, **kwargs)

Словарь, нечувствительный к регистру. Все ключи преобразуются в нижний регистр.

get(key: str, /, *args, **kwargs) → Any

Return the value for key if key is in the dictionary, else default.

pop(k[, d]) → v, remove specified key and return the corresponding value.

If the key is not found, return the default if given; otherwise, raise a KeyError.

setdefault(key: str, *args, **kwargs) → Any

Insert key with a value of default if key is not in the dictionary.

Return the value for key if key is in the dictionary, else default.

update([E, ]**F) → None.  Update D from dict/iterable E and F.

If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k]

async yadisk.utils.async_auto_retry(func: Callable[[...], Any] | Callable[[...], Awaitable[Any]], n_retries: int | None = None, retry_interval: int | float | None = None, args: tuple | None = None, kwargs: dict[str, Any] | None = None, retry_on: tuple[type[Exception], ...] = ()) → Any

Выполняет запрос с автоматическими повторными попытками. Повторная попытка может быть вызвана RequestError или RetriableYaDiskError, если у исключения не задан атрибут disable_retry=True.

Параметры:

• func – Функция, подлежащая исполнению, не должна требовать аргументов

• n_retries – int, максимальное число повторных попыток запроса

• retry_interval – int или float, задержка между повторными попытками в секундах

• args – tuple или None, дополнительные аргументы для func

• kwargs – dict или None, дополнительные keyword-аргументы для func

• retry_on – tuple, дополнительные классы исключений, которые вызовут повторную попытку

Результат:

Значение, возвращаемое func()

yadisk.utils.auto_retry(func: Callable[[...], T], n_retries: int | None = None, retry_interval: int | float | None = None, args: tuple | None = None, kwargs: dict[str, Any] | None = None, retry_on: tuple[type[Exception], ...] = ()) → T

Выполняет запрос с автоматическими повторными попытками. Повторная попытка может быть вызвана RequestError или RetriableYaDiskError, если у исключения не задан атрибут disable_retry=True.

Параметры:

• func – Функция, подлежащая исполнению, не должна требовать аргументов

• n_retries – int, максимальное число повторных попыток запроса

• retry_interval – int или float, задержка между повторными попытками в секундах

• args – tuple или None, дополнительные аргументы для func

• kwargs – dict или None, дополнительные keyword-аргументы для func

• retry_on – tuple, дополнительные классы исключений, которые вызовут повторную попытку

Результат:

Значение, возвращаемое func()

yadisk.utils.get_exception(response: Response | AsyncResponse, error: ErrorObject | None) → YaDiskError

Возвращает объект исключения, основываясь на ответе (подразумевается, что запрос не удался).

Параметры:

• response – объект Response или AsyncResponse

• error – экземпляр ErrorObject или None

Результат:

Объект исключения, подкласс YaDiskError