R CRANtools CRAN 包存储库工具

说明

用于获取有关当前包的信息的工具CRAN包存储库及其检查状态。

用法

CRAN_package_db()

CRAN_check_results(flavors = NULL)
CRAN_check_details(flavors = NULL)
CRAN_check_issues()
summarize_CRAN_check_status(packages,
                            results = NULL,
                            details = NULL,
                            issues = NULL)

参数

packages	包名称的字符向量。
flavors	的特征向量CRAN检查口味名称，或者NULL(默认)，对应于所有可用的口味。
results	CRAN_check_results()(默认)的返回值或其子集。
details	CRAN_check_details()(默认)的返回值或其子集。
issues	CRAN_check_issues()(默认)的返回值或其子集。

细节

CRAN_package_db()返回一个 DataFrame ，其中字符列包含大多数‘DESCRIPTIONCRAN 包存储库中当前包的元数据，特别包括未提供的说明和维护者信息utils::available.packages().

CRAN_check_results()返回一个包含基本数据的 DataFrame CRAN包检查结果，包括时间，带有列Package,Flavor和Status分别给出包名称、检查风格和整体检查状态。

CRAN_check_details() 返回一个继承自类 "check_details"(具有有用的 print 和 format 方法)的数据帧，其中包含检查结果的详细信息，为每个非正常检查提供检查名称、状态和输出(通过列：分别为Check、Status 和Output)。具有 all-OK 检查的包通过 * Check 通配符名称和 OK Status 指示。

CRAN_check_issues() 返回带有附加检查问题的字符框架(包括从 https://www.stats.ox.ac.uk/pub/bdr/memtests/ 提供的 memory-access 检查结果)作为带有变量 Package 、 Version 、 kind (问题的标识符)的字符框架和href(包含有关该问题的信息的 URL)。

值

查看具体信息'。请注意，结果是整理于CRAN：目前这是在排序的语言环境中完成的aAbB....

哪个 CRAN？

主要函数访问CRAN环境变量指定的镜像R_CRAN_WEB，默认为中指定的一个"repos"选项。否则，‘存储库’ 文件(参见setRepositories) 用于：如果指定‘⁠@CRAN@⁠’(默认)或者不包含 CRAN 条目https://CRAN.R-project.org被使用。

要使用的镜像由 utils::findCRANmirror("web") 报告。

请注意，这些函数访问部分CRAN在下面 '网络/贡献' 和 '网络/包' 所以如果你指定了一个镜像'src/贡献' 为了安装软件包，你需要设置R_CRAN_WEB指向全镜。

内部函数CRAN_aliases_db,CRAN_archive_db,CRAN_current_db和CRAN_rdxrefs_db(由R CMD check) 使用R_CRAN_SRC而不是R_CRAN_WEB.

例子

## This can be rather slow  with a non-local CRAN mirror
## and might fail (slowly) without Internet access in that case.

set.seed(11)  # but the packages chosen will change as soon as CRAN does.
pdb <- CRAN_package_db()
dim(pdb)
## DESCRIPTION fields included:
colnames(pdb)
## Summarize publication dates:
summary(as.Date(pdb$Published))
## Summarize numbers of packages according to maintainer:
summary(lengths(split(pdb$Package, pdb$Maintainer)))
## Packages with 'LASSO' in their Description:
pdb$Package[grepl("LASSO", pdb$Description)]

results <- CRAN_check_results()
## Available variables:
names(results)
## Tabulate overall check status according to flavor:
with(results, table(Flavor, Status))

details <- CRAN_check_details()
## Available variables:
names(details)
## Tabulate checks according to their status:
tab <- with(details, table(Check, Status))
## Inspect some installation problems:
bad <- subset(details,
              ((Check == "whether package can be installed") &
               (Status != "OK")))
## Show a random sample of up to 6
head(bad[sample(seq_len(NROW(bad)), NROW(bad)), ])

issues <- CRAN_check_issues()
head(issues)
## Show counts of issues according to kind:
table(issues[, "kind"])

## Summarize CRAN check status for 10 randomly-selected packages
## (reusing the information already read in):
pos <- sample(seq_len(NROW(pdb)), 10L)
summarize_CRAN_check_status(pdb[pos, "Package"],
                            results, details, issues)