ITADN
r-lib/testthat
README.md
以下内容由 AI 翻译,如有问题请点此提交 issue 反馈

testthat

CRAN
status R-CMD-check Codecov test
coverage

概述

测试代码可能既痛苦又繁琐,但它能极大提升代码的质量。testthat 致力于让测试变得尽可能有趣,让编写测试能带来强烈的满足感。测试应当让人上瘾,从而促使人们持续进行测试。为达成这一目标,testthat 提供了以下功能:

  • 提供相关函数,帮助用户轻松描述对函数行为的期望,包括捕获错误、警告和消息。
  • 能轻松集成到现有的工作流程中,无论是通过命令行进行非正式测试、构建测试套件,还是使用 R CMD check。
  • 以可视化方式展示测试进度,明确显示每个期望项的通过、失败或错误状态。如果使用终端或较新版本的 RStudio,它甚至会为输出内容添加颜色标注。

testthat 的设计灵感来源于 xUnit 系列测试包,以及许多创新的 Ruby 测试库,例如 rspectestybaconcucumber

testthat 是 R 语言中最流行的单元测试包,已被数千个 CRAN 包所采用。

如果您还不熟悉 testthat,R packages 中的testing chapter章节提供了详尽的概述,以及相关的工作流程建议和实际示例。

安装

# Install the released version from CRAN
install.packages("testthat")

# Or the development version from GitHub:
# install.packages("pak")
pak::pak("r-lib/testthat")

使用方法

最简单的入门方式是使用 usethis]。假设你处于某个 包目录中,只需运行 usethis::use_test("name") 来创建测试文件,并设置所有其他所需的基础设施。如果你使用的是 RStudio,按下 Cmd/Ctrl + Shift + T(如果未安装则运行 devtools::test()),即可运行该包中的所有测试。