Page Comparison

R Packages

• test_that package provides the unit testing framework required to write unit tests for DataSHIELD functions.

• Devtools package is a convenient mechanism to running some testthat test with R Studio and R command prompt.

• RCurl package is used to connect through the IP stack to the Opal servers (i.e. virtual machines).

• bitops package its aim is to provide functions for bitwise operations on integer vectors.

• rjson package provides the functions to convert data to rjson and convert data in JSON data into R.

• mime package provides the functions to offer additional functionality in R related to the multi-purpose internet mail extension.

• dsBaseClient package provides the client side functions. Other DataSHIELD packages being developed would become part of this conceptual model.

R programming language

R programming language is used to develop DataSHIELD libraries.

Virtual machine

Emulates remote connection to a DataSHIELD server using the full IP-stack communication protocols and an Opal server.

Environment: ds.test_env

This R environment provides all the programming variables required to develop some tests and connect to the datasets.

Testing dataset

Some local and remote data is provided to complete some tests for accuracy and expected values returned by some DataSHIELD functions.

Connection Tools

Some functions to safely connect locally and remotely to the testing dataset .

Setup

Initialise the test_that testing environment, including the ds.test_env environment. It is the setup.R file.

Teardown

Once of all the tests have been executed, the ds.test_env environment is cleared from the memory and all connections to the virtual machine are closed. It is the teardown.R file.

Definition of tests

Some definitions of tests are written, so that a test can be used again for different columns of the local and remote data. This element is written by the developers and promote code re-use. It also reduce the code for unit tests size and it becomes more available.

Tests

All the files starting with test are executed by test that. All the tests follow the naming convention stated in Classes of tests.