Contents

.TH TORK\-DRIVER 1 2012\-10\-10 18.2.4
.SH NAME
.PP
tork\-driver \- drives 
.BR tork-engine (1) 
when files change
.SH SYNOPSIS
.PP
\fB\fCtork-driver\fR [\fIOPTION\fP]...
.SH DESCRIPTION
.PP
This program drives 
.BR tork-engine (1) 
according to 
.BR tork-herald (1)'s 
observations.
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-engine (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["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
\fI...\fP
This program accepts 
.BR tork-engine (1) 
commands and delegates them accordingly.
.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
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)

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
tork-18.2.4	man/man1/tork-driver.1