FileTestStorage


@ExperimentalTestApi
class FileTestStorage : PlatformTestStorage


A class that reads/writes the runner data using the raw file system.

This API is experimental and is subject to change or removal in future releases.

Summary

Public constructors

Public functions

Unit

Test output properties is not supported when raw file I/O is used.

String!
getInputArg(argName: String!)

Implementation of input arguments that reads from InstrumentationRegistry.getArguments

(Mutable)Map<String!, String!>!

Implementation of input arguments that reads from InstrumentationRegistry.getArguments

(Mutable)Map<String!, Serializable!>!

Test output properties is not supported when raw file I/O is used.

InputStream!
openInputFile(pathname: String!)

Provides an InputStream to a test file dependency.

InputStream!

Provides an InputStream to an internal file used by the testing infrastructure.

OutputStream!

Provides an OutputStream to an internal file used by the testing infrastructure.

OutputStream!
openOutputFile(pathname: String!)

Provides an OutputStream to a test output file.

OutputStream!
openOutputFile(pathname: String!, append: Boolean)

Provides an OutputStream to a test output file.

Public constructors

FileTestStorage

FileTestStorage()

Public functions

addOutputProperties

fun addOutputProperties(properties: (Mutable)Map<String!, Serializable!>!): Unit

Test output properties is not supported when raw file I/O is used.

getInputArg

fun getInputArg(argName: String!): String!

Implementation of input arguments that reads from InstrumentationRegistry.getArguments

getInputArgs

fun getInputArgs(): (Mutable)Map<String!, String!>!

Implementation of input arguments that reads from InstrumentationRegistry.getArguments

getOutputProperties

fun getOutputProperties(): (Mutable)Map<String!, Serializable!>!

Test output properties is not supported when raw file I/O is used.

An empty map is always returned.

openInputFile

fun openInputFile(pathname: String!): InputStream!

Provides an InputStream to a test file dependency.

Parameters
pathname: String!

path to the test file dependency. Should not be null. Can be either a relative or absolute path. If relative, the implementation will read the input file from the test apk's asset directory

openInternalInputFile

fun openInternalInputFile(pathname: String!): InputStream!

Provides an InputStream to an internal file used by the testing infrastructure.

Parameters
pathname: String!

path to the internal input file. Should not be null. This is an absolute file path on the device, and it's the infrastructure/client's responsibility to make sure the file path is readable.

openInternalOutputFile

fun openInternalOutputFile(pathname: String!): OutputStream!

Provides an OutputStream to an internal file used by the testing infrastructure.

Parameters
pathname: String!

path to the test file dependency. Should not be null. Can be either a relative or absolute path. If relative, the implementation will read the input file from the test apk's asset directory

openOutputFile

fun openOutputFile(pathname: String!): OutputStream!

Provides an OutputStream to a test output file.

Parameters
pathname: String!

path to the test file dependency. Should not be null. Can be either a relative or absolute path. If relative, the implementation will make a best effort attempt to a writable output dir based on API level.

openOutputFile

fun openOutputFile(pathname: String!, append: Boolean): OutputStream!

Provides an OutputStream to a test output file.

Parameters
pathname: String!

path to the test output file. Should not be null.

append: Boolean

if true, then the lines will be added to the end of the file rather than overwriting.

Returns
OutputStream!

an OutputStream to the given output file.