Struct TrashClient 

pub struct TrashClient<'a, T: Transport, A: AuthProvider> { /* private fields */ }

WebDAV client for interacting with Nextcloud’s trashbin endpoints.

Executes calls through any Transport and applies credentials via an AuthProvider. Both are held by reference, allowing the client to be freely cloned or borrowed across tasks without runtime dispatch or connection pooling overhead.

Supported operations:

• list — inspects deleted items
• restore — restores an item to its original or specified path
• delete — permanently deletes a specific item
• empty — permanently deletes all items in the trashbin

Implementations

impl<'a, T: Transport, A: AuthProvider> TrashClient<'a, T, A>

pub const fn new(transport: &'a T, auth: &'a A) -> Self

Binds a trashbin client to a transport and credential provider.

pub const fn transport(&self) -> &'a T

The transport this client sends requests through.

pub const fn auth(&self) -> &'a A

The credential provider applied to every request.

pub async fn list(&self, user_id: &str) -> Result<Vec<TrashItem>, Error>

Lists all items currently in user_id’s trashbin.

Sends a PROPFIND request with Depth: 1 to /remote.php/dav/trashbin/{user_id}/trash/.

The response must be 207 Multi-Status; any other status becomes Error::Status.

pub async fn restore( &self, user_id: &str, item_id: &str, restore_path: &str, ) -> Result<(), Error>

Restores a deleted item from the trashbin.

Sends a MOVE request from /remote.php/dav/trashbin/{user_id}/trash/{item_id} to /remote.php/dav/trashbin/{user_id}/restore/{restore_path} (or the restore folder if restore_path is empty).

Any non-2xx status returns Error::Status.

pub async fn delete(&self, user_id: &str, item_id: &str) -> Result<(), Error>

Permanently deletes a single item from the trashbin.

Sends a DELETE request to /remote.php/dav/trashbin/{user_id}/trash/{item_id}.

Any non-2xx status returns Error::Status.

pub async fn empty(&self, user_id: &str) -> Result<(), Error>

Permanently deletes all items in the user’s trashbin.

Sends a DELETE request to /remote.php/dav/trashbin/{user_id}/trash/.

Any non-2xx status returns Error::Status.

Trait Implementations

impl<'a, T: Clone + Transport, A: Clone + AuthProvider> Clone for TrashClient<'a, T, A>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, T: Copy + Transport, A: Copy + AuthProvider> Copy for TrashClient<'a, T, A>

impl<'a, T: Debug + Transport, A: Debug + AuthProvider> Debug for TrashClient<'a, T, A>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Transport, A: AuthProvider> Display for TrashClient<'_, T, A>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.