Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/andrie/gcalendr

R package to read events from google calendar
https://github.com/andrie/gcalendr

Last synced: about 2 months ago
JSON representation

R package to read events from google calendar

Awesome Lists containing this project

README

        

---
output: github_document
always_allow_html: yes
---

```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "README-"
)
htmltools::tagList(rmarkdown::html_dependency_font_awesome())
```

# gcalendr

[![R build status](https://github.com/andrie/gcalendr/workflows/R-CMD-check/badge.svg)](https://github.com/andrie/gcalendr/actions)
[![Travis build status](https://travis-ci.org/andrie/gcalendr.svg?branch=master)](https://travis-ci.org/andrie/gcalendr)
[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)
[![CRAN status](https://www.r-pkg.org/badges/version/gcalendr)](https://cran.r-project.org/package=gcalendr)
[![Codecov test coverage](https://codecov.io/gh/andrie/gcalendr/branch/master/graph/badge.svg)](https://codecov.io/gh/andrie/gcalendr?branch=master)

This package enables you to read events from google calendar.

## Installation

The package is not yet on CRAN.

You can install the development version of `gcalendr` from github using:

```{r gh-installation, eval = FALSE}
# install.packages("devtools")
devtools::install_github("andrie/gcalendr")
```

## Example

Use this example to authenticate, list available calendars and view events:

```{r eval=FALSE}
library(gcalendr)

## Set up google oauth permissions
## This will prompt you to specify an account
calendar_auth()

```

```{r eval=FALSE}
## To specify a specific account, provide your account id, typically an email address
calendar_auth("[email protected]")

## Retrieve tibble of available calenders
calendar_ids <- calendar_list()
calendar_ids

## Retrieve tibble of events from a specific calendar

my_cal_id <- "[email protected]"
events <- calendar_events(my_cal_id, days_in_past = 90, days_in_future = 90)
events
```