libdav

Docs | Source | Issues | Patches | Chat

CalDav and CardDav client implementations. This crate is part of the vdirsyncer project.

Documentation for this library can be generated with cargo doc. The documentation for the stable releases is available at crates.io.

Licence

Copyright 2023-2024 Hugo Osvaldo Barrera
Licensed under the EUPL, Version 1.2 only
SPDX-License-Identifier: EUPL-1.2

lib.rs:

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.