PyMailCloud

Unofficial python library for making API requests to Cloud@Mail.ru

Requirements

• requests
• requests_toolbelt
• tqdm

Supported methods

PyMailCloud(login, password)

Creates PyMailCloud object or raises an exception if login and password are incorrect, or internet connection is failed.

PyMailCloud.get_folder_contents(folder)

folder - folder path relative to cloud home

Returns some strange internal mail.ru JSON object containing folder contents.

PyMailCloud.get_public_link(filename)

filename - file path relative to cloud home

Returns full public URL of file (looks like "https://cloud.mail.ru/public/<id>/<filename>"), or rises an exception in case of error.

PyMailCloud.remove_public_link(weblink)

weblink - file path relative to cloud home

Deletes public file link by its weblink, which can be full ("http(s)://cloud.mail.ru/public/<id>/<filename>") or short (just "<id>/<filename>")

Rises an exception in case of error.

PyMailCloud.get_subfolders(folder)

folder - folder path relative to cloud home

Traverses the given folder and returns a list of its subfolders (including the folder itself)

Rises an exception if the folder is not found

PyMailCloud.download_folder_content(folder)

folder - folder path relative to cloud home

Downloads all files inside the folder or nested folders. Currently files are downloaded to the working path of the script respectively to their path inside the cloud.

Rises an exception if the folder is not found

PyMailCloud.download_files(filenamelist)

filenamelist - list of files that should be downloaded

Downloads all files inside the list. Currently files are downloaded to the working path of the script respectively to their path inside the cloud.

Rises an exception if a file is not found

PyMailCloud.upload_files(filenamelist)

filenamelist - list of dicts containing 'filename' and optionally 'path' if file should be uploaded to specific path. Directories will be created automatically

Upload all files inside the list. Files should be passed with the full path inside the system.

Returns the JSON response from the cloud Rises an exception if a file is larger than 2 GB TODO: Check for quota before uploading

PyMailCloud.delete_files(filenamelist)

filenamelist - list of dicts containing 'filename'.

Delete all files inside the list. Files should be passed with the full path inside the cloud.

Returns the JSON response from the cloud