minicaldav

Small and easy CalDAV client.

minicaldav is a caldav client and basic ical parser with as little dependencies as possible (but practical).

Project scope:

• Simple: Few dependencies, no async, the code is simple
• Correct: CalDAV and ICAL are implemented correctly
• Tested: CalDAV works with Events, and is tested with multiple common services
• Easy to use: Good documentation and intuitive API

Project status

• minicaldav is neither correct nor sufficient tested at this point
  • Tested only with one caldav server
• minicaldav is kind of activley maintained as part of https://gitlab.com/floers/karlender
• minicaldav is used in a public app: https://gitlab.com/floers/karlender

Quick Start

rust use url::Url; use ureq::Agent; pub fn main() { let agent = Agent::new(); let url = Url::parse("http://mycaldav.com/").unwrap(); let username = "foo"; let password = "s3cret!"; let calendars = minicaldav::get_calendars(agent.clone(), username, password, &url).unwrap(); for calendar in calendars { println!("{:?}", calendar); let (events, errors) = minicaldav::get_events(agent.clone(), username, password, &calendar).unwrap(); for event in events { println!("{:?}", event); } for error in errors { println!("Error: {:?}", error); } } }

Features

minicaldav can either provide a ready-to-use caldav client by using all features or provide only parts.

The bare minimum is just the ical types and parser:

minicaldav = { version = "*", default-features = false, features = [ "ical" ] }

If you want to have a caldav client:

minicaldav = { version = "*" }

If you do need serde:

minicaldav = { version = "*", features = [ "serde" ] }

If you want to compile a basic CLI:

cargo build --bin minicaldav-cli --features cli