Crate libdav

This library contains caldav and carddav clients.

See CalDavClient and CardDavClient as a useful entry points.

Both clients wrap a dav::WebDavClient, and implement Deref<Target = DavClient>, so all of WebDavClient’s associated functions for are usable directly.

Service discovery

DNS-based service discovery is implemented in sd::find_context_url.

The implementation does not validate DNSSEC signatures. Because of this, discovery must only be used with a validating DNS resolver (as defined in rfc4033), or with domains served from a local, trusted networks.

Hrefs

All href strings returned by the server are unquoted by this library before being returned to consumers. I.e.: you should assume that all hrefs have been url-decoded for you.

All functions that take a parameter named href (or similar ones like calendar_href) expect their input to NOT be URL-encoded. I.e.: you do not need to perform any quoting.

See also

The source code is currently hosted at https://git.sr.ht/~whynothugo/libdav.

Modules

• auth
  Authentication-related types.
• dav
  Generic webdav implementation.
• names
  Names of common dav attributes and properties.
• sd
  Service discovery helpers.
• xmlutils
  Utilities for handling XML data.

Structs

• CalDavClient
  Client to communicate with a caldav server.
• CardDavClient
  Client to communicate with a carddav server.
• FetchedResource
  A parsed resource fetched from a server.
• FetchedResourceContent
  See FetchedResource
• FindHomeSetError
  Error finding home set.
• ItemDetails
  Details of a single item that are returned when listing them.
• ResourceType

Enums

• CheckSupportError
  Returned when checking support for a feature encounters an error.
• InvalidUrl
  A supplied Url was not valid.

Functions

• caldav_service_for_url
  Return the service type based on a URL’s scheme.
• carddav_service_for_url
  Return the service type based on a URL’s scheme.

Type Aliases

• PropertyName
  A WebDav property with a namespace and name.