Your first package!

This workshop shows you how to make version controlled package linked to a remote repository on GitHub using the devtools approach.

Learning Objectives

At the end of this module the successful learner will be able to:

• create a simple version controlled package
• explain the key components of a minimal package
• use the package interactively with load_all()
• link a local version controlled package to a remote repository on GitHub
• use check() to execute R CMD check
• populate a DESCRIPTION and LICENSE files

Prerequisites

You need to have:

• "Packages in a nutshell" or equivalent experience
• "Setting up your system" or equivalent experience
• the packages devtools, roxygen2, testthat and knitr installed
• R build toolchain: Rtools(windows) or XCode (mac) or r-base-dev

About R Forwards

R Forwards is an R Foundation task force that was originally set up in December 2015 to address the underrepresentation of women in the R community. An analysis of CRAN package maintainers estimated that fewer than 15% were women, and a useR! participant survey found that women were less likely than men to have experience contributing to or writing packages. In 2017 it was rebranded to accommodate other under-represented groups such as LGBTQI, minority ethnic groups, and people with disabilities.

Forwards have delivered face-to-face one-day workshops in Package development, supported by a grant from the R Consortium, for several years. These are heavily based on the R packages book by Hadley Wickham and Jenny Bryan. Recently we have been modularising our workshop materials to increase our reach by developing and delivering approximately one hour workshops suitable for online delivery and easy reuse by others.

Module design guiding principles