'iCalendar' Parsing

A simple wrapper around the 'ical.js' library executing 'Javascript' code via 'V8' (the 'Javascript' engine driving the 'Chrome' browser and 'Node.js' and accessible via the 'V8' R package). This package enables users to parse 'iCalendar' files ('.ics', '.ifb', '.iCal', '.iFBf') into lists and 'data.frames' to ultimately do statistics on events, meetings, schedules, birthdays, and the like.


Status

lines of R code: 92, lines of test code: 62

Project Status: Initial development is in progress, but there has notyet been a stable, usable release suitable for thepublic. AppVeyor buildstatus Codecov

Development version

0.1.3 - 2018-11-05 / 12:41:40

Description

A simple wrapper around the ‘ical.js’ library executing Javascript code via V8 (the Javascript engine driving the Chrome and ‘Node.js’ and accessible via the V8 R package). This package enables users to parse iCalendar files (.ics, .ifb, .iCal, .iFBf).

License

MIT + file LICENSE
c( person( “Peter”, “Meissner”, role = c(“aut”, “cre”), email = “[email protected]” ), person( “Philipp”, “Kewisch”, role = “cph”, comment = “Ical.js file is is licences under MPL. Source: https://github.com/mozilla-comm/ical.js” ) )

Contribution - AKA The-Think-Twice-Be-Nice-Rule

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms:

http://contributor-covenant.org/version/1/0/0/

Installation

Installation and start - stable version

install.packages("ical")
 
library(ical)

Installation and start - development version

if (!require("V8")) {
  install.packages("V8")
}
 
devtools::install_github("petermeissner/ical")
 
library(ical)

Usage

laoding package

library(ical)

get path to a ical file

ical_file <- system.file("birthdays.ics", package = "ical")

parse file to data.frame

ical_parse_df(ical_file)
##                                         uid              summary               start                 end
## 1 [email protected] PErson #2's birthday 2014-12-10 01:00:00 2014-12-11 01:00:00
## 2      [email protected] PErson #2's birthday 2012-12-10 01:00:00 2012-12-11 01:00:00
## 3      [email protected] PErson #2's birthday 2013-12-10 01:00:00 2013-12-11 01:00:00
## 4      [email protected] PErson #2's birthday 2014-12-10 01:00:00 2014-12-11 01:00:00
##                      description       last.modified    status
## 1                           <NA> 2012-12-07 19:30:41 CONFIRMED
## 2 Today is PErson #2's birthday! 2012-12-07 19:30:41 CONFIRMED
## 3 Today is PErson #2's birthday! 2012-12-07 19:30:41 CONFIRMED
## 4 Today is PErson #2's birthday! 2012-12-07 19:30:41 CONFIRMED

News

ical 0.1.5 -- 2018-11-27

  • CRAN compliance: quoting all software words in description

ical 0.1.4 -- 2018-11-17

  • CRAN compliance: adding examples

ical 0.1.3 -- 2018-11-06

  • CRAN compliance: title case; quoting; improve package description

ical 0.1.2 -- 2018-11-05

  • Added a further tests
  • Added a NEWS.md file to track changes to the package.

ical 0.1.1 -- 2018-10-24

  • fix: ical_parse_df() would not return data.frame()

ical 0.1.0 -- 2018-10-11

  • setting things up
  • sketching things out

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("ical")

0.1.6 by Peter Meissner, 10 months ago


Browse source code at https://github.com/cran/ical


Authors: Peter Meissner [aut, cre] , Philipp Kewisch [cph] (Ical.js file is is licences under MPL. Source: https://github.com/mozilla-comm/ical.js)


Documentation:   PDF Manual  


MIT + file LICENSE license


Imports V8

Suggests testthat, covr


See at CRAN