.TH TESTR\-DRIVER 1 "2012\-01\-20" "14.3.0"
.SH NAME
.PP
testr\-driver \- drives 
.BR testr\-master (1) 
and does bookkeeping
.SH SYNOPSIS
.PP
\fB\fCtestr-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 testr\-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 testr\-herald (1) 
reports that a file belonging to the test execution
overhead has been modified, this program replaces 
.BR testr\-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 testr\-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.testr.rb\fP
Optional Ruby script for configuring 
.BR testr (1).
.SH ENVIRONMENT
.TP
\fB\fCTESTR_CONFIGS\fR
A single\-line JSON array containing paths to actual files or names of
helper libraries in the testr/config/ namespace of Ruby's load path.
These configuration files are loaded just before \fI.testr.rb\fP is loaded.
.SH SEE ALSO
.PP
.BR testr (1), 
.BR testr\-driver (1), 
.BR testr\-master (1), 
.BR testr\-herald (1)