package.skeleton
位于 utils
包(package)。 说明
package.skeleton
自动执行新源包的一些设置。它创建目录,将函数、数据和 R 代码文件保存到适当的位置,并创建骨架帮助文件和“Read-and-delete-我’文件说明了打包的进一步步骤。
用法
package.skeleton(name = "anRpackage", list,
environment = .GlobalEnv,
path = ".", force = FALSE,
code_files = character(), encoding = "unknown")
参数
name |
字符串:您的包的包名称和目录名称。必须是有效的包名称。 |
list |
字符向量命名R要放入包中的对象。一般情况下,最多可以有一个 |
environment |
寻找物体的环境。查看具体信息'。 |
path |
放置包目录的路径。 |
force |
如果 |
code_files |
一个字符向量,其中包含用于构建包的 R 代码文件的路径。查看具体信息'。 |
encoding |
可选地 |
细节
参数 list
、 environment
和 code_files
提供了初始化包的替代方法。如果提供了code_files
,则将获取如此命名的文件来形成环境,然后用于生成包框架。否则, list
默认为 environment
中的对象(包括名称以 .
开头的对象),但可以用于选择该环境中的对象子集。
使用 prompt
、 promptClass
和 promptMethods
函数为函数、数据对象以及 S4 类和方法生成帮助文件存根。如果打算在不进行任何更改的情况下导入和重新导出另一个包中的对象,则应在 package.skeleton
之后使用 promptImport
函数来生成链接到原始文件的简单帮助文件。
包源放置在 path
的子目录 name
中。如果提供code_files
,则复制这些文件;否则,对象将被转储到单独的源文件中。 code_files
中的文件名应具有后缀 ".R"
并且位于当前工作目录中。
为源代码和文档创建的文件名尝试对所有已知运行的操作系统有效R。无效字符被替换为‘_”,无效名称前面带有“zz',名称被转换为小写(以避免大小写不敏感的文件系统上的大小写冲突),最后转换后的名称通过以下方式变得唯一make.unique(sep = "_")
。可以对代码和帮助文件执行此操作,但不能对数据文件(按名称查找)执行此操作。此外,代码和帮助文件的名称应以 ASCII 字母或数字开头,并在必要时进行检查z
前置。
名称以点开头的函数放置在文件‘右/名字-内部.R’。
完成后,删除‘Read-and-delete-我’文件,因为它不应该被分发。
值
用于side-effects。
例子
require(stats)
## two functions and two "data sets" :
f <- function(x, y) x+y
g <- function(x, y) x-y
d <- data.frame(a = 1, b = 2)
e <- rnorm(1000)
package.skeleton(list = c("f","g","d","e"), name = "mypkg")
参考
Read the ‘Writing R Extensions’ manual for more details.
Once you have created a source package you need to install it:
see the ‘R Installation and Administration’ manual,
INSTALL
and install.packages
.
也可以看看
prompt
、promptClass
和 promptMethods
。
package_native_routine_registration_skeleton
用于帮助准备带有编译代码的包。
相关用法
- R packageName 查找与环境关联的包
- R packageDescription 包装说明
- R packageStatus 包管理工具
- R page 在 R 对象上调用寻呼机
- R personList 人员集合(旧接口)
- R promptData 为数据集生成大纲文档
- R person 人员
- R promptPackage 生成包文档的 Shell
- R prompt 生成 R 文档文件的原型
- R process.events 触发事件处理
- R select.list 从列表中选择项目
- R COMPILE 编译用于 R 的文件
- R readRegistry 读取 Windows 注册表配置单元
- R browseVignettes 在 HTML 浏览器中列出晕影
- R hasName 检查姓名
- R nsl 按主机名查找 IP 地址
- R edit 调用文本编辑器
- R create.post 准备电子邮件和帖子的辅助函数
- R hsearch-utils 帮助搜索实用程序
- R download.packages 从类似 CRAN 的存储库下载软件包
- R DLL.version MS Windows 上的 DLL 版本信息
- R ls.str 列表对象及其结构
- R Rscript R 前端脚本
- R bug.report 发送错误报告
- R PkgUtils 用于构建和检查附加包的实用程序
注:本文由纯净天空筛选整理自R-devel大神的英文原创作品 Create a Skeleton for a New Source Package。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。