storr (version 1.0.1)

test_driver: Test a storr driver

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

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

## 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)