Библиотека-клиент REST API Яндекс.Диска с поддержкой async/await / Yandex.Disk REST API client library with async/await support
Project description
YaDisk-async - это библиотека-клиент REST API Яндекс.Диска с поддержкой async/await.
Документация доступна на Read the Docs (RU) и Read the Docs (EN).
Установка
pip install yadisk-async
или
python setup.py install
Примеры
import yadisk_async
y = yadisk_async.YaDisk(token="<token>")
# или
# y = yadisk_async.YaDisk("<id-приложения>", "<secret-приложения>", "<токен>")
# Проверяет, валиден ли токен
print(await y.check_token())
# Получает общую информацию о диске
print(await y.get_disk_info())
# Выводит содержимое "/some/path"
print([i async for i in await y.listdir("/some/path")])
# Загружает "file_to_upload.txt" в "/destination.txt"
await y.upload("file_to_upload.txt", "/destination.txt")
# То же самое
with open("file_to_upload.txt", "rb") as f:
await y.upload(f, "/destination.txt")
# Скачивает "/some-file-to-download.txt" в "downloaded.txt"
await y.download("/some-file-to-download.txt", "downloaded.txt")
# Безвозвратно удаляет "/file-to-remove"
await y.remove("/file-to-remove", permanently=True)
# Создаёт новую папку "/test-dir"
print(await y.mkdir("/test-dir"))
# Всегда закрывайте все соединения или получите предупреждение
await y.close()
История изменений
Release 1.3.0 (2019-07-06)
Реализована поддержка async/await
Библиотека была переименована из yadisk в yadisk-async
Следующие релизы относятся к оригинальной библиотеке yadisk:
Release 1.2.14 (2019-03-26)
Исправлена ошибка
TypeError
в функцияхget_public_*
при использовании с параметромpath
(issue #7)Добавлен аттрибут
unlimited_autoupload_enabled
дляDiskInfoObject
Release 1.2.13 (2019-02-23)
Добавлен
md5
параметр дляremove()
Добавлен
UserPublicInfoObject
Добавлен аттрибут
country
дляUserObject
Добавлен аттрибут
photoslice_time
дляResourceObject
,PublicResourceObject
иTrashResourceObject
Release 1.2.12 (2018-10-11)
Исправлен баг: не работает параметр fields в listdir() (issue #4)
Release 1.2.11 (2018-06-30)
Добавлен недостающий параметр
sort
дляget_meta()
Добавлены аттрибуты
file
иantivirus_status
дляResourceObject
,PublicResourceObject
иTrashResourceObject
Добавлен параметр
headers
Исправлена опечатка в
download()
иdownload_public()
(issue #2)Убран параметр
*args
Release 1.2.10 (2018-06-14)
Исправлено поведение
timeout=None
.None
должен означать „без таймаута“, но в предыдущих версиях значениеNone
было синонимично со стандартным таймаутом.
Release 1.2.9 (2018-04-28)
Изменена лицензия на LGPLv3 (см.
COPYING
иCOPYING.lesser
)Другие изменения информации о пакете
Release 1.2.8 (2018-04-17)
Исправлено несколько опечаток: у
PublicResourceListObject.items
иTrashResourceListObject.items
были неправильные типы данныхПсевдонимы полей в параметре
fields
заменяются при выполнении запросов API (например,embedded
->_embedded
)
Release 1.2.7 (2018-04-15)
Исправлен баг перемотки файла при загрузке/скачивании после повторной попытки
Release 1.2.6 (2018-04-13)
Теперь объекты сессий
requests
кэшируются, чтобы их можно было переиспользовать (иногда может существенно ускорить выполнение запросов)keep-alive
отключается при загрузке/скачивании файлов по умолчанию
Release 1.2.5 (2018-03-31)
Исправлен баг (ошибка на единицу) в
utils.auto_retry()
(иногда мог вызватьAttributeError
)Повторные попытки применяются для
upload()
,download()
иdownload_public()
целикомЗадано
stream=True
дляdownload()
иdownload_public()
Другие мелкие исправления
Release 1.2.4 (2018-02-19)
Исправлена опечатка (
TokenObject.exprires_in
->TokenObject.expires_in
)
Release 1.2.3 (2018-01-20)
Исправлено
TypeError
при вызовеWrongResourceTypeError
Release 1.2.2 (2018-01-19)
refresh_token()
больше не требует валидный или пустой токен.
Release 1.2.1 (2018-01-14)
Исправлена неработоспособность повторных попыток.
Release 1.2.0 (2018-01-14)
Исправлено использование
n_retries=0
вupload()
,download()
иdownload_public()
upload()
,download()
иdownload_public()
больше не возвращают ничего (см. документацию)Добавлен модуль
utils
(см. документацию)Добавлены
RetriableYaDiskError
,WrongResourceTypeError
,BadGatewayError
иGatewayTimeoutError
listdir()
теперь вызываетWrongResourceTypeError
вместоNotADirectoryError
Release 1.1.1 (2017-12-29)
Исправлена обработка аргументов в
upload()
,download()
иdownload_public()
. До этого использованиеn_retries
иretry_interval
вызывало исключение (TypeError
).
Release 1.1.0 (2017-12-27)
Усовершенствованные исключения (см. документацию)
Добавлена поддержка параметра
force_async
Мелкие исправления багов
Release 1.0.8 (2017-11-29)
Исправлен ещё один баг в
listdir()
Release 1.0.7 (2017-11-04)
Добавлен
install_requires
вsetup.py
Release 1.0.6 (2017-11-04)
Некоторые функции теперь возвращают
OperationLinkObject
Release 1.0.5 (2017-10-29)
Исправлен
setup.py
, теперь исключает тесты
Release 1.0.4 (2017-10-23)
Исправлены баги в
upload
,download
иlistdir
Значение по-умолчанию
limit
вlistdir
установлено в10000
Release 1.0.3 (2017-10-22)
Добавлен модуль
settings
Release 1.0.2 (2017-10-19)
Исправлена функция
get_code_url
(добавлены недостающие параметры)
Release 1.0.1 (2017-10-18)
Исправлен серьёзный баг в
GetTokenRequest
(добавлен недостающий параметр)
Release 1.0.0 (2017-10-18)
Первый релиз
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for yadisk_async-1.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e82dfa83e4737fc4ef921e958479888d2e49ebf6b2862035cf359b444e96dc44 |
|
MD5 | a14a20831dd14a3451537e29a953dea0 |
|
BLAKE2b-256 | ce183516eabb751fe98fa80f1a030af62614281d3e280298c5aafb9ce8f378ec |