Support iCloud Drive "Trash" operations (enter "Trash", "Restore" files, and "Delete forever" files from Trash.)

[ebob9]

The request

Support iCloud Drive "Trash" operations (enter "Trash", "Restore" files, and "Delete forever" files from Trash.)

Trash on iCloud Drive is a hidden folder (drivewsid of FOLDER::com.apple.CloudDocs::TRASH_ROOT). The current code actually interacts quite well with this folder, if a way of referencing it is added.

After the folder can be accessed, it's trivial to add "Recover" and "Delete Forever" functions (using icloud.com operations as an example.)

Environment

• pyiCloud version (pip show pyicloud):

(.venv) ebob9-mac:icloud_drive_bug_workaround ebob9$ pip show pyicloud
Name: pyicloud
Version: 1.0.0
Summary: PyiCloud is a module which allows pythonistas to interact with iCloud webservices.
Home-page: https://github.com/picklepete/pyicloud
Author: 
Author-email: 
License: MIT
Location: /Users/ebob9/Desktop/longterm_project/pub/icloud_drive_bug_workaround/.venv/lib/python3.12/site-packages
Requires: certifi, click, keyring, keyrings.alt, requests, tzlocal
Required-by: 

• Python version (python -V):

(.venv) ebob9-mac:icloud_drive_bug_workaround ebob9$ python -V
Python 3.12.2

• Operating environment (project deps/Docker/Windows/etc.):
  MacOS Sequoia w/Python 3.12 (homebrew)

Checklist

• I've looked informations into the README.
• I've looked informations into the pyiCloud's code.

Additional information

I've already built this feature as part of work that I needed to workaround an iCloud defect (file name too long error for hidden .file in trash.) I will be submitting a pull request for this feature.