drat: Drat R 存档模板
drat
可爱的人生气时说的话
"哎呀,我丢了钱包"
特别注意
请不要复刻_这个_仓库来快速创建你的drat
,请改为复刻这个仓库。详情见下文。
背景
R包生态系统是R语言成功的基石之一。截至2020年7月,CRAN上有超过16000个包,BioConductor上还有约一千个。
R对多个仓库的支持深深植根于其中,主要通过(默认的)utils
包实现。update.packages
函数(以及utils
包中的其他几个函数)可以轻松用于这三个默认仓库以及许多其他仓库。但似乎缺少对_简单创建和使用_本地仓库的支持。
Drat试图在这里提供帮助,支持两种主要模式:
- 通过利用
gh-pages
的GitHub模式 - 通过使用其他可写入并提供html访问的存储的其他仓库模式
请查看下一节了解如何入门,包文档,drat包页面或关于drat的博客部分以获取更多信息。
入门
请不要复刻_这个_仓库来快速创建你的drat
,请改为复刻这个仓库。详情见下文。
请参阅以下小册子:
了解常见问题、两个主要用例、基本动机和概述/介绍。包文档提供了更多细节。drat包页面有更长的教程,关于drat的博客部分有更多内容。
包文档、帮助页面、小册子等也可在这里找到。
安装
首选方法是通过标准命令从 CRAN 安装已发布的软件包:
install.packages("drat")
快速开始创建您自己的 Drat
drat
自带了一个存储库创建助手函数 initRepo
,但更快捷的方式可能是 fork 一个现有的存储库。这已经在原始存储库上多次完成。然而,随着时间的推移,这个存储库积累了代码改进和更多文档,使其变得有些笨重。因此,我们设置了一个专用存储库,只是为了方便 drat
的 fork。克隆它,您就会得到一个可以直接使用的 drat
存储库。
状态
该软件包自 2015 年春季起已在 CRAN 上提供,并开始得到一些使用。可能的改进、添加和下一步计划列在 TODO.md 文件中。
一些 drat 存储库开始出现(除了这个之外)。以下是一个不完整的列表(查看直接 fork 以及 GitHub 搜索):
- yutannihilation
- gschofl
- csgillespie
- shabbychef
- RcppCore
- arilamstein
- piccolbo
- ghrr
- cloudyr
- dmlc
- thospfuller
rOpenSci 项目使用 drat 分发他们的代码,并写了一篇很好的博客文章介绍它。
Travis 集成
Colin Gillespie 将 Travis CI 与 drat 集成,详情请参见他的 dratTravis 存储库,以及贡献的小文章 Combining Drat and Travis。
GitHub Actions
Mike Mahoney 在 GitHub Actions 的 'push' 设置中使用 drat,而 Zhian Kamvar 则在 GitHub Actions 的 'pull' 设置中使用 drat。
作者
Dirk Eddelbuettel,以及 Felix Ernst、Neal Fultz、Colin Gillespie、Christoph Stepper、Thomas Leeper、Mark van der Loo、Jan Gorecki 等人的贡献。
许可证
GPL (>= 2)