https://github.com/r-lib/testthat

An R 📦 to make testing 😀
https://github.com/r-lib/testthat

r unit-testing

Last synced: 7 days ago
JSON representation

An R 📦 to make testing 😀

• Host: GitHub
• URL: https://github.com/r-lib/testthat
• Owner: r-lib
• License: other
• Created: 2009-09-02T12:51:44.000Z (over 15 years ago)
• Default Branch: main
• Last Pushed: 2025-01-13T13:42:27.000Z (12 days ago)
• Last Synced: 2025-01-16T16:25:46.844Z (9 days ago)
• Topics: r, unit-testing
• Language: R
• Homepage: https://testthat.r-lib.org
• Size: 17.4 MB
• Stars: 895
• Watchers: 20
• Forks: 318
• Open Issues: 121
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

• jimsghstars - r-lib/testthat - An R 📦 to make testing 😀 (R)

README

        
---

output: github_document

---

```{r setup, include = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "man/figures/README-"

)

```

# testthat 

[![CRAN status](https://www.r-pkg.org/badges/version/testthat)](https://cran.r-project.org/package=testthat)

[![R-CMD-check](https://github.com/r-lib/testthat/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/r-lib/testthat/actions/workflows/R-CMD-check.yaml)

[![Codecov test coverage](https://codecov.io/gh/r-lib/testthat/graph/badge.svg)](https://app.codecov.io/gh/r-lib/testthat)

## Overview

Testing your code can be painful and tedious, but it greatly increases the quality of your code. __testthat__ tries to make testing as fun as possible, so that you get a visceral satisfaction from writing tests. Testing should be addictive, so you do it all the time. To make that happen, testthat:

* Provides functions that make it easy to describe what you expect a

  function to do, including catching errors, warnings, and messages.

* Easily integrates in your existing workflow, whether it's informal testing

  on the command line, building test suites, or using R CMD check.

* Displays test progress visually, showing a pass, fail, or error for every

  expectation. If you're using the terminal or a recent version of RStudio,

  it'll even colour the output.

testthat draws inspiration from the xUnit family of testing packages, as well as from many of the innovative ruby testing libraries, like [rspec](https://rspec.info/), [testy](https://github.com/ahoward/testy), [bacon](https://github.com/leahneukirchen/bacon) and [cucumber](https://cucumber.io).

testthat is the most popular unit testing package for R and is used by thousands of CRAN packages.

If you're not familiar with testthat, the [testing chapter](https://r-pkgs.org/testing-basics.html) in [R packages](https://r-pkgs.org) gives a good overview, along with workflow advice and concrete examples.

## Installation

```{r, eval = FALSE}

# Install the released version from CRAN

install.packages("testthat")

# Or the development version from GitHub:

# install.packages("pak")

pak::pak("r-lib/testthat")

```

## Usage

The easiest way to get started is with [usethis](https://github.com/r-lib/usethis). Assuming you're in a package directory, just run `usethis::use_test("name")` to create a test file, and set up all the other infrastructure you need. If you're using RStudio, press Cmd/Ctrl + Shift + T (or run `devtools::test()` if not) to run all the tests in a package.