# ical-rs 0.2.0

This is a library to parse the ICalendar format defined in RFC5545, as well asl similar formats like VCard.

There are probably some issues to be taken care of, but the library should work for most cases. If you like to help out and would like to discuss any API changes, please contact me or create an issue.

The initial goal was to make a port from the ical.js library in JavaScript and many code/algorithms was taken from it but in order to but more 'Rusty' a complete rewrite have been made.

Installing

Put this in your Cargo.toml:

toml [dependencies] ical = "0.2.0"

Overview

There is several ways to use Ical depending on the level of parsing you want. Some new wrapper/formater could appeare in the next releases.

Warning

The parsers (LineParser / IcalParser) only parse the content and set to uppercase the case-insensitive fields. No checks are made on the fields validity.

IcalParser

Wrap the result of the LineParser into components.

Each component can contains properties (ie: LineParsed) or sub-components.

Code: ```rust extern crate ical;

use std::io::BufReader; use std::fs::File;

fn main() { let buf = BufReader::new(File::open("/tmp/component.ics") .unwrap());

let reader = ical::IcalReader::new(buf);

for line in reader {
    println!("{:?}", line);
}

} ```

Output: IcalCalendar { properties: [], events: [ IcalEvent { properties: [ LineParsed { ... }, ... ], alarms: [ IcalAlarm { properties: [ LineParsed { ... } ] } ] } ], alarms: [], todos: [], journals: [], free_busys: [], timezones: [] }

LineParser

Parse the result of LineReader into three parts:

• The name of the line attribute formated in uppercase.
• A vector of (key/value) tuple for the parameters. The key is formatted in uppercase and the value is untouched.
• The value stay untouched.

Example:

Code: ```rust extern crate ical;

use std::io::BufReader; use std::fs::File;

fn main() { let buf = BufReader::new(File::open("/tmp/component.ics") .unwrap());

let reader = ical::LineParser::from_reader(buf);

for line in reader {
    println!("{:?}", line);
}

```

Input -> Output: begin:VCALENDAR Ok(LineParsed { name: "BEGIN", params: None, value: "VCALENDAR" }) ATTENDEE;cn=FooBar:mailto:foo3@bar -> Ok(LineParsed { name: "ATTENDEE", params: Some([("CN", "FooBar")]), value: "mailto:foo3@bar" }) END:VCALENDAR Ok(LineParsed { name: "END", params: None, value: "VCALENDAR" })

LineReader

This is a very low level parser. It only unfold the lines.

Individual lines within vCard/ICal are delimited by the RFC5322 line break.

Example:

Code: ```rust extern crate ical;

use std::io::BufReader; use std::fs::File;

fn main() { let buf = BufReader::new(File::open("/tmp/component.ics") .unwrap());

let reader = ical::LineReader::new(buf);

for line in reader {
    println!("{}", line);
}

} ```

Input -> Output:

BEGIN:VCALENDAR Line 0: BEGIN:VCALENDAR BEGIN:VEVENT Line 1: BEGIN:VEVENT SUMMARY:foo and -> Line 3: SUMMARY:foo andbar bar END:VEVENT Line 4: END:VEVENT END:VCALENDAR Line 5: END:VCALENDAR