R 包中的 .First.lib 习惯用法

Question

我在很多 R 包的 .First.lib 函数中看到以下成语：

fullName <- paste("package", pkgname, sep=":")
myEnv <- as.environment(match(fullName, search()))
barepackage <- sub("([^-]+)_.*", "\\1", pkgname)
dbbase <- file.path(libname, pkgname, "R", barepackage)
rm(.First.lib, envir = myEnv)
lazyLoad(dbbase, myEnv)
if(exists(".First.lib", envir = myEnv, inherits = FALSE)) {
    f <- get(".First.lib", envir = myEnv, inherits = FALSE)
    if(is.function(f))
        f(libname, pkgname)
    else
        stop(gettextf("package '%s' has a non-function '.First.lib'",
                      pkgname),
             domain = NA)
}

我了解 .First.lib 函数在加载包时运行。

我知道上面的代码为包定义了一个环境并设置了一个路径，但我不明白为什么它在显式删除 .First.lib 函数后寻找 .First.lib 函数。是什么让上述成语如此普遍？将其包含在 R 包中是否是“最佳实践”？

Answer 1

这种成语很古老。包应该有命名空间并使用 .onLoad、.onUnload 和 .onAttach。例如：

.onLoad <- function(libname, pkgname){
     # do whatever needs to be done when the package is loaded
     # some people use it to bombard users with 
     # messages using 
     packageStartupMessage( "my package is so cool" )
     packageStartupMessage( "so I will print these lines each time you load it")
}

只需将其添加到DESCRIPTION文件中，最好避免调用lazyLoad函数的整个业务：

LazyLoad: true

Answer 2

你问为什么它在寻找.First.Lib，而脚本之前删除了它。 lazyLoad 加载 R 对象的数据库，在上面的代码中，它被加载到环境 myEnv 中。加载到该环境中的对象集包含.First.Lib 并非不可想象，而代码正在寻找的正是它。事实上，我猜想这样做的目的是只运行存储在加载的对象数据库中的.First.Lib。

没有 NAMESPACE 的包中的另一个常见习语是（来自 vegan 包）：

.First.lib <- function(lib, pkg)  {
    library.dynam("vegan", pkg, lib)
    packageStartupMessage("This is vegan ",
                          utils::packageDescription("vegan", field="Version"),
                          appendLF = TRUE)
}

这会加载已编译的代码以供使用，并打印带有包名称和版本号的简单启动消息。这在精神上类似于@Romain 的答案的.onLoad，但没有 NAMESPACE。