Struct DavClient 

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

WebDAV client generic over the transport and the credential source.

Both are held by reference, so a client can be borrowed into several spawned tasks and share one connection pool and one token.

Implementations

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

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

Binds a client to a transport and a credential source.

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

Transport this client sends through.

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

Credential source applied to every request.

pub async fn propfind( &self, path: &DavPath, depth: Depth, body: &PropfindBody, ) -> Result<Vec<DavResource>, Error>

Asks path for the properties in body, depth levels deep.

The answer must be 207 Multi-Status; any other status becomes Error::Status with the response body retained for diagnosis. A body that is not a multistatus becomes Error::Decode.

pub async fn get(&self, path: &DavPath) -> Result<Vec<u8>, Error>

Downloads the content of the resource at path.

Any non-2xx status returns Error::Status with the response body retained for diagnosis.

pub async fn put( &self, path: &DavPath, body: impl Into<Vec<u8>>, content_type: Option<&str>, ) -> Result<(), Error>

Uploads body to path, optionally specifying the Content-Type header.

Any non-2xx status returns Error::Status with the response body retained for diagnosis.

pub async fn mkcol(&self, path: &DavPath) -> Result<(), Error>

Creates a collection (folder) at path.

Any non-2xx status returns Error::Status with the response body retained for diagnosis.

pub async fn delete(&self, path: &DavPath) -> Result<(), Error>

Deletes the resource or collection at path.

Any non-2xx status returns Error::Status with the response body retained for diagnosis.

pub async fn copy( &self, source: &DavPath, destination: &DavPath, overwrite: bool, ) -> Result<(), Error>

Copies a resource from source to destination.

When overwrite is true, an existing destination is replaced; otherwise the call fails with a status error if the destination exists. Any non-2xx status returns Error::Status with the response body retained for diagnosis.

pub async fn move_( &self, source: &DavPath, destination: &DavPath, overwrite: bool, ) -> Result<(), Error>

Moves a resource from source to destination.

When overwrite is true, an existing destination is replaced; otherwise the call fails with a status error if the destination exists. Any non-2xx status returns Error::Status with the response body retained for diagnosis.

Trait Implementations

impl<'a, T: Clone + Transport, A: Clone + AuthProvider> Clone for DavClient<'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 DavClient<'a, T, A>

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

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

Formats the value using the given formatter.

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

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

A client carries no identifying state worth logging.