.TH TORK\-MASTER 1 2012\-02\-26 18.1.0 .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)