Expand description
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 href
s 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§
- Authentication-related types.
- Generic webdav implementation.
- Names of common dav attributes and properties.
- Service discovery helpers.
- Utilities for handling XML data.
Structs§
- Client to communicate with a caldav server.
- Client to communicate with a carddav server.
- A parsed resource fetched from a server.
- See
FetchedResource
- Error finding home set.
- Details of a single item that are returned when listing them.
Enums§
- Returned when checking support for a feature encounters an error.
- A supplied Url was not valid.
Functions§
- Return the service type based on a URL’s scheme.
- Return the service type based on a URL’s scheme.
Type Aliases§
- A WebDav property with a
namespace
andname
.