refresh: Refresh a package/research compendium

In rcompendium: Create a Package or Research Compendium Structure

Refresh a package/research compendium

Description

This function is about to be removed from rcompendium.

This function refreshes a package/research compendium. It will:

• Update .Rd files and NAMESPACE by using devtools::document();

• Update external packages (in DESCRIPTION file) by using add_dependencies();

• Update badges in README.Rmd (if already present);

• Re-knitr the README.Rmd by using rmarkdown::render();

• Check package integrity by using devtools::check();

• Run analysis by sourcing make.R (only for compendium).

Usage

refresh(compendium = NULL, make = FALSE, check = FALSE, quiet = FALSE)

Arguments

compendium	A character of length 1. The name of the folder to recursively detect dependencies to be added to the Imports field of DESCRIPTION file. It can be 'analysis/' (if additional folders, i.e. ⁠data/⁠, ⁠outputs/⁠, ⁠figures/⁠, etc. have been created in this folder), '.' (if folders ⁠data/⁠, ⁠outputs/⁠, ⁠figures/⁠, etc. have been created at the root of the project), etc. See new_compendium() for further information. Default is compendium = NULL (i.e. no additional folder are inspected but ⁠R/⁠, NAMESPACE, ⁠vignettes/⁠, and ⁠tests/⁠ are still inspected).
make	A logical value. If TRUE the Make-like R file make.R is sourced. Only for research compendium created with new_compendium(). Default is FALSE.
check	A logical value. If TRUE package integrity is checked using devtools::check(). Default is FALSE.
quiet	A logical value. If TRUE (default) message are deleted.

Value

No return value.

See Also

Other setup functions: new_compendium(), new_package(), set_credentials()

Examples

## Not run: 
library(rcompendium)

## Create an R package ----
new_package()

## Start developing functions ----
## ...

## Update package (documentation, dependencies, README) ----
refresh()

## End(Not run)

rcompendium documentation built on Sept. 9, 2025, 5:29 p.m.