Package: testthat 3.2.1.9000

Hadley Wickham

testthat:Unit Testing for R

Software testing is important, but, in part because it is frustrating and boring, many of us avoid it. 'testthat' is a testing framework for R that is easy to learn and use, and integrates with your existing 'workflow'.

Authors:Hadley Wickham [aut, cre], Posit Software, PBC [cph, fnd], R Core team [ctb]

testthat_3.2.1.9000.tar.gz
testthat_3.2.1.9000.zip(r-4.5)testthat_3.2.1.9000.zip(r-4.4)testthat_3.2.1.9000.zip(r-4.3)
testthat_3.2.1.9000.tgz(r-4.4-arm64)testthat_3.2.1.9000.tgz(r-4.4-x86_64)testthat_3.2.1.9000.tgz(r-4.3-arm64)testthat_3.2.1.9000.tgz(r-4.3-x86_64)
testthat_3.2.1.9000.tar.gz(r-4.5-noble)testthat_3.2.1.9000.tar.gz(r-4.4-noble)
testthat_3.2.1.9000.tgz(r-4.4-emscripten)testthat_3.2.1.9000.tgz(r-4.3-emscripten)
testthat.pdf |testthat.html✨
testthat/json (API)
NEWS

# Installtestthat in R:

install.packages('testthat',repos = c('https://r-lib.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/r-lib/testthat/issues

Uses libs:

c++– GNU Standard C++ Library v3

On CRAN:

unit-testing

189 exports 867 stars 15.04 score 30 dependencies 2018 dependents 7 mentions 541.8k downloads

Last updated 5 months agofrom:f060ccec36

Exports:%>%announce_snapshot_file auto_test auto_test_package capture_condition capture_error capture_expectation capture_message capture_messages capture_output capture_output_lines capture_warning capture_warnings check_reporter CheckReporter CompactProgressReporter compare compare_file_binary compare_file_text context context_start_file DebugReporter default_compact_reporter default_parallel_reporter default_reporter describe edition_get equals equals_reference evaluate_promise exp_signal expect expect_condition expect_contains expect_cpp_tests_pass expect_equal expect_equal_to_reference expect_equivalent expect_error expect_failure expect_false expect_gt expect_gte expect_identical expect_in expect_invisible expect_is expect_known_hash expect_known_output expect_known_value expect_length expect_less_than expect_lt expect_lte expect_mapequal expect_match expect_message expect_more_than expect_named expect_no_condition expect_no_error expect_no_match expect_no_message expect_no_warning expect_null expect_output expect_output_file expect_reference expect_s3_class expect_s4_class expect_setequal expect_silent expect_snapshot expect_snapshot_error expect_snapshot_file expect_snapshot_output expect_snapshot_value expect_snapshot_warning expect_success expect_that expect_true expect_type expect_vector expect_visible expect_warning expectation fail FailReporter find_test_scripts get_reporter gives_warning has_names is_a is_checking is_equivalent_to is_false is_identical_to is_informative_error is_less_than is_more_than is_null is_parallel is_snapshot is_testing is_true is.expectation it JunitReporter ListReporter local_edition local_mock local_mocked_bindings local_reproducible_output local_snapshotter local_test_context local_test_directory LocationReporter make_expectation matches MinimalReporter MultiReporter new_expectation not ParallelProgressReporter prints_text ProgressReporter quasi_label Reporter RStudioReporter run_cpp_tests set_max_fails set_reporter set_state_inspector setup show_failure shows_message SilentReporter skip skip_if skip_if_not skip_if_not_installed skip_if_offline skip_if_translated skip_on_appveyor skip_on_bioc skip_on_ci skip_on_covr skip_on_cran skip_on_os skip_on_travis snapshot_accept snapshot_review source_dir source_file source_test_helpers source_test_setup source_test_teardown StopReporter succeed SummaryReporter takes_less_than TapReporter TeamcityReporter teardown teardown_env test_check test_dir test_env test_example test_examples test_file test_local test_package test_path test_rd test_that testing_package testthat_example testthat_examples testthat_print testthat_tolerance throws_error try_again use_catch verify_output watch with_mock with_mocked_bindings with_reporter

Dependencies:brio callr cli crayon desc diffobj digest evaluate fansi fs glue jsonlite lifecycle magrittr pillar pkgbuild pkgconfig pkgload praise processx ps R6 rematch2 rlang rprojroot tibble utf8 vctrs waldo withr

Custom expectations

Rendered fromcustom-expectation.Rmdusingknitr::rmarkdownon Jun 12 2024.

Last update: 2023-04-10
Started: 2017-10-12

Running tests in parallel

Rendered fromparallel.Rmdusingknitr::rmarkdownon Jun 12 2024.

Last update: 2023-09-22
Started: 2020-07-23

Skipping tests

Rendered fromskipping.Rmdusingknitr::rmarkdownon Jun 12 2024.

Last update: 2023-04-05
Started: 2020-07-23

Snapshot tests

Rendered fromsnapshotting.Rmdusingknitr::rmarkdownon Jun 12 2024.

Last update: 2023-07-26
Started: 2020-07-16

Special files

Rendered fromspecial-files.Rmdusingknitr::rmarkdownon Jun 12 2024.

Last update: 2024-02-13
Started: 2023-04-10

Test fixtures

Rendered fromtest-fixtures.Rmdusingknitr::rmarkdownon Jun 12 2024.

Last update: 2024-02-13
Started: 2020-07-14

testthat 3e

Rendered fromthird-edition.Rmdusingknitr::rmarkdownon Jun 12 2024.

Last update: 2023-04-06
Started: 2020-07-12

Citation

Development and contributors

Readme and manuals

Help Manual

Help page	Topics
Watches code and tests for changes, rerunning tests as appropriate.	auto_test
Watches a package for changes, rerunning tests as appropriate.	auto_test_package
Check reporter: 13 line summary of problems	CheckReporter
Does code return a number greater/less than the expected value?	comparison-expectations expect_gt expect_gte expect_lt expect_lte
Test reporter: start recovery.	DebugReporter
describe: a BDD testing language	describe it
Does code return the expected value?	equality-expectations expect_equal expect_identical
The building block of all 'expect_' functions	expect
Does code throw an error, warning, message, or other condition?	expect_condition expect_error expect_message expect_warning
Does code return a visible or invisible object?	expect_invisible expect_visible
Does code return a vector with the specified length?	expect_length
Does code return a vector with (given) names?	expect_named
Does code run without error, warning, message, or other condition?	expect_no_condition expect_no_error expect_no_message expect_no_warning
Does code print output to the console?	expect_output
Does code return a vector containing the expected values?	expect_contains expect_in expect_mapequal expect_setequal
Does code execute silently?	expect_silent
Snapshot testing	expect_snapshot
Snapshot testing for whole files	announce_snapshot_file compare_file_binary compare_file_text expect_snapshot_file
Snapshot testing for values	expect_snapshot_value
Does code return a vector with the expected size and/or prototype?	expect_vector
Default expectations that always succeed or fail.	fail succeed
Test reporter: fail at end.	FailReporter
Does code return an object inheriting from the expected base type, S3 class, or S4 class?	expect_s3_class expect_s4_class expect_type inheritance-expectations
Determine testing status	is_checking is_parallel is_snapshot is_testing testing_package
Test reporter: summary of errors in jUnit XML format.	JunitReporter
List reporter: gather all test results along with elapsed time and file information.	ListReporter
Mocking tools	local_mocked_bindings with_mocked_bindings
Locally set options for maximal test reproducibility	local_reproducible_output local_test_context
Test reporter: location	LocationReporter
Does code return 'TRUE' or 'FALSE'?	expect_false expect_true logical-expectations
Test reporter: minimal.	MinimalReporter
Multi reporter: combine several reporters in one.	MultiReporter
Test reporter: interactive progress bar of errors.	CompactProgressReporter ParallelProgressReporter ProgressReporter
Test reporter: RStudio	RStudioReporter
State inspected	set_state_inspector
Test reporter: gather all errors silently.	SilentReporter
Skip a test	skip skip_if skip_if_not skip_if_not_installed skip_if_offline skip_if_translated skip_on_bioc skip_on_ci skip_on_covr skip_on_cran skip_on_os
Snapshot management	snapshot_accept snapshot_review
Test reporter: stop on error	StopReporter
Test reporter: summary of errors.	SummaryReporter
Test reporter: TAP format.	TapReporter
Test reporter: Teamcity format.	TeamcityReporter
Run code after all test files	teardown_env
Run tests in a single file	test_file
Run all tests in a package	test_check test_local test_package
Locate a file in the testing directory	test_path
Run a test	test_that
Use Catch for C++ Unit Testing	use_catch