r - 我可以检查 roxygenize 是否失败？

Question

是否可以检测运行时是否有问题roxygenize（包roxygen2）？

我想自动化记录、检查和构建包的过程，并希望在记录出错时停止。

roxygenize帮助说返回值为NULL，我搜索stackoverflow没有成功。目前，我需要查看输出并搜索是否有以“错误”开头的行。

任何提示表示赞赏！

Answer 1

当 roxygenize发现错误时，例如，您包含stop("Raise an error")在您的代码中，roxygenize则将返回错误。

另一种情况（这是你所得到的）roxygenise是能够完成，但文档过程的某些方面是不正确的。在这种情况下，这些错误将存储为警告。因此，一种解决方案是将警告更改为错误。

例如，假设您有一个包含以下行的文件：

#' @XXX 

这会导致：

roxygenise("pkg/")

发出警告

  Warning: XXX is an unknown key in block AllGenerics.R:5

如果我们将警告更改为错误：

##All warnings are now errors
options(warn=2)

然后

roxygenise("pkg/")

会引发错误：

Error: (converted from warning) XXX is an unknown key in block AllGenerics.R:5

然后，您可以使用标准tryCatch技术来处理错误。