#iCalendar #ical #ics #calendar

ics

A library for creating iCalendar files as specified in RFC5545 and RFC7986

11 unstable releases (3 breaking)

0.4.1 Jul 11, 2019
0.4.0 Jul 11, 2019
0.3.2 May 11, 2019
0.3.1 Apr 10, 2019
0.1.1 Oct 30, 2018

#12 in Date and time

Download history 1/week @ 2019-03-28 10/week @ 2019-04-04 16/week @ 2019-04-11 2/week @ 2019-04-18 12/week @ 2019-04-25 9/week @ 2019-05-02 19/week @ 2019-05-09 23/week @ 2019-05-16 32/week @ 2019-05-23 9/week @ 2019-05-30 20/week @ 2019-06-06 1/week @ 2019-06-13 55/week @ 2019-06-20 30/week @ 2019-06-27 58/week @ 2019-07-04

93 downloads per month

MIT/Apache

55KB
1K SLoC

Crates.io Crates.io Build Status Documentation

A library for creating iCalendar files as specified in RFC5545 and RFC7986.

Minimum supported rustc

1.26.0+

This version is officially supported and tested in CI. Changes to the minimum supported version will be noted in the Changelog.

Installation

To use this library add the library as a dependency in your Cargo.toml:

[dependencies]
ics = "0.4"

Optionally you can disable default features.

[dependencies.ics]
version = "0.4"
default-features = false

Features

  • rfc7986 (enabled by default): adds properties from the newer specification

Usage

extern crate ics;

use ics::properties::{Categories, Description, DtEnd, DtStart, Organizer, Status, Summary};
use ics::{escape_text, Event, ICalendar};

fn main() -> std::io::Result<()> {
    // create new iCalendar object
    let mut calendar = ICalendar::new("2.0", "-//xyz Corp//NONSGML PDA Calendar Version 1.0//EN");

    // create event which contains the information regarding the conference
    let mut event = Event::new("b68378cf-872d-44f1-9703-5e3725c56e71", "19960704T120000Z");
    // add properties
    event.push(Organizer::new("mailto:jsmith@example.com"));
    event.push(DtStart::new("19960918T143000Z"));
    event.push(DtEnd::new("19960920T220000Z"));
    event.push(Status::confirmed());
    event.push(Categories::new("CONFERENCE"));
    event.push(Summary::new("Networld+Interop Conference"));
    // values that are "TEXT" must be escaped (only if the text contains a comma,
    // semicolon or backlash)
    event.push(Description::new(escape_text(
        "Networld+Interop Conference and Exhibit\n\
         Atlanta World Congress Center\n\
         Atlanta, Georgia"
    )));
    // add event to calendar
    calendar.add_event(event);

    // write calendar to file
    calendar.save_file("event.ics")?;
    Ok(())

    /* inside event.ics
    BEGIN:VCALENDAR
    VERSION:2.0
    PRODID:-//xyz Corp//NONSGML PDA Calendar Version 1.0//EN
    BEGIN:VEVENT
    UID:b68378cf-872d-44f1-9703-5e3725c56e71
    DTSTAMP:19960704T120000Z
    ORGANIZER:mailto:jsmith@example.com
    DTSTART:19960918T143000Z
    DTEND:19960920T220000Z
    STATUS:CONFIRMED
    CATEGORIES:CONFERENCE
    SUMMARY:Networld+Interop Conference
    DESCRIPTION:Networld+Interop Conference and Exhibit
    Atlanta World Congress
     Center
    Atlanta\, Georgia
    END:VEVENT
    END:VCALENDAR
    */
}

License

Licensed under either of

at your option.

Contribution

Contributions are always welcome! Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps