knitr::opts_chunk$set( collapse = TRUE, comment = "#>", fig.path = "README-" )
foghorn noun
1. Device used to facilitate navigation in foggy conditions by warning of potential hazards ahead.
foghorn
makes accessible to the R terminal the CRAN check results for packages
maintained by individuals, or for other packages of interest. The results are
presented as a colored summary, or as a tibble. The function that generates the
summary is designed to be called from your .Rprofile
so you can check on the
status of the packages regularly.
As new features are introduced in development versions of R, or new policies are
put in place, packages that are not updated frequently may start generating
warnings or errors when checked on CRAN's infrastructure. foghorn
brings this
information to your terminal so you don't have to leave the comfort of your
R session to know the results of the CRAN checks for your packages.
You can install the development version of foghorn
from GitHub with:
pak::pkg_install("fmichonneau/foghorn")
or the stable version from CRAN:
install.packages("foghorn")
## load the package library(foghorn)
foghorn
provides the results of the package CRAN checks. As a maintainer, you
can easily get the results of the checks for your packages by using the email
address included in the DESCRIPTION
file of your packages.
summary_cran_results()
provides you with a graphical summary of the results of
the CRAN checks. The number in parenthesis after the name of the package
indicates the number of platforms used by CRAN that produced this result. If
CRAN has set a deadline by which your package needs to be updated before it gets
archived, that date will be shown in the output.
## Graphical interface summary_cran_results(email = "francois.michonneau@gmail.com", pkg = "lme4")
summary_cran_results()
is actually an alias of summary(cran_results())
,
meaning that you can call cran_results()
directly if you want to easily access
the underlying data for the results of the CRAN checks. These results are stored
in a tibble.
## Results of the checks as a tibble cran_results(email = "francois.michonneau@gmail.com")
In addition of your own packages, you can also check the results for any other packages that might be of interest to you:
## either by themselves summary_cran_results(pkg = c("ggplot2", "dplyr")) cran_results(pkg = c("ggplot2", "dplyr")) ## or by combining them with email addresses summary_cran_results( email = "francois.michonneau@gmail.com", pkg = c("arrow", "duckdb") ) cran_results( email = "francois.michonneau@gmail.com", pkg = c("arrow", "duckdb") )
You can inspect the logs for the check results using summary_cran_details(pkg)
(or summary(cran_details(pkg))
), while visit_cran_check(pkg)
takes you
directly to the CRAN webpage.
(tidyr_checks <- cran_details(pkg = "tidyr")) summary(tidyr_checks)
The data from the check results used by this package are either scraped from
the CRAN web pages (default), or are from the CRAN database (that CRAN uses to
build the webpages). The first option is faster if you want to regularly check a
few packages. However, if you are doing statistics on a large number of
packages, using the CRAN database is recommended (it's about 20Mb of data). To
use the CRAN database, add src = "crandb"
in your function calls:
cran_results(pkg = "nlme", src = "crandb", progress = FALSE)
Check out the "Details" section in the help files for more information.
Feel free to submit feedback and suggestions by opening an issue on GitHub.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.