.TH TORK\-ENGINE 1 2012\-07\-11 18.2.2
.SH NAME
.PP
tork\-engine \- wraps 
.BR tork\-master (1) 
with bookkeeping
.SH SYNOPSIS
.PP
\fB\fCtork-engine\fR [\fIOPTION\fP]...
.SH DESCRIPTION
.PP
This program tells 
.BR tork\-master (1) 
to run your tests and keeps track of test
results.  It 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["reabsorb_overhead",\fR \fIpaths\fP\fB\fC,\fR \fIfiles\fP\fB\fC]\fR
Stops any test files that are currently running, reabsorbs the given test
execution overhead, and resumes running those interrupted test files.  See
the "load" command in 
.BR tork\-master (1) 
for more information.
.TP
\fB\fC["run_test_file"\fR, \fItest_file\fP\fB\fC,\fR \fIline_numbers\fP\fB\fC]\fR
Runs tests that correspond to the given \fIline_numbers\fP array in the given
\fItest_file\fP.  If \fIline_numbers\fP is \fB\fCnull\fR, then only those lines that have
changed since the last time the \fItest_file\fP was run will be substituted.  If
\fIline_numbers\fP is an empty array, then the entire \fItest_file\fP will be run.
.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["rerun_failed_test_files"]\fR
Runs all test files that have failed during their most recent run.
.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)