A common base class for Toil tests.


Class represents a unit of work in toil.

Module Contents

class toil.test.src.importExportFileTest.ImportExportFileTest(methodName='runTest')[source]

Bases: toil.test.ToilTest

A common base class for Toil tests.

Please have every test case directly or indirectly inherit this one.

When running tests you may optionally set the TOIL_TEST_TEMP environment variable to the path of a directory where you want temporary test files be placed. The directory will be created if it doesn’t exist. The path may be relative in which case it will be assumed to be relative to the project root. If TOIL_TEST_TEMP is not defined, temporary files and directories will be created in the system’s default location for such files and any temporary files or directories left over from tests will be removed automatically removed during tear down. Otherwise, left-over files will not be removed.


Hook method for setting up the test fixture before exercising it.

create_file(content, executable=False)[source]

Ensures that uploaded files preserve their file permissions when they are downloaded again. This function checks that an imported executable file maintains its executability after being exported.

class toil.test.src.importExportFileTest.RestartingJob(msg_portion_file_id, trigger_file_id, message_portion_2)[source]

Bases: toil.job.Job

Class represents a unit of work in toil.


Override this function to perform work and dynamically create successor jobs.


fileStore – Used to create local and globally sharable temporary files and to send log messages to the leader process.


The return value of the function can be passed to other jobs by means of toil.job.Job.rv().