/rust_rrule

Rust crate for working with recurrence rules for calendar dates as defined in the iCalendar RFC and more.

Primary LanguageRustMIT LicenseMIT

RRule.rs

A pure and efficient Rust implementation of recurrence rules as defined in the iCalendar RFC..

Warning

This crate is not production ready yet. Dates and recurrence rules are quite complicated and takes time to get right. Even though this crate is well tested (high code coverage), there are still tests missing regarding edge cases in stuff like DST, time zone and rfc_string parsing (contributions are very welcome!). Use at your own risk!

Quick start

extern crate rrule;

use rrule::RRule;

// RRule that starts 2012.02.01 and occurs daily for 3 days.
let rrule: RRule = "DTSTART:20120201T093000Z\nRRULE:FREQ=DAILY;COUNT=3".parse().unwrap();

// Get all recurrences of the rrule
let recurrences = rrule.all(); // Or rrule.into_iter().collect::<Vec<_>>(); if you want to leverage iterators
assert_eq!(recurrences.len(), 3);

Documentation and more examples

Documentation and more examples

License

This project is licensed under the MIT license.

Inspired by

TODOS

  • cache
  • more tests around string parsing and validation