test_driver: Test a storr driver

Description Usage Arguments Details Examples

Description

Test that a driver passes all storr tests. This page is only of interest to people developing storr drivers; nothing here is required for using storr.

Usage

1
test_driver(create)

Arguments

create

A function with no arguments that when run will create a new driver instance. Depending on your storage model, temporary directories, in-memory locations, or random-but-unique prefixes may help create isolated locations for the test (the tests assume that a storr created with create is entirely empty).

Details

This will run through a suite of functions to test that a driver is likely to behave itself. As bugs are found they will be added to the test suite to guard against regressions.

The test suite is included in the package as system.file("spec", package="storr").

The procedure for each test block is:

  1. Create a new driver by running dr <- create().

  2. Run a number of tests.

  3. Destroy the driver by running dr$destroy().

So before running this test suite, make sure this will not harm any precious data!

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
## Testing the environment driver is nice and fast:
if (requireNamespace("testthat")) {
  test_driver(function() driver_environment())
}

# To test things like the rds driver, I would run:
## Not run: 
if (requireNamespace("testthat")) {
  test_driver(function() driver_rds(tempfile()))
}

## End(Not run)


Search within the storr package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? or email at ian@mutexlabs.com.

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.