gcal#

An iCal (.ics) parser for Gleam. Parses VCALENDAR and VEVENT components with full support for folded lines, escaped text, property parameters, and timezone-aware datetime resolution.

gleam add gcal

import gcal
import gleam/time/timestamp

pub fn main() {
  let ical = "BEGIN:VCALENDAR\nVERSION:2.0\nPRODID:-//Test//EN\n"
    <> "BEGIN:VEVENT\nSUMMARY:Meeting\n"
    <> "DTSTART:20230101T100000Z\nDTEND:20230101T110000Z\n"
    <> "UID:123@test\nEND:VEVENT\nEND:VCALENDAR"

  let assert Ok(calendar) = gcal.parse(ical)

  calendar.timezone
  // -> "UTC"

  let assert [event] = calendar.events
  event.summary
  // -> "Meeting"
  event.is_all_day
  // -> False
  timestamp.to_unix_seconds(event.dtstart)
  // -> 1672567200.0
}

API#

• parse(input: String) -> Result(Calendar, Error) — parse an iCal string. Floating times resolve to X-WR-TIMEZONE or UTC.
• parse_with_timezone(input: String, tz: String) -> Result(Calendar, Error) — override the timezone for floating times.

Development#

gleam test  # Run the tests