check_source: Check R-scripts, folders or R-code strings for globals and...

In checkglobals: Static Analysis of R-Code Dependencies

Check R-scripts, folders or R-code strings for globals and imports

Description

Approximately detect global and imported functions or variables from R-scripts, folders or R-code strings by static code analysis. For inspection of individual R-scripts use the 'file' argument, for R-code strings use the 'text' argument, and for folders containing R-scripts use the 'dir' argument. This function does not require executing the code under inspection.

Usage

check_source(file, text, dir, include_compiled = FALSE, skip_globals = NULL)

Arguments

file	character path to R-script to analyze, can be either a file on the local filesystem or a remote file location (e.g. a server or the web).
text	character R-code string to analyze.
dir	character path to folder with R-scripts to analyze.
include_compiled	logical value indicating if compiled functions called with .Call, .C, .External, .Fortran should be included as global variables.
skip_globals	optional character vector of names to skip/exclude as (unrecognized) global variables.

Value

list S3-object of class "checkglobals" with three components:

• globals, list of class "checkglobalsg"

• imports, list of class "checkglobalsi"

• missing_packages, character vector with missing packages

for programmatic use, cast the returned S3-object with as.data.frame, as.matrix, as.character or as_vector.

See Also

checkglobals, check_pkg

Examples

## local R-script
check_source(
  file = system.file(
    "unit_tests", "pkg", "testpkg", "R", "functions1.R",
    package = "checkglobals"
  )
)

## local R-folder
check_source(
  dir = system.file(
    "unit_tests", "pkg", "testpkg", "R",
    package = "checkglobals"
  )
)

## R-code string
check_source(text = "cc <- function(m) stats::coef(m)")

## R-script from remote location

  check_source(
    file = "https://raw.githubusercontent.com/rstudio/shiny-examples/main/004-mpg/app.R"
  )

checkglobals documentation built on June 8, 2023, 6:47 a.m.