The goal of grateful is to make it very easy to cite the R packages used in any report or publication. By calling a single function, it will scan the project for R packages used, and generate a document with citations in the desired output format (Word, PDF, HTML, Markdown). Importantly, these references can be formatted for a specific journal so that we can just paste them directly into the bibliography of our manuscript or report.

library(devtools)
install_github("Pakillo/grateful")

Imagine a project where we are using the following packages: readr, dplyr, vegan, lme4, and ggplot2. Calling cite_packages will scan the project, find these packages, and generate a document with formatted citations.

library(grateful)
cite_packages()

This document can also be a Word document, or PDF, or markdown. And use the citation style of a particular journal:

cite_packages(style = "ecology", out.format = "docx")

cite_packages is a wrapper function which internally performs the following steps:

1 Scan the project for packages

pkgs <- scan_packages()

2 Get citations for each package

cites <- get_citations(pkgs)

3 Create an rmarkdown document citing all these packages

rmd <- create_rmd(cites)

4 Rendering the rmarkdown document to the desired output format

render_citations(rmd, output = "html")