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)