R: Skip a vignette being run on CRAN R CMD check

user_2924787 0
Viewed 1223

I have a number of vignettes in an R package that are slow to run. As I understand it, a CRAN R CMD check will not rebuild the vignette but will run its corresponding code.

Since the vignettes are slow to run, I don't think the adhere to the CRAN policy. But the vignettes are useful examples that have figures. So I was wondering if it's possible to skip running vignette code only for a CRAN R CMD check, a bit like you can skip a unit test using testthat::skip_on_cran()?

vignette cran r package
2 Answers

I just found there is an environment variable used by devtools called NOT_CRAN, and we should be able to use the same ideas to check if things are being run as CRAN. I believe wrapping code in the following if statement will mean it is only run if you are not using the --as-cran statement.

if (identical(Sys.getenv("NOT_CRAN", unset = "true"), "true")) {
    ###CODE HERE###
}

I think even if this has been set by devtools it should still work.

Sources: Testing -- R Packages by Hadley Wickham; testthat package source; devtools package source.

user_29247870

Dirk's comment about R CMD check is --helpful. You will see a --no-vignettes flag.

If you're using devtools from the R console, just use:

devtools::check(vignettes = FALSE)

user_14362470
Related