.TH TORK\-MASTER 1 2012\-10\-10 18.2.4
.SH NAME
.PP
tork\-master \- absorbs overhead and runs tests
.SH SYNOPSIS
.PP
\fB\fCtork-master\fR [\fIOPTION\fP]...
.SH DESCRIPTION
.PP
This program absorbs the test execution overhead and forks to run your tests.
It reads the following single\-line commands (JSON arrays) from its standard
input stream and performs the respective actions as described below.
.TP
\fB\fC["load",\fR \fIpaths\fP\fB\fC,\fR \fIfiles\fP\fB\fC]\fR
Adds the given array of \fIpaths\fP to Ruby's $LOAD_PATH, loads the given array
of \fIfiles\fP after removing their ".rb" file extension if present, and prints
the given command line to the standard output stream.
.TP
\fB\fC["test",\fR \fItest_file\fP\fB\fC,\fR \fIline_numbers\fP\fB\fC]\fR
Runs the given \fItest_file\fP in a forked child process while instructing your
chosen unit testing framework (loaded by your test execution overhead) to
only run those tests that are defined on the given array of \fIline_numbers\fP.
.IP
Prints the following status messages to the standard output stream.  The
standard output and error streams of the forked child process are captured
in the \fIlog_file\fP specified in these status messages.
.RS
.IP \(bu 2
Test is running:
\fB\fC["test",\fR \fItest_file\fP\fB\fC,\fR \fIline_numbers\fP\fB\fC,\fR \fIlog_file\fP\fB\fC,\fR \fIworker_number\fP\fB\fC]\fR
.IP \(bu 2
Test has passed:
\fB\fC["pass",\fR \fItest_file\fP\fB\fC,\fR \fIline_numbers\fP\fB\fC,\fR \fIlog_file\fP\fB\fC,\fR \fIworker_number\fP\fB\fC,\fR \fIexit_code\fP\fB\fC,\fR \fIexit_info\fP\fB\fC]\fR
.IP \(bu 2
Test has failed:
\fB\fC["fail",\fR \fItest_file\fP\fB\fC,\fR \fIline_numbers\fP\fB\fC,\fR \fIlog_file\fP\fB\fC,\fR \fIworker_number\fP\fB\fC,\fR \fIexit_code\fP\fB\fC,\fR \fIexit_info\fP\fB\fC]\fR
.RE
.TP
\fB\fC["stop"]\fR
Stops all tests that are currently running and prints the given command line
to the standard output stream.
.TP
\fB\fC["quit"]\fR
Stops all tests that are currently running and exits.
.SH OPTIONS
.TP
\fB\fC-h\fR, \fB\fC--help\fR
Show this help manual.
.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-herald (1), 
.BR tork-driver (1), 
.BR tork-engine (1), 
.BR tork-master (1)