#!/usr/bin/env ruby
=begin

TESTR-MASTER 1 "2012-01-20" "14.3.0"
====================================

NAME
----

testr-master - absorbs overhead and runs tests

SYNOPSIS
--------

`testr-master` [*OPTION*]...

DESCRIPTION
-----------

This program reads the following single-line commands (JSON arrays) from its
standard input stream and performs the respective actions as described below.

`["load",` *paths*`,` *files*`]`
  Adds the given array of *paths* to Ruby's $LOAD_PATH, loads the given array
  of *files* after removing their ".rb" file extension if present, and prints
  the given command line to the standard output stream.

`["test",` *test_file*`,` *test_names*`]`
  Runs the given *test_file* 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 named in the given array of *test_names*.

  Prints the given command line to the standard output stream immediately
  after forking the child process.

  Prints the given command line, modified with `"pass"` (if the test passed)
  or `"fail"` (if the test failed) in place of `"test"`, to the standard
  output stream after the forked child process finishes.

  The standard output and error streams of the forked child process are
  redirected to a file whose path and name are the same as that of the test
  file being run by the forked child process but with ".log" appended.

`["stop"]`
  Stops all tests that are currently running and prints the given command line
  to the standard output stream.

`["quit"]`
  Stops all tests that are currently running and exits.

OPTIONS
-------

`-h`, `--help`
  Display this help manual using man(1).

FILES
-----

*.testr.rb*
  Optional Ruby script for configuring testr(1).

ENVIRONMENT
-----------

`TESTR_CONFIGS`
  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 *.testr.rb* is loaded.

SEE ALSO
--------

testr(1), testr-driver(1), testr-master(1), testr-herald(1)

=end =========================================================================

$0 = File.basename(__FILE__) # for easier indentification in ps(1) output

require 'binman'
BinMan.help

require 'testr/master'
TestR::Master.loop

Process.waitall
raise SystemExit # prevent empty test suite from running in the master process