Connect to R-hub, from R
R CMD check on any of the R-hub architectures, from the command line.
R-hub is a multi-platform build and check service for R packages. This packages uses the R-hub API to connect to R-hub and start package checks on various architectures.
Install the package from CRAN:
To build packages, first you need to validate your email address with
validate_email(). The package tries to detect your email address using
whoami and the maintainer email listed in DESCRIPTION; and if it fails to do this correctly, you’ll need to specify it.
rhub stores the token permanently on the machine, so you do not need to validate your email again. You can also copy your token to other machines, see
Currently you cannot use the token obtained via this function, in the Web UI of R-hub.
#> debian-gcc-devel: #> Debian Linux, R-devel, GCC #> debian-gcc-patched: #> Debian Linux, R-patched, GCC #> debian-gcc-release: #> Debian Linux, R-release, GCC #> fedora-clang-devel: #> Fedora Linux, R-devel, clang, gfortran #> fedora-gcc-devel: #> Fedora Linux, R-devel, GCC #> linux-x86_64-centos6-epel: #> CentOS 6, stock R from EPEL #> linux-x86_64-centos6-epel-rdt: #> CentOS 6 with Redhat Developer Toolset, R from EPEL #> linux-x86_64-rocker-gcc-san: #> Debian Linux, R-devel, GCC ASAN/UBSAN #> ubuntu-gcc-devel: #> Ubuntu Linux 16.04 LTS, R-devel, GCC #> ubuntu-gcc-release: #> Ubuntu Linux 16.04 LTS, R-release, GCC #> windows-x86_64-devel: #> Windows Server 2008 R2 SP1, R-devel, 32/64 bit #> windows-x86_64-oldrel: #> Windows Server 2008 R2 SP1, R-oldrel, 32/64 bit #> windows-x86_64-patched: #> Windows Server 2008 R2 SP1, R-patched, 32/64 bit #> windows-x86_64-release: #> Windows Server 2008 R2 SP1, R-release, 32/64 bit
You can use the platform ids (e.g.
debian-gcc-devel) to select between platforms.
In interactive R sessions, the output of the check is printed to the screen.
These are quick shortcuts that select the right platform:
check_on_windows()select the operating system.
check_on_centos()select an appropriate Linux platform.
check_with_rdevel()select an R version.
check_with_valgrind()runs the build and check on Linux, in
valgrindto find memory leaks and pointer errors.
check_with_sanitizers()runs all package package tests, examples and vignettes with Address Sanitizer and Undefined Behavior Sanitizer, see below.
rhub::check_for_cran: Check an R-package on R-hub, for a CRAN submission.
R-hub provides a special Docker image to run Address Sanitizer (ASAN) and Undefined Behavior Sanitizer (UBSAN). This is based on the
r-devel-san image of the Rocker project.
This image does not run
R CMD check at all, but it runs
with ASAN and UBSAN enabled.