Skip to contents

Overview

R Development Tools: An opinionated collection of development tools, packages, and utilities.

Feel free to use and/or fork this project!

Installation

You can install the development version of rdev from GitHub with:

# install.packages("remotes")
remotes::install_github("jabenninghoff/rdev")

Or using renv:

# install.packages("renv")
renv::install("jabenninghoff/rdev")

Development

  • Changelog: See “Changelog” or NEWS.md.
  • Planned: TODO

Creating Packages

rdev supports creation of new R packages following rdev conventions as well as new R Analysis packages. The typical setup workflow (per ?quickstart) is:

  1. Use available::available() to check package name
  2. With no project open, run create_github_repo() to initialize the GitHub R repository
  3. Without committing to git, run init() in the newly created project
  4. Manually update the Title and Description fields in the DESCRIPTION file without committing
  5. Run setup_analysis() or setup_rdev() to configure the package as an analysis package or rdev package respectively.
  6. Update TODO.md, NEWS.md, README.Rmd, and DESCRIPTION as needed
  7. Re-run check_renv(), ci() to validate package
  8. Commit to git and begin development

GitHub Releases

rdev automates the workflow for creating GitHub releases along with updating GitHub pages for either standard R packages or R analysis packages, using the release notes format in NEWS.md. A typical development workflow is:

  1. Bump version and create new feature branch with new_branch()
  2. Write all the things
  3. Update the release notes for the new version in NEWS.md, following the conventions described in get_release()
  4. Finalize the release and merge all changes to git
  5. Run stage_release() to create a new pull request on GitHub using details derived from NEWS.md, including updating the README and GitHub pages
  6. After the pull request has been reviewed and passes all required status checks, accept the staged release with merge_release(), which merges the pull request, cleans up branches, and publishes a new GitHub release

Feature branches can be merged without starting a new release; stage_release() just requires that everything is committed, including new release notes in NEWS.md before running. When ready to release, stage_release() will use the existing branch if on a feature branch, and create a new release branch if on the default.

Workflow

For my workflow, I typically check renv when I start:

library(rdev)

check_renv()
#> renv::status(dev = TRUE)
#> No issues found -- the project is in a consistent state.
#> 
#> renv::clean()
#> - No stale package locks were found.
#> - No temporary directories were found in the project library.
#> - The project has been cleaned.

I also have a ci() function to run all my continuous integration tests locally:

ci()
#> renv::status(dev = TRUE)
#> No issues found -- the project is in a consistent state.
#> 
#> missing_deps()
#> Finding R package dependencies ... Done!
#> renv::dependencies() not in DESCRIPTION:
#> 
#> pkgdown::check_pkgdown()
#> No problems found
#> 
#> style_all()
#> Styling  67  files:
#>  .Rprofile                                               ✔ 
#>  README.Rmd                                              ✔ 
#>  inst/rmarkdown/templates/analysis/skeleton/skeleton.Rmd ✔ 
#>  inst/templates/analysis.qmd                             ✔ 
#>  inst/templates/changelog.qmd                            ✔ 
#>  inst/templates/index.qmd                                ✔ 
#>  inst/templates/package.R                                ✔ 
#>  inst/templates/README-analysis.Rmd                      ✔ 
#>  inst/templates/README-rdev.Rmd                          ✔ 
#>  inst/templates/spelling.R                               ✔ 
#>  inst/templates/test-spelling.R                          ✔ 
#>  R/build.R                                               ✔ 
#>  R/ci.R                                                  ✔ 
#>  R/helpers.R                                             ✔ 
#>  R/init.R                                                ✔ 
#>  R/package.R                                             ✔ 
#>  R/release.R                                             ✔ 
#>  R/setup.R                                               ✔ 
#>  R/to_document.R                                         ✔ 
#>  R/urlchecker.R                                          ✔ 
#>  R/utils.R                                               ✔ 
#>  tests/spelling.R                                        ✔ 
#>  tests/testthat.R                                        ✔ 
#>  tests/manual/setup.Rmd                                  ✔ 
#>  tests/manual/test-new-repo-1.R                          ✔ 
#>  tests/manual/test-new-repo-2.R                          ✔ 
#>  tests/manual/test-new-repo-3-analysis.R                 ✔ 
#>  tests/manual/test-new-repo-3-package.R                  ✔ 
#>  tests/testthat/test-build.R                             ✔ 
#>  tests/testthat/test-ci.R                                ✔ 
#>  tests/testthat/test-helpers.R                           ✔ 
#>  tests/testthat/test-init.R                              ✔ 
#>  tests/testthat/test-inst.R                              ✔ 
#>  tests/testthat/test-release.R                           ✔ 
#>  tests/testthat/test-setup.R                             ✔ 
#>  tests/testthat/test-spelling.R                          ✔ 
#>  tests/testthat/test-to_document.R                       ✔ 
#>  tests/testthat/test-utils.R                             ✔ 
#>  tests/testthat/test-ci/test-revealjs.qmd                ✔ 
#>  tests/testthat/test-ci/test.Rprofile                    ✔ 
#>  tests/testthat/test-ci/testcode_1.R                     ✔ 
#>  tests/testthat/test-ci/testcode_2.R                     ✔ 
#>  tests/testthat/test-ci/testcode.qmd                     ✔ 
#>  tests/testthat/test-ci/testcode.Rmd                     ✔ 
#>  tests/testthat/test-ci/testcode.Rnw                     ✔ 
#>  tests/testthat/test-ci/packrat/test.R                   ✔ 
#>  tests/testthat/test-ci/R/RcppExports.R                  ✔ 
#>  tests/testthat/test-ci/renv/test.R                      ✔ 
#>  tests/testthat/test-to_document/document.Rmd            ✔ 
#>  tests/testthat/test-to_document/docx.qmd                ✔ 
#>  tests/testthat/test-to_document/extra-spaces.Rmd        ✔ 
#>  tests/testthat/test-to_document/minimal-document.Rmd    ✔ 
#>  tests/testthat/test-to_document/minimal-docx.qmd        ✔ 
#>  tests/testthat/test-to_document/minimal.qmd             ✔ 
#>  tests/testthat/test-to_document/minimal.Rmd             ✔ 
#>  tests/testthat/test-to_document/multiple.Rmd            ✔ 
#>  tests/testthat/test-to_document/no-format.qmd           ✔ 
#>  tests/testthat/test-to_document/no-front-matter.Rmd     ✔ 
#>  tests/testthat/test-to_document/no-output.Rmd           ✔ 
#>  tests/testthat/test-to_document/no-yaml.qmd             ✔ 
#>  tests/testthat/test-to_document/no-yaml.Rmd             ✔ 
#>  tests/testthat/test-to_document/valid.qmd               ✔ 
#>  tests/testthat/test-to_document/valid.Rmd               ✔ 
#>  tests/testthat/test-to_document/with-code.Rmd           ✔ 
#>  vignettes/analysis-package-layout.Rmd                   ✔ 
#>  vignettes/rdev.Rmd                                      ✔ 
#>  vignettes/style-guide.Rmd                               ✔ 
#> ───────────────────────────────────────────────────────
#> Status   Count   Legend 
#> ✔    67  File unchanged.
#> ℹ    0   File changed.
#> ✖    0   Styling threw an error.
#> ───────────────────────────────────────────────────────
#> 
#> lint_all()
#> 
#> devtools::document()
#> ℹ Updating rdev documentation
#> ℹ Loading rdev
#> 
#> desc::desc_normalize()
#> 
#> extra_deps()
#> Finding R package dependencies ... Done!
#> desc::desc_get_deps() not found by renv:
#> # A tibble: 3 × 3
#>   type     package    version
#>   <chr>    <chr>      <chr>  
#> 1 Suggests covr       *      
#> 2 Suggests diffviewer *      
#> 3 Suggests DT         *      
#> 
#> url_check()
#> html_url_check()
#> # A tibble: 2 × 9
#>   URL                        From  Status Message New   CRAN  Spaces R     root 
#>   <chr>                      <nam> <chr>  <chr>   <chr> <chr> <chr>  <chr> <chr>
#> 1 http://covr.r-lib.org/ref… <chr> 200    OK      http… ""    ""     ""    /Use…
#> 2 http://r-lib.github.io/rc… <chr> 200    OK      http… ""    ""     ""    /Use…
#> 
#> Setting env vars: NOT_CRAN="true", CI="true"
#> rcmdcheck::rcmdcheck(args = "--no-manual", error_on = "warning")
#> ── R CMD build ─────────────────────────────────────────────────────────────────
#> * checking for file ‘.../DESCRIPTION’ ... OK
#> * preparing ‘rdev’:
#> * checking DESCRIPTION meta-information ... OK
#> * installing the package to build vignettes
#> * creating vignettes ... OK
#> * checking for LF line-endings in source and make files and shell scripts
#> * checking for empty or unneeded directories
#> * building ‘rdev_1.10.2.tar.gz’
#> 
#> ── R CMD check ─────────────────────────────────────────────────────────────────
#> * using log directory ‘/private/var/folders/vn/cw5f9gws42v9m8mdsds_zbl00000gp/T/RtmpR2SckY/file16a196f52f83e/rdev.Rcheck’
#> * using R version 4.3.3 (2024-02-29)
#> * using platform: aarch64-apple-darwin20 (64-bit)
#> * R was compiled by
#>     Apple clang version 14.0.0 (clang-1400.0.29.202)
#>     GNU Fortran (GCC) 12.2.0
#> * running under: macOS Ventura 13.6.4
#> * using session charset: UTF-8
#> * using option ‘--no-manual’
#> * checking for file ‘rdev/DESCRIPTION’ ... OK
#> * this is package ‘rdev’ version ‘1.10.2’
#> * package encoding: UTF-8
#> * checking package namespace information ... OK
#> * checking package dependencies ... OK
#> * checking if this is a source package ... OK
#> * checking if there is a namespace ... OK
#> * checking for executable files ... OK
#> * checking for hidden files and directories ... OK
#> * checking for portable file names ... OK
#> * checking for sufficient/correct file permissions ... OK
#> * checking whether package ‘rdev’ can be installed ... OK
#> * checking installed package size ... OK
#> * checking package directory ... OK
#> * checking ‘build’ directory ... OK
#> * checking DESCRIPTION meta-information ... OK
#> * checking top-level files ... OK
#> * checking for left-over files ... OK
#> * checking index information ... OK
#> * checking package subdirectories ... OK
#> * checking R files for non-ASCII characters ... OK
#> * checking R files for syntax errors ... OK
#> * checking whether the package can be loaded ... OK
#> * checking whether the package can be loaded with stated dependencies ... OK
#> * checking whether the package can be unloaded cleanly ... OK
#> * checking whether the namespace can be loaded with stated dependencies ... OK
#> * checking whether the namespace can be unloaded cleanly ... OK
#> * checking loading without being on the library search path ... OK
#> * checking dependencies in R code ... OK
#> * checking S3 generic/method consistency ... OK
#> * checking replacement functions ... OK
#> * checking foreign function calls ... OK
#> * checking R code for possible problems ... OK
#> * checking Rd files ... OK
#> * checking Rd metadata ... OK
#> * checking Rd cross-references ... OK
#> * checking for missing documentation entries ... OK
#> * checking for code/documentation mismatches ... OK
#> * checking Rd \usage sections ... OK
#> * checking Rd contents ... OK
#> * checking for unstated dependencies in examples ... OK
#> * checking installed files from ‘inst/doc’ ... OK
#> * checking files in ‘vignettes’ ... OK
#> * checking examples ... OK
#> * checking for unstated dependencies in ‘tests’ ... OK
#> * checking tests ...
#>   Running ‘spelling.R’
#>   Comparing ‘spelling.Rout’ to ‘spelling.Rout.save’ ... OK
#>   Running ‘testthat.R’
#>  OK
#> * checking for unstated dependencies in vignettes ... OK
#> * checking package vignettes in ‘inst/doc’ ... OK
#> * checking running R code from vignettes ...
#>   ‘analysis-package-layout.Rmd’ using ‘UTF-8’... OK
#>   ‘rdev.Rmd’ using ‘UTF-8’... OK
#>   ‘style-guide.Rmd’ using ‘UTF-8’... OK
#>  NONE
#> * checking re-building of vignette outputs ... OK
#> * DONE
#> 
#> Status: OK
#> ── R CMD check results ──────────────────────────────────────── rdev 1.10.2 ────
#> Duration: 1m 25s
#> 
#> 0 errors ✔ | 0 warnings ✔ | 0 notes ✔