tork 15.0.0

data/lib/tork/server.rb

@@ -0,0 +1,38 @@
+require 'json'
+
+module Tork
+module Server
+
+  def quit
+    throw :tork_server_quit
+  end
+
+  def loop
+    (@client = STDOUT.dup).sync = true
+    STDOUT.reopen(STDERR).sync = true
+
+    catch :tork_server_quit do
+      while line = STDIN.gets
+        warn "#{caller[2]} RECV #{line.chomp}" if $DEBUG
+
+        command = JSON.load(line)
+        method = command.first
+
+        if respond_to? method and method != __method__ # prevent loops
+          @command, @command_line = command, line
+          __send__(*command)
+        else
+          warn "#{self}: bad command: #{method}"
+        end
+      end
+    end
+  rescue Interrupt
+    # forced quit
+  end
+
+  def self.extended server
+    trap(:SIGTERM){ server.quit }
+  end
+
+end
+end

data/lib/tork/version.rb

@@ -0,0 +1,3 @@
+module Tork
+  VERSION = "15.0.0"
+end

data/man/man1/tork-driver.1

@@ -0,0 +1,70 @@
+.TH TORK\-DRIVER 1 2012\-01\-23 15.0.0
+.SH NAME
+.PP
+tork\-driver \- drives 
+.BR tork\-master (1) 
+and does bookkeeping
+.SH SYNOPSIS
+.PP
+\fB\fCtork-driver\fR [\fIOPTION\fP]...
+.SH DESCRIPTION
+.PP
+This program 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["run_all_test_files"]\fR
+Runs all test files found within and beneath the current working directory.
+.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["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
+\fB\fC["quit"]\fR
+Stops all tests that are currently running and exits.
+.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
+Display this help manual using 
+.BR man (1).
+.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\-driver (1), 
+.BR tork\-master (1), 
+.BR tork\-herald (1)

data/man/man1/tork-herald.1

@@ -0,0 +1,22 @@
+.TH TORK\-HERALD 1 2012\-01\-23 15.0.0
+.SH NAME
+.PP
+tork\-herald \- reports modified files
+.SH SYNOPSIS
+.PP
+\fB\fCtork-herald\fR [\fIOPTION\fP]...
+.SH DESCRIPTION
+.PP
+This program monitors the current working directory and prints relative paths
+of modified files, one per line, to the standard output stream.
+.SH OPTIONS
+.TP
+\fB\fC-h\fR, \fB\fC--help\fR
+Display this help manual using 
+.BR man (1).
+.SH SEE ALSO
+.PP
+.BR tork (1), 
+.BR tork\-driver (1), 
+.BR tork\-master (1), 
+.BR tork\-herald (1)

data/man/man1/tork-master.1

@@ -0,0 +1,61 @@
+.TH TORK\-MASTER 1 2012\-01\-23 15.0.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 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 \fItest_names\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 named in the given array of \fItest_names\fP.
+.IP
+Prints the given command line to the standard output stream immediately
+after forking the child process.
+.IP
+Prints the given command line, modified with \fB\fC"pass"\fR (if the test passed)
+or \fB\fC"fail"\fR (if the test failed) in place of \fB\fC"test"\fR, to the standard
+output stream after the forked child process finishes.
+.IP
+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.
+.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
+Display this help manual using 
+.BR man (1).
+.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\-driver (1), 
+.BR tork\-master (1), 
+.BR tork\-herald (1)

data/man/man1/tork.1

@@ -0,0 +1,27 @@
+.TH TORK 1 2012\-01\-23 15.0.0
+.SH NAME
+.PP
+tork \- Continuous testing tool for Ruby
+.SH SYNOPSIS
+.PP
+\fB\fCtork\fR [\fIOPTION\fP]... [\fICONFIG\fP]...
+.SH DESCRIPTION
+.PP
+This program is a simple command\-line user interface for 
+.BR tork\-driver (1).  
+It
+loads the given \fICONFIG\fP files (which are either paths to actual files or
+names of helper libraries in the tork/config/ namespace of Ruby's load path)
+and then waits for you to supply interactive commands on its stdin.  You may
+press the ENTER key (supplying no command) to see a menu of accepted commands.
+.SH OPTIONS
+.TP
+\fB\fC-h\fR, \fB\fC--help\fR
+Display this help manual using 
+.BR man (1).
+.SH SEE ALSO
+.PP
+.BR tork (1), 
+.BR tork\-driver (1), 
+.BR tork\-master (1), 
+.BR tork\-herald (1)

data/tork.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "tork/version"
+
+Gem::Specification.new do |s|
+  s.name          = "tork"
+  s.version       = Tork::VERSION
+  s.authors,
+  s.email         = File.read('LICENSE').scan(/Copyright \d+ (.+) <(.+?)>/).transpose
+  s.homepage      = "http://github.com/sunaku/tork"
+  s.summary       = "Continuous testing tool for Ruby"
+  s.description   = nil
+
+  s.files         = `git ls-files`.split("\n") + Dir["man/**/*"]
+  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.add_runtime_dependency 'binman', '~> 3'
+  s.add_runtime_dependency 'json', '>= 1.6.1', '< 2'
+  s.add_runtime_dependency 'guard', '>= 0.9.0', '< 1'
+  s.add_runtime_dependency 'diff-lcs', '>= 1.1.2', '< 2'
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification
+name: tork
+version: !ruby/object:Gem::Version
+  version: 15.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Suraj N. Kurapati
+- Brian D. Burns
+- Daniel Pittman
+- Jacob Helwig
+- Corné Verbruggen
+- Jose Pablo Barrantes
+- Spencer Steffen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: binman
+  requirement: &16374880 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: *16374880
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &11501340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.6.1
+    - - <
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: *11501340
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: &11499600 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+    - - <
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: *11499600
+- !ruby/object:Gem::Dependency
+  name: diff-lcs
+  requirement: &11496820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.1.2
+    - - <
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: *11496820
+description: ''
+email:
+- sunaku@gmail.com
+- burns180@gmail.com
+- daniel@rimspace.net
+- jacob@technosorcery.net
+- corne@g-majeur.nl
+- xjpablobrx@gmail.com
+- spencer@citrusme.com
+executables:
+- tork
+- tork-driver
+- tork-herald
+- tork-master
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- HISTORY.markdown
+- LICENSE
+- README.markdown
+- Rakefile
+- bin/tork
+- bin/tork-driver
+- bin/tork-herald
+- bin/tork-master
+- lib/tork/client.rb
+- lib/tork/config.rb
+- lib/tork/config/parallel_tests.rb
+- lib/tork/config/rails.rb
+- lib/tork/driver.rb
+- lib/tork/master.rb
+- lib/tork/server.rb
+- lib/tork/version.rb
+- tork.gemspec
+- man/man1/tork-herald.1
+- man/man1/tork-master.1
+- man/man1/tork-driver.1
+- man/man1/tork.1
+homepage: http://github.com/sunaku/tork
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Continuous testing tool for Ruby
+test_files: []
+has_rdoc: