R check_packages_in_dir 檢查源碼包及其反向依賴

說明

檢查給定目錄中的源包，可以選擇檢查它們的反向依賴關係。

用法

check_packages_in_dir(dir,
                      pfiles = Sys.glob("*.tar.gz"),
                      check_args = character(),
                      check_args_db = list(),
                      reverse = NULL,
                      check_env = character(),
                      xvfb = FALSE,
                      Ncpus = getOption("Ncpus", 1L),
                      clean = TRUE,
                      ...)

summarize_check_packages_in_dir_results(dir, all = TRUE,
                                        full = FALSE, ...)
summarize_check_packages_in_dir_timings(dir, all = FALSE,
                                        full = FALSE)
summarize_check_packages_in_dir_depends(dir, all = FALSE,
                                        which = c("Depends",
                                                  "Imports",
                                                  "LinkingTo"))

check_packages_in_dir_changes(dir, old,
                              outputs = FALSE, sources = FALSE, ...)
check_packages_in_dir_details(dir, logs = NULL, drop_ok = TRUE, ...)

參數

dir	給出帶有源目錄的路徑的字符串‘.tar.gz’要檢查的文件。
pfiles	(可選)要檢查的 tarball 文件的字符向量。對於選擇‘的子集很有用*.tar.gz' 文件中dir.
check_args	帶有要傳遞給 R CMD check 的參數的字符向量，或長度為兩個的此類字符向量的列表，分別用於檢查包和反向依賴關係。
check_args_db	字符向量的命名列表，其中包含要傳遞給 R CMD check 的參數，名稱為相應的包名稱。
reverse	名稱部分匹配 "repos" 、 "which" 或 "recursive" 的列表，給出用於查找反向依賴項的存儲庫(默認值 getOption("repos") 的子集)、反向依賴項的類型(默認值：c("Depends", "Imports", "LinkingTo") ， package_dependencies 簡寫為 "most" 和 "all" )，並指示是否同時檢查反向依賴的反向依賴等(默認： FALSE )，或 NULL (默認)，其中如果沒有檢查反向依賴關係。
check_env	用於設置用於檢查的環境變量的 name=value 字符串的字符向量，或分別用於檢查包和反向依賴項的兩個此類字符向量的長度列表。
xvfb	指示是否在虛擬幀緩衝區 X 服務器(僅限 Unix)內執行檢查的邏輯，或用於執行此操作的 Xvfb 選項的字符向量。
Ncpus	用於並行安裝和檢查的並行進程的數量。
clean	指示是否刪除下載的反向依賴源的邏輯。
...	傳遞給 readLines ，例如用於讀取以不同編碼生成的日誌文件；目前check_packages_in_dir 未使用。
all	指示是否還匯總檢查的反向依賴關係的邏輯。
full	一個邏輯，指示是否還提供非正常結果檢查的詳細信息，或總結檢查示例時序(如果可用)。
which	請參閱package_dependencies。
old	給出先前 check_packages_in_dir 運行的目錄路徑的字符串。
outputs	一個邏輯，指示是否分析所執行檢查的輸出的變化，或僅(默認)檢查的狀態。
sources	一個邏輯，指示是否還要調查檢查的源文件中的更改(默認值：FALSE)。
logs	路徑為‘的字符向量00檢查.log’來分析。僅在以下情況下使用dir沒有給出。
drop_ok	指示是否刪除帶有 ‘ok’ 狀態的檢查的邏輯，或帶有要刪除的 ‘ok’ 狀態標記的字符向量。默認對應標簽‘⁠好的⁠', '⁠無⁠' 和 '⁠已跳過⁠’。

細節

check_packages_in_dir可以方便的查看源碼包‘.tar.gz' 給定目錄中的文件dir，以及它們的反向依賴關係由reverse.

reverse的"which"組件也可以是一個列表，這種情況下，為列表的每個元素和reverse的"recursive"組件的對應元素獲得反向依賴關係(根據需要回收)。

如果需要，來源‘.tar.gz' 需要檢查的反向依賴文件也被下載到dir(並在最後刪除，如果clean是真的)。接下來，檢查所需的所有(額外)軟件包都安裝到‘ Library ’的子目錄dir。那麽，所有‘.tar.gz使用給定的參數和環境變量檢查文件，並將輸出和消息發送到“輸出’的子目錄dir。這 '*.Rcheck' 帶有反向依賴檢查結果的目錄通過在其基本名稱前加上前綴 ' 來重命名⁠rdepends_⁠’。

可以分別使用 summarize_check_packages_in_dir_results 和 summarize_check_packages_in_dir_timings 方便地總結結果和時序。

如果 Ncpus 大於 1，則並行執行安裝和檢查：這將在 Unix 上使用 mclapply，在 Windows 上使用 parLapply。

check_packages_in_dir 返回一個繼承自類 "check_packages_in_dir" 的對象，該類具有 print 和 summary 方法。

check_packages_in_dir_changes 允許分析更改(某些)源的影響。通過 dir 和 old 分別指定新舊源目錄的路徑以及相應的檢查結果，可以通過選項 outputs 和 sources 方便地分析檢查結果可能發生的變化。通過使用 "==" 、 "!=" 、 "<" 、 "<=" 、 ">" 或 ">=" 之一作為行索引，可以根據從舊結果到新結果的嚴重性變化對返回的更改對象進行下標。

check_packages_in_dir_details 分析檢查日誌文件以獲取檢查詳細信息作為數據幀，可用於進一步處理，為每個執行的檢查提供檢查名稱、狀態和輸出，並根據狀態標記未刪除(分別通過變量 Check 、 Status 和 Output )。

環境變量_R_CHECK_ELAPSED_TIMEOUT_可用於設置每個時間的經過時間限製check跑步。請參閱“R 內部”手冊，了解如何解釋該值以及可用於對超時進行更細粒度控製的其他環境變量。check跑步。

注意

此函數仍處於實驗階段：未來版本中的接口可能會發生變化。

例子

## Not run: 
## Check packages in dir without reverse dependencies:
check_packages_in_dir(dir)
## Check packages in dir and their reverse dependencies using the
## defaults (all repositories in getOption("repos"), all "strong"
## reverse dependencies, no recursive reverse dependencies):
check_packages_in_dir(dir, reverse = list())
## Check packages in dir with their reverse dependencies from CRAN,
## using all strong reverse dependencies and reverse suggests:
check_packages_in_dir(dir,
                      reverse = list(repos = getOption("repos")["CRAN"],
                                     which = "most"))                   
## Check packages in dir with their reverse dependencies from CRAN,
## using '--as-cran' for the former but not the latter:
check_packages_in_dir(dir,
                      check_args = c("--as-cran", ""),
                      reverse = list(repos = getOption("repos")["CRAN"]))

## End(Not run)