RubyGems - tork - Versions diffs - 19.3.0 → 19.3.1 - Mend

tork 19.3.0 → 19.3.1

Files changed (31) hide show

data/man/man0/VERSION.markdown CHANGED Viewed

@@ -1,3 +1,16 @@
+## Version 19.3.1 (2013-06-07)
+Patch:
+  * server: rescue from failed writes to asynchronously closed clients.
+    Thanks to Jonathan Cairns for reporting and fixing this bug in GH-53:
+    https://github.com/sunaku/tork/issues/53
+Other:
+  * Upgrade to md2man 2.0.
 ## Version 19.3.0 (2013-05-05)
 Minor:

data/man/man1/tork-driver.1 CHANGED Viewed

@@ -1,4 +1,4 @@
-.TH TORK\-DRIVER 1 2013\-05\-05 19.3.0
+.TH TORK\-DRIVER 1 2013\-06\-07 19.3.1
 .SH NAME
 .PP
 tork\-driver \- drives

data/man/man1/tork-driver.1.html ADDED Viewed

@@ -0,0 +1,93 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="md2man 2.0.0 https://github.com/sunaku/md2man" />
+  <title>tork-driver(1) &mdash; drives tork-engine(1) when files change</title>
+  <link rel="stylesheet" href="../style.css"/>
+  <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
+</head>
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/tork-driver.1</span></div></div><div class="container-fluid"><h1 id="TORK-DRIVER-1-2013-06-07-19-3-1">TORK-DRIVER 1 2013-06-07 19.3.1</h1><h2 id="NAME">NAME</h2><p>tork-driver - drives <a class="md2man-xref" href="../man1/tork-engine.1.html">tork-engine(1)</a> when files change</p><h2 id="SYNOPSIS">SYNOPSIS</h2><p><code>tork-driver</code> [<em>OPTION</em>]...</p><h2 id="DESCRIPTION">DESCRIPTION</h2><p>This program drives <a class="md2man-xref" href="../man1/tork-engine.1.html">tork-engine(1)</a> when <a class="md2man-xref" href="../man1/tork-herald.1.html">tork-herald(1)</a> reports files changes.</p><p>This program can be controlled remotely by multiple <a class="md2man-xref" href="../man1/tork-remote.1.html">tork-remote(1)</a> instances.</p><h3 id="Input">Input</h3><p>This program reads the following commands, which are single-line JSON arrays,
+from stdin and performs the actions described respectively.</p><dl><dt><code>[&quot;run_all_test_files&quot;]</code></dt><dd>Runs all test files found within and beneath the current working directory.</dd></dl><dl><dt><em>...</em></dt><dd>Commands for <a class="md2man-xref" href="../man1/tork-engine.1.html">tork-engine(1)</a> are also accepted here.</dd></dl><h3 id="Output">Output</h3><p>This program prints the following messages, which are single-line JSON arrays,
+to stdout.</p><dl><dt><code>[&quot;reabsorb&quot;,</code> <em>overhead_file</em><code>]</code></dt><dd>Test execution overhead is being reabsorbed because <em>overhead_file</em> has
+changed.</dd></dl><dl><dt><em>...</em></dt><dd>Messages from <a class="md2man-xref" href="../man1/tork-engine.1.html">tork-engine(1)</a> and <a class="md2man-xref" href="../man1/tork-master.1.html">tork-master(1)</a> are also reproduced here.</dd></dl><h2 id="OPTIONS">OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><h2 id="FILES">FILES</h2><dl><dt><em>.tork/config.rb</em></dt><dd>Optional Ruby script that is loaded inside the driver process on startup.
+It can read and change the <code>ENV[&#39;TORK_CONFIGS&#39;]</code> environment variable.</dd></dl><dl><dt><code>.tork/driver.rb</code></dt><dd>Optional Ruby script that is loaded inside the driver process on startup.
+It can read and change the following variables.</dd></dl>
+<blockquote>
+<dl><dt><code>Tork::Driver::REABSORB_FILE_GREPS</code></dt><dd>Array of strings or regular expressions that match the paths of overhead
+files.  If any of these equal or match the path of a changed file
+reported by <a class="md2man-xref" href="../man1/tork-herald.1.html">tork-herald(1)</a>, then the test execution overhead will be
+reabsorbed in <a class="md2man-xref" href="../man1/tork-master.1.html">tork-master(1)</a>.</dd></dl><dl><dt><code>Tork::Driver::ALL_TEST_FILE_GLOBS</code></dt><dd>Array of file globbing patterns that describe the set of all test files
+in your Ruby application.</dd></dl><dl><dt><code>Tork::Driver::TEST_FILE_GLOBBERS</code></dt><dd>Hash that maps (1) a regular expression describing a set of file paths
+to (2) a lambda function that accepts a <code>MatchData</code> object containing
+the results of the regular expression matching against the path of a
+changed file, and yields one or more file globbing patterns (a single
+string, or an array of strings) that describe a set of test files that
+need to be run.</dd></dl><dl><dd>The results of these functions are recursively expanded (fed back into
+them) to construct an entire dependency tree of test files that need to
+be run.  For instance, if one function returns a glob that yields files
+matched by another function, then that second function will be called to
+glob more test files.  This process repeats until all dependent test
+files have been accounted for.</dd></dl>
+<blockquote>
+<p><strong><em>Single glob expansion</em></strong></p><p>For example, if test files had the same names as their source files
+followed by an underscore and the file name in reverse like this:</p>
+<ul>
+<li>lib/hello.rb =&gt; test/hello_olleh.rb</li>
+<li>app/world.rb =&gt; spec/world_ldrow.rb</li>
+</ul>
+<p>Then you would add the following to your configuration file:</p>
+<pre><code>Tork::Driver::TEST_FILE_GLOBBERS.update(
+  %r{^(lib|app)/.*?([^/]+?)\.rb$} =&gt; lambda do |matches|
+    name = matches[2]
+    &quot;{test,spec}/**/#{name}_#{name.reverse}.rb&quot;
+  end
+)
+</code></pre>
+<p><strong><em>Multi-glob expansion</em></strong></p><p>For example, if test files could optionally have &quot;test&quot; or &quot;spec&quot;
+prefixed or appended to their already peculiar names, like so:</p>
+<ul>
+<li>lib/hello.rb =&gt; test/hello_olleh_test.rb</li>
+<li>lib/hello.rb =&gt; test/test_hello_olleh.rb</li>
+<li>app/world.rb =&gt; spec/world_ldrow_spec.rb</li>
+<li>app/world.rb =&gt; spec/spec_world_ldrow.rb</li>
+</ul>
+<p>Then you would add the following to your configuration file:</p>
+<pre><code>Tork::Driver::TEST_FILE_GLOBBERS.update(
+  %r{^(lib|app)/.*?([^/]+?)\.rb$} =&gt; lambda do |matches|
+    name = matches[2]
+    [&quot;{test,spec}/**/#{name}_#{name.reverse}.rb&quot;,
+     &quot;{test,spec}/**/#{name}_#{name.reverse}_{test,spec}.rb&quot;,
+     &quot;{test,spec}/**/{test,spec}_#{name}_#{name.reverse}.rb&quot;]
+  end
+)
+</code></pre>
+<p><strong><em>Recursive expansion</em></strong></p><p>For example, if you wanted to run test files associated with
+<code>lib/hello.rb</code> whenever the <code>app/world.rb</code> file changed, then you would
+write:</p>
+<pre><code>Tork::Driver::TEST_FILE_GLOBBERS.update(
+  %r{^app/world\.rb$} =&gt; lambda do |matches|
+    &#39;lib/hello.rb&#39;
+  end
+)
+</code></pre>
+<p>This effectively aliases one file onto another, but not in both
+directions.</p><p><strong><em>Suppressing expansion</em></strong></p><p>These lambda functions can return <code>nil</code> if they do not wish for a
+particular source file to be tested.  For example, to ignore tests for
+all source files except those within a <code>models/</code> directory, you would
+write:</p>
+<pre><code>Tork::Driver::TEST_FILE_GLOBBERS.update(
+  %r{^(lib|app)(/.*?)([^/]+?)\.rb$} =&gt; lambda do |matches|
+    if matches[2].include? &#39;/models/&#39;
+      [&quot;{test,spec}/**/#{matches[3]}_{test,spec}.rb&quot;,
+       &quot;{test,spec}/**/{test,spec}_#{matches[3]}.rb&quot;]
+    #else     # implied by the Ruby language
+      #nil    # implied by the Ruby language
+    end
+  end
+)
+</code></pre>
+</blockquote>
+</blockquote>
+<h2 id="ENVIRONMENT">ENVIRONMENT</h2><p>See <a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a>.</p><h2 id="SEE-ALSO">SEE ALSO</h2><p><a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a>, <a class="md2man-xref" href="../man1/tork-remote.1.html">tork-remote(1)</a>, <a class="md2man-xref" href="../man1/tork-herald.1.html">tork-herald(1)</a>, <a class="md2man-xref" href="../man1/tork-engine.1.html">tork-engine(1)</a>, <a class="md2man-xref" href="../man1/tork-master.1.html">tork-master(1)</a></p></div></body>
+</html>

data/man/man1/tork-engine.1 CHANGED Viewed

@@ -1,4 +1,4 @@
-.TH TORK\-ENGINE 1 2013\-05\-05 19.3.0
+.TH TORK\-ENGINE 1 2013\-06\-07 19.3.1
 .SH NAME
 .PP
 tork\-engine \- wraps

data/man/man1/tork-engine.1.html ADDED Viewed

@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="md2man 2.0.0 https://github.com/sunaku/md2man" />
+  <title>tork-engine(1) &mdash; wraps tork-master(1) with bookkeeping</title>
+  <link rel="stylesheet" href="../style.css"/>
+  <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
+</head>
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/tork-engine.1</span></div></div><div class="container-fluid"><h1 id="TORK-ENGINE-1-2013-06-07-19-3-1">TORK-ENGINE 1 2013-06-07 19.3.1</h1><h2 id="NAME">NAME</h2><p>tork-engine - wraps <a class="md2man-xref" href="../man1/tork-master.1.html">tork-master(1)</a> with bookkeeping</p><h2 id="SYNOPSIS">SYNOPSIS</h2><p><code>tork-engine</code> [<em>OPTION</em>]...</p><h2 id="DESCRIPTION">DESCRIPTION</h2><p>This program uses <a class="md2man-xref" href="../man1/tork-master.1.html">tork-master(1)</a> to run tests and keeps track of the results.</p><p>This program can be controlled remotely by multiple <a class="md2man-xref" href="../man1/tork-remote.1.html">tork-remote(1)</a> instances.</p><h3 id="Input">Input</h3><p>This program reads the following commands, which are single-line JSON arrays,
+from stdin and performs the actions described respectively.</p><dl><dt><code>[&quot;reabsorb_overhead&quot;]</code></dt><dd>Stops any test files that are currently running, reabsorbs the test
+execution overhead, and then re-runs those stopped test files.</dd></dl><dl><dt><code>[&quot;run_test_file&quot;</code>, <em>test_file</em><code>,</code> <em>line_numbers</em>...<code>]</code></dt><dd>Runs tests that correspond to the given sequence of <em>line_numbers</em> in the
+given <em>test_file</em>.  If no <em>line_numbers</em> are given, then only those lines
+that have changed since the last run of <em>test_file</em> will be substituted.
+If any <em>line_numbers</em> are zero, then the entire <em>test_file</em> will be run.</dd></dl><dl><dt><code>[&quot;run_test_files&quot;</code>, <em>test_files_with_optional_line_numbers</em><code>]</code></dt><dd>Calls the <code>run_test_file</code> command once for each item in the given array.</dd></dl><dl><dt><code>[&quot;stop_running_test_files&quot;</code>, <em>signal</em><code>]</code></dt><dd>Stops test files that are currently running by sending the given <em>signal</em>
+(optional; defaults to &quot;SIGTERM&quot;) to their respective worker processes.</dd></dl><dl><dt><code>[&quot;rerun_passed_test_files&quot;]</code></dt><dd>Runs all test files that have passed during their most recent run.</dd></dl><dl><dt><code>[&quot;rerun_failed_test_files&quot;]</code></dt><dd>Runs all test files that have failed during their most recent run.</dd></dl><dl><dt><code>[&quot;quit&quot;]</code></dt><dd>Stops all tests that are currently running and exits.</dd></dl><h3 id="Output">Output</h3><p>This program prints the following messages, which are single-line JSON arrays,
+to stdout.</p><dl><dt><code>[&quot;idle&quot;]</code></dt><dd>All tests have finished running and no tests are queued for running either.</dd></dl><dl><dt><code>[&quot;pass_now_fail&quot;,</code> <em>test_file</em><code>,</code> <em>message</em><code>]</code></dt><dd>A previously passing <em>test_file</em> has now failed.  See <em>message</em> for details.</dd></dl><dl><dt><code>[&quot;fail_now_pass&quot;,</code> <em>test_file</em><code>,</code> <em>message</em><code>]</code></dt><dd>A previously failing <em>test_file</em> has now passed.  See <em>message</em> for details.</dd></dl><dl><dt><em>...</em></dt><dd>Messages from <a class="md2man-xref" href="../man1/tork-master.1.html">tork-master(1)</a> are also reproduced here.</dd></dl><h2 id="OPTIONS">OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><h2 id="FILES">FILES</h2><dl><dt><em>.tork/config.rb</em></dt><dd>Optional Ruby script that is loaded inside the driver process on startup.
+It can read and change the <code>ENV[&#39;TORK_CONFIGS&#39;]</code> environment variable.</dd></dl><dl><dt><em>.tork/engine.rb</em></dt><dd>Optional Ruby script that is loaded inside the master process on startup.</dd></dl><h2 id="ENVIRONMENT">ENVIRONMENT</h2><p>See <a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a>.</p><h2 id="SEE-ALSO">SEE ALSO</h2><p><a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a>, <a class="md2man-xref" href="../man1/tork-remote.1.html">tork-remote(1)</a>, <a class="md2man-xref" href="../man1/tork-master.1.html">tork-master(1)</a></p></div></body>
+</html>

data/man/man1/tork-herald.1 CHANGED Viewed

@@ -1,4 +1,4 @@
-.TH TORK\-HERALD 1 2013\-05\-05 19.3.0
+.TH TORK\-HERALD 1 2013\-06\-07 19.3.1
 .SH NAME
 .PP
 tork\-herald \- reports modified files

data/man/man1/tork-herald.1.html ADDED Viewed

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="md2man 2.0.0 https://github.com/sunaku/md2man" />
+  <title>tork-herald(1) &mdash; reports modified files</title>
+  <link rel="stylesheet" href="../style.css"/>
+  <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
+</head>
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/tork-herald.1</span></div></div><div class="container-fluid"><h1 id="TORK-HERALD-1-2013-06-07-19-3-1">TORK-HERALD 1 2013-06-07 19.3.1</h1><h2 id="NAME">NAME</h2><p>tork-herald - reports modified files</p><h2 id="SYNOPSIS">SYNOPSIS</h2><p><code>tork-herald</code> [<em>OPTION</em>]...</p><h2 id="DESCRIPTION">DESCRIPTION</h2><p>This program monitors the current working directory and all those below it
+recursively.  When any files therein are modified, it prints their relative
+paths in a single-line JSON array to stdout.</p><h2 id="OPTIONS">OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><h2 id="SEE-ALSO">SEE ALSO</h2><p><a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a>, <a class="md2man-xref" href="../man1/tork-driver.1.html">tork-driver(1)</a></p></div></body>
+</html>

data/man/man1/tork-master.1 CHANGED Viewed

@@ -1,4 +1,4 @@
-.TH TORK\-MASTER 1 2013\-05\-05 19.3.0
+.TH TORK\-MASTER 1 2013\-06\-07 19.3.1
 .SH NAME
 .PP
 tork\-master \- absorbs overhead and runs tests

data/man/man1/tork-master.1.html ADDED Viewed

@@ -0,0 +1,35 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="md2man 2.0.0 https://github.com/sunaku/md2man" />
+  <title>tork-master(1) &mdash; absorbs overhead and runs tests</title>
+  <link rel="stylesheet" href="../style.css"/>
+  <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
+</head>
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/tork-master.1</span></div></div><div class="container-fluid"><h1 id="TORK-MASTER-1-2013-06-07-19-3-1">TORK-MASTER 1 2013-06-07 19.3.1</h1><h2 id="NAME">NAME</h2><p>tork-master - absorbs overhead and runs tests</p><h2 id="SYNOPSIS">SYNOPSIS</h2><p><code>tork-master</code> [<em>OPTION</em>]...</p><h2 id="DESCRIPTION">DESCRIPTION</h2><p>This program absorbs your Ruby application&#39;s test execution overhead once and
+simply <a class="md2man-xref">fork(3)</a>s worker processses to run your tests thereafter.  As a result,
+your tests run faster because they no longer spend any time absorbing the test
+execution overhead: worker processes simply inherit the overhead when forked.</p><p>This program can be controlled remotely by multiple <a class="md2man-xref" href="../man1/tork-remote.1.html">tork-remote(1)</a> instances.</p><h3 id="Input">Input</h3><p>This program reads the following commands, which are single-line JSON arrays,
+from stdin and performs the actions described respectively.</p><dl><dt><code>[&quot;test&quot;,</code> <em>test_file</em><code>,</code> <em>line_numbers</em><code>]</code></dt><dd>Forks a worker process to run tests that correspond to the given
+<em>line_numbers</em> in the given <em>test_file</em>.  If <em>line_numbers</em> is empty, then
+the entire <em>test_file</em> will be run.</dd></dl><dl><dt><code>[&quot;stop&quot;,</code> <em>signal</em><code>]</code></dt><dd>Stops all tests that are currently running by sending the given <em>signal</em>
+(optional; defaults to &quot;SIGTERM&quot;) to their respective worker processes.</dd></dl><dl><dt><code>[&quot;quit&quot;]</code></dt><dd>Stops all tests that are currently running and exits.</dd></dl><h3 id="Output">Output</h3><p>This program prints the following messages, which are single-line JSON arrays,
+to stdout.</p><dl><dt><code>[&quot;absorb&quot;]</code></dt><dd>Test execution overhead has been absorbed.  We are ready for testing!</dd></dl><dl><dt><code>[&quot;test&quot;,</code> <em>test_file</em><code>,</code> <em>line_numbers</em><code>,</code> <em>log_file</em><code>,</code> <em>worker_number</em><code>]</code></dt><dd>Test has begun running.  Its output (both stdout and stderr) is being
+captured into <em>log_file</em> in real time, so you can watch it with <code>tail -f</code>.</dd></dl><dl><dt><code>[&quot;pass&quot;,</code> <em>test_file</em><code>,</code> <em>line_numbers</em><code>,</code> <em>log_file</em><code>,</code> <em>worker_number</em><code>,</code> <em>exit_code</em><code>,</code> <em>exit_info</em><code>]</code></dt><dd>Test has passed.</dd></dl><dl><dt><code>[&quot;fail&quot;,</code> <em>test_file</em><code>,</code> <em>line_numbers</em><code>,</code> <em>log_file</em><code>,</code> <em>worker_number</em><code>,</code> <em>exit_code</em><code>,</code> <em>exit_info</em><code>]</code></dt><dd>Test has failed.</dd></dl><h2 id="OPTIONS">OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><h2 id="FILES">FILES</h2><dl><dt><em>.tork/config.rb</em></dt><dd>Optional Ruby script that is loaded inside the driver process on startup.
+It can read and change the <code>ENV[&#39;TORK_CONFIGS&#39;]</code> environment variable.</dd></dl><dl><dt><em>.tork/master.rb</em></dt><dd>Optional Ruby script that is loaded inside the master process on startup.
+It can read and change the following variables.</dd></dl>
+<blockquote>
+<dl><dt><code>Tork::Master::MAX_CONCURRENT_WORKERS</code></dt><dd>Maximum number of worker processes that are allowed to be running
+simultaneously at any given time.  The default value is either the
+number of processors detected on your system or 1 if detection failed.</dd></dl></blockquote>
+<dl><dt><em>.tork/onfork.rb</em></dt><dd>Optional Ruby script that is loaded inside the master process just before a
+worker process is forked.  It can read and change the following variables.</dd></dl>
+<blockquote>
+<dl><dt><code>$tork_test_file</code></dt><dd>Path of the test file that will be run by the worker process.</dd></dl><dl><dt><code>$tork_line_numbers</code></dt><dd>Array of line numbers in the test file that were requested to be run.</dd></dl><dl><dt><code>$tork_log_file</code></dt><dd>Path of the log file that will hold the output of the worker process.</dd></dl><dl><dt><code>$tork_worker_number</code></dt><dd>Sequence number of the worker process that will be forked shortly.</dd></dl></blockquote>
+<dl><dt><em>.tork/worker.rb</em></dt><dd>Optional Ruby script that is loaded inside a worker process just after
+it is forked.  It can read and change the following variables.</dd></dl>
+<blockquote>
+<dl><dt><code>$tork_test_file</code></dt><dd>Path of the test file that will be run by this worker process.</dd></dl><dl><dt><code>$tork_line_numbers</code></dt><dd>Array of line numbers in the test file that were requested to be run.</dd></dl><dl><dt><code>$tork_log_file</code></dt><dd>Path of the log file that will hold the output of this worker process.</dd></dl><dl><dt><code>$tork_worker_number</code></dt><dd>Sequence number of this worker process.</dd></dl></blockquote>
+<h2 id="ENVIRONMENT">ENVIRONMENT</h2><p>See <a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a>.</p><h2 id="SEE-ALSO">SEE ALSO</h2><p><a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a>, <a class="md2man-xref" href="../man1/tork-remote.1.html">tork-remote(1)</a></p></div></body>
+</html>

data/man/man1/tork-notify.1 CHANGED Viewed

@@ -1,4 +1,4 @@
-.TH TORK\-NOTIFY 1 2013\-05\-05 19.3.0
+.TH TORK\-NOTIFY 1 2013\-06\-07 19.3.1
 .SH NAME
 .PP
 tork\-notify \- notifies you of test status changes

data/man/man1/tork-notify.1.html ADDED Viewed

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="md2man 2.0.0 https://github.com/sunaku/md2man" />
+  <title>tork-notify(1) &mdash; notifies you of test status changes</title>
+  <link rel="stylesheet" href="../style.css"/>
+  <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
+</head>
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/tork-notify.1</span></div></div><div class="container-fluid"><h1 id="TORK-NOTIFY-1-2013-06-07-19-3-1">TORK-NOTIFY 1 2013-06-07 19.3.1</h1><h2 id="NAME">NAME</h2><p>tork-notify - notifies you of test status changes</p><h2 id="SYNOPSIS">SYNOPSIS</h2><p><code>tork-notify</code> [<em>OPTION</em>]...</p><h2 id="DESCRIPTION">DESCRIPTION</h2><p>This program serves as an example of how to receive and process messages sent
+by the various programs in the <a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a> suite.  It notifies you when previously
+passing tests fail (or vice versa) through libnotify, xmessage, or growl.  If
+none are available on your system, then the notification is printed to stdout.</p><h2 id="OPTIONS">OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><h2 id="EXIT-STATUS">EXIT STATUS</h2><p>See <a class="md2man-xref" href="../man1/tork-remote.1.html">tork-remote(1)</a>.</p><h2 id="SEE-ALSO">SEE ALSO</h2><p><a class="md2man-xref" href="../man1/tork-remote.1.html">tork-remote(1)</a>, <a class="md2man-xref" href="../man1/tork-engine.1.html">tork-engine(1)</a></p></div></body>
+</html>

data/man/man1/tork-remote.1.html ADDED Viewed

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="md2man 2.0.0 https://github.com/sunaku/md2man" />
+  <title>tork-remote(1) &mdash; controls tork(1) programs</title>
+  <link rel="stylesheet" href="../style.css"/>
+  <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
+</head>
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/tork-remote.1</span></div></div><div class="container-fluid"><h1 id="TORK-REMOTE-1-2012-09-26-18-2-3">TORK-REMOTE 1 2012-09-26 18.2.3</h1><h2 id="NAME">NAME</h2><p>tork-remote - controls <a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a> programs</p><h2 id="SYNOPSIS">SYNOPSIS</h2><p><code>tork-remote</code> [<em>OPTION</em>]... <em>PROGRAM</em></p><h2 id="DESCRIPTION">DESCRIPTION</h2><p>This program sends single-line JSON messages read from its stdin to the given
+<em>PROGRAM</em> which is already running in the same working directory as this one.</p><p>If lines read from stdin are not single-line JSON messages, then they are
+split into an array of words, using the same word-splitting algorithm as
+<a class="md2man-xref">sh(1)</a>, before being sent to the <em>PROGRAM</em> as a single-line JSON message.</p><p>If the <em>PROGRAM</em> sends any messages in response, then they are printed to
+stdout if they are valid single-line JSON messages or to stderr otherwise.</p><h2 id="OPTIONS">OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><h2 id="EXIT-STATUS">EXIT STATUS</h2><dl><dt>1</dt><dd>Could not connect to the <em>PROGRAM</em>.</dd></dl><dl><dt>2</dt><dd>Lost connection to the <em>PROGRAM</em>.</dd></dl><h2 id="SEE-ALSO">SEE ALSO</h2><p><a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a>, <a class="md2man-xref" href="../man1/tork-driver.1.html">tork-driver(1)</a>, <a class="md2man-xref" href="../man1/tork-engine.1.html">tork-engine(1)</a>, <a class="md2man-xref" href="../man1/tork-master.1.html">tork-master(1)</a></p></div></body>
+</html>

data/man/man1/tork.1 CHANGED Viewed

@@ -1,4 +1,4 @@
-.TH TORK 1 2013\-05\-05 19.3.0
+.TH TORK 1 2013\-06\-07 19.3.1
 .SH NAME
 .PP
 tork \- Continuous testing tool for Ruby

data/man/man1/tork.1.html ADDED Viewed

@@ -0,0 +1,42 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <meta name="generator" content="md2man 2.0.0 https://github.com/sunaku/md2man" />
+  <title>tork(1) &mdash; Continuous testing tool for Ruby</title>
+  <link rel="stylesheet" href="../style.css"/>
+  <!--[if lt IE 9]><script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script><![endif]-->
+</head>
+<body><div class="navbar"><div class="navbar-inner"><span class="brand"><a href="../index.html#man1">man1</a>/tork.1</span></div></div><div class="container-fluid"><h1 id="TORK-1-2013-06-07-19-3-1">TORK 1 2013-06-07 19.3.1</h1><h2 id="NAME">NAME</h2><p>tork - Continuous testing tool for Ruby</p><h2 id="SYNOPSIS">SYNOPSIS</h2><p><code>tork</code> [<em>OPTION</em>]... [<em>CONFIG</em>]...</p><h2 id="DESCRIPTION">DESCRIPTION</h2><p>This program is a simple command-line user interface for <a class="md2man-xref" href="../man1/tork-driver.1.html">tork-driver(1)</a>.</p><p>First, it applies the given <em>CONFIG</em> values, which are either (1) paths to
+directories that contain configuration files or (2) names of configuration
+helpers listed in the description of the <code>TORK_CONFIGS</code> environment variable.</p><p>Next, it waits for you to supply interactive commands either (1) directly on
+its stdin or (2) remotely through <a class="md2man-xref" href="../man1/tork-remote.1.html">tork-remote(1)</a>.  From then onward, you may
+press the ENTER key (supplying no command) to see a menu of accepted commands.</p><p>Some interactive commands accept additional arguments, described as follows.</p><dl><dt><code>t</code> <em>test_file</em> [<em>line_number</em>]...</dt><dd>Runs the given <em>test_file</em> while only running those tests that are defined
+on the given list of <em>line_number</em>s.  If no <em>line_number</em>s are given, then
+only those tests that have changed since the last run of the <em>test_file</em>
+will now be run.</dd></dl><dl><dt><code>s</code> [<em>signal</em>]</dt><dd>Stops test files that are currently running by sending the given <em>signal</em>
+(optional; defaults to <code>SIGTERM</code>) to their respective worker processes.</dd></dl><p>This program can be controlled remotely by multiple <a class="md2man-xref" href="../man1/tork-remote.1.html">tork-remote(1)</a> instances.</p><h2 id="OPTIONS">OPTIONS</h2><dl><dt><code>-h</code>, <code>--help</code></dt><dd>Show this help manual.</dd></dl><h2 id="FILES">FILES</h2><dl><dt><em>.tork/config.rb</em></dt><dd>Optional Ruby script that is loaded inside the driver process on startup.
+It can read and change the <code>ENV[&#39;TORK_CONFIGS&#39;]</code> environment variable.</dd></dl><h2 id="ENVIRONMENT">ENVIRONMENT</h2><dl><dt><code>TORK_CONFIGS</code></dt><dd>Colon-separated (:) list of either paths to directories that contain
+configuration files or names of the following configuration helpers.
+If this variable is not set, then its value is assumed to be &quot;default&quot;.</dd></dl>
+<blockquote>
+<dl><dt><code>default</code></dt><dd>Loads the following configuration helpers (as appropriate) if your
+current working directory appears to utilize what they configure.
+See below for complete descriptions of these configuration helpers.</dd></dl>
+<ul>
+<li>rails</li>
+<li>devise</li>
+<li>test</li>
+<li>spec</li>
+<li>cucumber</li>
+<li>factory_girl</li>
+</ul>
+<dl><dt><code>dotlog</code></dt><dd>Hides log files by prefixing their names with a period (dot).</dd></dl><dl><dt><code>logdir</code></dt><dd>Keeps log files away from your tests, in the <code>log/</code> directory.</dd></dl><dl><dt><code>coverage</code></dt><dd>Measures C0 code coverage under Ruby 1.9 and dumps a hash in YAML
+format at the end of your log file containing every Ruby script that
+was loaded from the current working directory or any of its descendant
+directories (the key) mapped to the following information (the value):</dd></dl>
+<blockquote>
+<dl><dt><code>:grade</code></dt><dd>Percentage of source lines that were C0 covered.</dd></dl><dl><dt><code>:nsloc</code></dt><dd>Total number of source lines of code in the file.</dd></dl><dl><dt><code>:holes</code></dt><dd>Line numbers of source lines that were not covered.</dd></dl></blockquote>
+<dl><dt><code>test</code></dt><dd>Supports the Test::Unit standard library.</dd></dl><dl><dt><code>spec</code></dt><dd>Supports the <a href="http://rspec.info">RSpec</a> testing framework.</dd></dl><dl><dt><code>cucumber</code></dt><dd>Supports the <a href="https://cukes.info">Cucumber</a> testing framework.</dd></dl><dl><dt><code>rails</code></dt><dd>Supports the <a href="http://rubyonrails.org">Ruby on Rails</a> web framework.</dd></dl><dl><dt><code>devise</code></dt><dd>Supports the <a href="https://github.com/plataformatec/devise">Devise</a> authentication framework.</dd></dl><dl><dt><code>factory_girl</code></dt><dd>Supports the <a href="https://github.com/thoughtbot/factory_girl">factory_girl</a> testing library.</dd></dl><dl><dt><code>parallel_tests</code></dt><dd>Supports the <a href="https://github.com/grosser/parallel_tests">parallel_tests</a> testing library.</dd></dl></blockquote>
+<h2 id="SEE-ALSO">SEE ALSO</h2><p><a class="md2man-xref" href="../man1/tork.1.html">tork(1)</a>, <a class="md2man-xref" href="../man1/tork-driver.1.html">tork-driver(1)</a>, <a class="md2man-xref" href="../man1/tork-master.1.html">tork-master(1)</a></p></div></body>
+</html>

data/man/style.css ADDED Viewed

@@ -0,0 +1,57 @@
+@import url('http://twitter.github.com/bootstrap/assets/css/bootstrap.css');
+@media all {
+  h1,
+  h2,
+  h3,
+  h4,
+  h5,
+  h6 {
+    margin-top: 1em;
+  }
+  /* deactivate external manual page cross-references */
+  a.md2man-xref:not([href]) {
+    color: inherit;
+    text-decoration: none;
+  }
+}
+@media screen {
+  body {
+    font-family: monospace;
+    text-align: justify;
+    max-width: 83ex; /* allots 78ex width for manpage */
+    margin: auto;
+  }
+  h1:first-child {
+    margin-top: -5em;
+    font-weight: normal;
+    font-size: smaller;
+    text-align: right;
+  }
+}
+@media print {
+  .navbar:first-child {
+    display: none;
+  }
+  /* improve readability of revealed hyperlink URLs */
+  a:after {
+    font-family: monospace;
+  }
+  /* internal links and manual page cross-references */
+  a[href^='#'], a[href^='../man'] {
+    color: inherit;
+    font-weight: bolder;
+    text-decoration: none;
+  }
+  /* undo bootstrap's revealing of those hyperlinks */
+  a[href^='#']:after, a[href^='../man']:after {
+    content: none;
+  }
+}

data/tork.gemspec CHANGED Viewed

@@ -13,15 +13,18 @@ Gem::Specification.new do |s|
   s.summary       = 'test with fork'
   s.description   = 'Runs your tests as they change, in parallel.'
-  s.files         = `git ls-files`.split("\n") + Dir['man/man?/*.?']
+  s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ['lib']
+  s.files += Dir['man/man?/*.?']            # UNIX man pages
+  s.files += Dir['man/**/*.{html,css,js}']  # HTML man pages
+  s.add_development_dependency 'md2man', '~> 2.0'
   s.add_runtime_dependency 'binman', '~> 3.0'
   s.add_runtime_dependency 'json', '~> 1.6'
   s.add_runtime_dependency 'listen', '~> 0.7'
   s.add_runtime_dependency 'diff-lcs', '~> 1.1'
-  s.add_development_dependency 'md2man', '~> 1.4'
   s.add_development_dependency 'rake', '~> 0.9.2.2'
 end

metadata CHANGED Viewed

@@ -1,8 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tork
 version: !ruby/object:Gem::Version
-  version: 19.3.0
-  prerelease:
+  version: 19.3.1
 platform: ruby
 authors:
 - Suraj N. Kurapati
@@ -10,12 +9,25 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2013-05-06 00:00:00.000000000 Z
+date: 2013-06-08 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: md2man
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: binman
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -23,7 +35,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -31,7 +42,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -39,7 +49,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -47,7 +56,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: listen
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -55,7 +63,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -63,7 +70,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: diff-lcs
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -71,31 +77,13 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.1'
-- !ruby/object:Gem::Dependency
-  name: md2man
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.4'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.4'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -103,7 +91,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -174,34 +161,38 @@ files:
 - man/man1/tork-master.1
 - man/man1/tork-driver.1
 - man/man1/tork.1
+- man/index.html
+- man/man0/VERSION.html
+- man/man0/README.html
+- man/man1/tork-remote.1.html
+- man/man1/tork-herald.1.html
+- man/man1/tork-notify.1.html
+- man/man1/tork.1.html
+- man/man1/tork-driver.1.html
+- man/man1/tork-engine.1.html
+- man/man1/tork-master.1.html
+- man/style.css
 homepage: http://github.com/sunaku/tork
 licenses: []
+metadata: {}
 post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -1274588236023689276
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -1274588236023689276
 requirements: []
 rubyforge_project:
-rubygems_version: 1.8.25
+rubygems_version: 2.0.2
 signing_key:
-specification_version: 3
+specification_version: 4
 summary: test with fork
 test_files: []