Struct DavPath 

pub struct DavPath { /* private fields */ }

Where a resource lives in Nextcloud’s WebDAV tree.

The user name is held separately from the path below it because every endpoint in this crate needs the same files/{user} prefix and nothing else may appear between them. Validation happens once, in DavPath::new, so a later call cannot send a traversal segment or an already-prefixed path.

Implementations

impl DavPath

pub fn root(user: impl AsRef<str>) -> Result<Self, UrlError>

The root of user’s files.

pub fn new( user: impl AsRef<str>, relative: impl AsRef<str>, ) -> Result<Self, UrlError>

The resource at relative below user’s root.

relative is expected to be relative: "" is the root itself, "Photos/img.jpg" a nested file. Traversal segments, empty segments and a leading / are rejected with a UrlError.

pub fn user(&self) -> &str

User whose files this path addresses.

pub fn relative(&self) -> &str

Path below the user’s root, without a leading or trailing slash.

pub fn is_root(&self) -> bool

Whether this path is the user’s root.

pub fn segments(&self) -> impl Iterator<Item = &str>

Segments of the path below the user root, empty for the root itself.

pub fn join(&self, segment: impl AsRef<str>) -> Result<Self, UrlError>

A child of this path, validated like a fresh path.

pub fn as_str(&self) -> &str

Full path including the WebDAV root and the files prefix.

pub fn to_api_path(&self) -> ApiPath

The path as a request target.

Trait Implementations

impl Clone for DavPath

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DavPath

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

Formats the value using the given formatter.

impl Display for DavPath

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

Formats the value using the given formatter.

impl Eq for DavPath

impl Hash for DavPath

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for DavPath

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for DavPath