R write_PACKAGES 生成包文件

說明

產生 'PACKAGES', 'PACKAGES.gz' 和 'PACKAGES.rds’源文件或Mac/Windows二進製包的存儲庫。

用法

write_PACKAGES(dir = ".", fields = NULL,
               type = c("source", "mac.binary", "win.binary"),
               verbose = FALSE, unpacked = FALSE, subdirs = FALSE,
               latestOnly = TRUE, addFiles = FALSE, rds_compress = "xz",
               validate = FALSE)

參數

dir	說明存儲庫位置(包括源代碼或二進製包的目錄)的字符向量，用於生成“PACKAGES', 'PACKAGES.gz' 和 'PACKAGES.rds' 文件並將其寫入。
fields	給出要在‘中使用的字段的字符向量PACKAGES', 'PACKAGES.gz' 和 'PACKAGES.rds' 除了默認文件之外的文件，或者NULL(默認)。 默認對應於 available.packages : "Package" , "Version" , "Priority" , "Depends" , "Imports" , "LinkingTo" , "Suggests" , "Enhances" , "OS_type" , "License" 和 "Archs" 所需的字段，並且這些字段將始終包含在內，加上字段 "File" 如果 addFile = TRUE 中的文件名，以及字段中子目錄的路徑"Path" 如果使用子目錄。
type	包類型：當前源‘.tar.{gz,bz2,xz}’ 檔案，以及 macOS 或 Windows 二進製文件 (‘.tgz' 或者 '。壓縮”，分別)支持包。默認為"win.binary"在 Windows 上並"source"否則。
verbose	合乎邏輯的。包是否應在處理過程中列出？
unpacked	指示包內容是否以解包形式提供的邏輯(默認)。
subdirs	邏輯(指示是否應遞歸地包含子目錄)或要包含的子目錄名稱的字符向量(不遞歸)。
latestOnly	邏輯：如果一個包有多個版本可用，是否應該隻包含最新版本？
addFiles	邏輯：文件名應該作為字段“包含在內”⁠文件⁠' 在裏麵 'PACKAGES' 文件。
rds_compress	用於‘的壓縮類型PACKAGES.rds'： 看saveRDS。默認值是提供最大壓縮的值，並且如上所用CRAN.
validate	一個邏輯表明是否‘DESCRIPTION應該驗證文件，並跳過相應的包，以防發現問題。

細節

write_PACKAGES掃描 R 包的指定目錄，從每個包的‘DESCRIPTION’文件，並將這些信息寫入‘PACKAGES', 'PACKAGES.gz' 和 'PACKAGES.rds’文件，其中前兩個表示 DCF 格式的信息，第三個通過saveRDS.

僅當軟件包的版本要求限製較少時，包含非最新版本的軟件包才有用，例如latestOnly = FALSE當‘⁠foo_1.0⁠' 依賴於取決於 '⁠R >= 2.15.0⁠' 但 '⁠foo_0.9⁠' 可用，這取決於 '⁠R >= 2.11.0⁠’。

支持帶有子目錄的存儲庫，因此支持subdirs != FALSE取決於記錄"Path"字段中的‘PACKAGES’文件。

支持更通用的文件名(例如其他類型的壓縮)通過 a "File"字段中的‘PACKAGES’ 文件可以被使用download.packages。如果文件名不是標準格式，請使用addFiles = TRUE.

type = "win.binary"使用unz連接讀取所有‘DESCRIPTION’ 給定目錄中 Windows(壓縮)二進製包中包含的文件dir，並構建文件‘PACKAGES', 'PACKAGES.gz' 和 'PACKAGES.rds’來自此信息的文件。

對於遠程存儲庫，需要在下載速度和 available.packages 處理下載文件所花費的時間之間進行權衡。對於大型存儲庫，使用 rds_compress = "xz" 可能會有所幫助。

值

無形地返回結果‘中說明的包的數量PACKAGES', 'PACKAGES.gz' 和 'PACKAGES.rds’文件。如果0，沒有找到任何包，也沒有寫入任何文件。

注意

加工 '.tar.gz' 檔案來提取 'DESCRIPTION’文件非常慢。

此函數在其他操作係統上很有用，可以準備供 Windows 計算機訪問的存儲庫，因此 type = "win.binary" 應該適用於所有操作係統。

例子

## Not run: 
write_PACKAGES("c:/myFolder/myRepository")  # on Windows
write_PACKAGES("/pub/RWin/bin/windows/contrib/2.9",
               type = "win.binary")  # on Linux

## End(Not run)

作者

Uwe Ligges and R-core.

也可以看看

參看read.dcf和write.dcf用於閱讀‘DESCRIPTION” 文件並寫入“PACKAGES' 和 'PACKAGES.gz’文件。看update_PACKAGES用於有效更新現有的‘PACKAGES' 和 'PACKAGES.gz’文件。