test-loop 0.0.1

data/LICENSE

@@ -0,0 +1,15 @@
+(the ISC license)
+
+Copyright 2010 Suraj N. Kurapati <sunaku@gmail.com>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/README.md

@@ -0,0 +1,64 @@
+test-loop - Continuous testing for Ruby with fork/eval
+======================================================
+
+test-loop is a fast continuous testing tool for Ruby that continuously detects
+and tests changes in your Ruby application in an efficient manner, whereby it:
+
+1. Absorbs the test execution overhead into the main Ruby process.
+2. Forks to evaluate your test files directly and without overhead.
+
+It relies on file modification times to determine what parts of your Ruby
+application have changed and then uses Rake's String#pathmap function to
+determine which test files in your test suite correspond to those changes.
+
+
+Features
+--------
+
+* Supports Test::Unit, RSpec, or any other testing framework that is utilized
+  by your application's `test/test_helper.rb` and `spec/spec_helper.rb` files.
+
+* Tests CHANGES in your Ruby application; does NOT run all tests every time.
+  (You can force it to run all tests by pressing Control-\ in your terminal.)
+
+* Reabsorbs test execution overhead if the test or spec helper file changes.
+  (You can force it to reabsorb by pressing Control-Z in your terminal.)
+
+* Mostly I/O bound, so you can have it always running without CPU slowdowns.
+
+* Implemented in less than 40 (SLOC) lines of code! :-)
+
+
+Install
+-------
+
+As a Ruby gem:
+
+    gem install test-loop
+
+As a Rails plugin:
+
+    rails plugin install git://github.com/sunaku/test-loop  # Rails >= 3
+    script/plugin install git://github.com/sunaku/test-loop # older Rails
+
+
+Usage
+-----
+
+test-loop # if installed as a Ruby gem
+
+rake test:loop # if installed as a Rails plugin
+
+* Press Control-Z to forcibly run all tests, even
+  if there are no changes in your Ruby application.
+
+* Press Control-\ (backslash) to forcibly reabsorb the test
+  execution overhead, even if its sources have not changed.
+
+* Press Control-C to quit the test loop.
+
+
+License
+-------
+
+See the LICENSE file for details.

data/bin/test-loop

@@ -0,0 +1,2 @@
+#!/usr/bin/env ruby
+load File.expand_path('../../lib/test-loop.rb', __FILE__)

data/lib/tasks/test-loop.rake

@@ -0,0 +1,8 @@
+namespace :test do
+  desc 'Test changes; Ctrl-Z forces; Ctrl-\ reloads; Ctrl-C quits.'
+  task :loop do |test_loop_task|
+    ENV['RAILS_ENV'] = 'test' # for Rails
+    ARGV.delete test_loop_task.name # obstructs RSpec
+    exec 'ruby', File.expand_path('../../test-loop.rb', __FILE__), *ARGV
+  end
+end

data/lib/test-loop.rb

@@ -0,0 +1,42 @@
+require 'rake' # for String#pathmap
+
+# absorb test execution overhead into master process
+overhead_file_glob = '{test,spec}/*_helper.rb'
+$LOAD_PATH.unshift 'lib' # for non-Rails applications
+
+Dir[overhead_file_glob].each do |file|
+  $LOAD_PATH.unshift file.pathmap('%d')
+  require file.pathmap('%n')
+end
+
+# continuously watch for and test changed code
+started_at = last_ran_at = Time.now
+trap(:QUIT) { started_at = Time.at(0) }  # Control-\
+trap(:TSTP) { last_ran_at = Time.at(0) } # Control-Z
+
+loop do
+  # figure out what test files need to be run
+  test_files = {
+    '{test,spec}/**/*_{test,spec}.rb' => '%p',
+    '{lib,app}/**/*.rb' => '{test,spec}/**/%n_{test,spec}%x',
+  }.
+  map do |source_file_glob, test_file_pathmap|
+    Dir[source_file_glob].
+    select {|file| File.mtime(file) > last_ran_at }.
+    map {|path| Dir[path.pathmap(test_file_pathmap)] }
+  end.flatten.uniq
+
+  # fork worker process to run the test files
+  unless test_files.empty?
+    last_ran_at = Time.now
+    fork { test_files.each {|f| load f } }
+    Process.wait
+  end
+
+  # re-absorb test execution overhead as necessary
+  if Dir[overhead_file_glob].any? {|file| File.mtime(file) > started_at }
+    exec 'ruby', __FILE__, *ARGV
+  end
+
+  sleep 1
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: test-loop
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Suraj N. Kurapati
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-10 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: 
+email: 
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- LICENSE
+- README.md
+- bin/test-loop
+- lib/test-loop.rb
+- lib/tasks/test-loop.rake
+has_rdoc: true
+homepage: http://github.com/sunaku/test-loop
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Continuous testing for Ruby with fork/eval
+test_files: []
+