.TH TORK\-DRIVER 1 2012\-01\-25 15.1.0 .SH NAME .PP tork\-driver \- drives .BR tork\-master (1) and does bookkeeping .SH SYNOPSIS .PP \fB\fCtork-driver\fR [\fIOPTION\fP]... .SH DESCRIPTION .PP This program reads the following single\-line commands (JSON arrays) from its standard input stream and performs the respective actions as described below. It also funnels the standard output stream of .BR tork\-master (1) into its own. .TP \fB\fC["run_all_test_files"]\fR Runs all test files found within and beneath the current working directory. .TP \fB\fC["stop_running_test_files"]\fR Stops any test files that are currently running. .TP \fB\fC["rerun_passed_test_files"]\fR Runs all test files that have passed during their most recent run. .TP \fB\fC["reabsorb_overhead_files"]\fR Stops any test files that are currently running, reabsorbs the test execution overhead, and resumes running those interrupted test files. .TP \fB\fC["quit"]\fR Stops all tests that are currently running and exits. .PP When .BR tork\-herald (1) reports that a file belonging to the test execution overhead has been modified, this program replaces .BR tork\-master (1) with a new instance, which then absorbs the modified test execution overhead into itself. .PP This program emits the following single\-line status messages (JSON arrays) on its standard output stream to provide notifications about its activity: .TP \fB\fC["over",\fR \fIoverhead_file\fP\fB\fC]\fR The test execution overhead is currently being reabsorbed, by replacing .BR tork\-master (1) with a new instance, because \fIoverhead_file\fP has changed. .SH OPTIONS .TP \fB\fC-h\fR, \fB\fC--help\fR Display this help manual using .BR man (1). .SH FILES .TP \fI.tork.rb\fP Optional Ruby script for configuring .BR tork (1). .SH ENVIRONMENT .TP \fB\fCTORK_CONFIGS\fR A single\-line JSON array containing paths to actual files or names of helper libraries in the tork/config/ namespace of Ruby's load path. These configuration files are loaded just before \fI.tork.rb\fP is loaded. .SH SEE ALSO .PP .BR tork (1), .BR tork\-driver (1), .BR tork\-master (1), .BR tork\-herald (1)