guard-test 0.2.0 → 0.3.0.rc2

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2010 Rémy Coutable
+Copyright (c) 2010-2011 Rémy Coutable
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,128 @@
+# Guard::Test [![Build Status](http://travis-ci.org/guard/guard-test.png)](http://travis-ci.org/guard/guard-test)
+
+Test::Unit guard allows to automatically & intelligently launch tests when files are modified or created.
+
+If you have any questions/issues about Guard or Guard::Test, please join us on our [Google group](http://groups.google.com/group/guard-dev) or on `#guard` (irc.freenode.net).
+
+## Features
+
+- Compatible with Test::Unit >= 2.2 and Minitest (Ruby 1.9).
+- Auto-detection of the `turn` gem (notification is still missing though).
+- Tested on Ruby 1.8.6, 1.8.7, 1.9.2, REE, Rubinius and JRuby.
+
+## Install
+
+Please be sure to have [Guard](https://github.com/guard/guard) installed before continue.
+
+If you're using Bundler, add it to your `Gemfile` (inside the `test` group):
+
+```ruby
+gem 'guard-test'
+```
+
+and run:
+
+```bash
+$ bundle install
+```
+
+or manually install the gem:
+
+```bash
+$ gem install guard-test
+```
+
+Add Guard definition to your `Guardfile` by running this command:
+
+```bash
+$ guard init test
+```
+
+## Usage
+
+Please read [Guard usage doc](https://github.com/guard/guard#readme).
+
+## Guardfile
+
+Guard::Test can be adapted to any kind of projects.
+
+### Standard Ruby project
+
+```ruby
+guard 'test' do
+  watch(%r{lib/(.+)\.rb})      { |m| "test/#{m[1]}_test.rb" }
+  watch(%r{test/.+_test\.rb})
+  watch('test/test_helper.rb') { "test" }
+end
+```
+
+### Ruby On Rails project
+
+```ruby
+guard 'test' do
+  watch(%r{app/models/(.+)\.rb})                     { |m| "test/unit/#{m[1]}_test.rb" }
+  watch(%r{app/controllers/(.+)\.rb})                { |m| "test/functional/#{m[1]}_test.rb" }
+  watch(%r{app/views/.+\.rb})                        { "test/integration" }
+  watch(%r{lib/(.+)\.rb})                            { |m| "test/#{m[1]}_test.rb" }
+  watch(%r{test/.+_test.rb})
+  watch('app/controllers/application_controller.rb') { ["test/functional", "test/integration"] }
+  watch('test/test_helper.rb')                       { "test" }
+end
+```
+
+Please read the [Guard documentation](https://github.com/guard/guard#readme) for more info about the Guardfile DSL.
+
+## Options
+
+Guard::Test allows you to choose between two different runners (Guard::Test's runners are inherited from Test::Unit's console runner):
+
+- `default`: Display tests results as they happen, with different chars (green `.` for pass, red `F` for fail, purple `E` for error) 
+             and print failures/errors messages & backtraces when all the tests are finished. Obviously, this is the guard-test default.
+- `fastfail`: Display tests results as they happen and print failures/errors messages & backtraces immediately.
+
+Available options:
+
+```ruby
+:rvm            => ['1.8.7', '1.9.2'] # directly run your specs on multiple Rubies, default: nil
+:bundler        => false              # don't use "bundle exec" to run the test command, default: true if a you have a Gemfile
+:runner         => 'fastfail'         # default: 'default'
+:cli            => "-v"               # pass arbitrary CLI arguments to the Ruby/Turn command that runs the tests, default: nil
+:notification   => false              # don't display Growl (or Libnotify) notification after the specs are done running, default: true
+:all_on_start   => false              # don't run all the tests at startup, default: true
+:all_after_pass => false              # don't run all tests after changed tests pass, default: true
+:keep_failed    => false              # keep failed tests until them pass, default: true
+```
+
+### Note about the `:notification` option
+
+If you don't want to use Growl or Libnotify with any of your guards, you can set a `GUARD_NOTIFY` environment variable to `false`.
+You can do it by adding the following statement in you `.bashrc`/`.bash_profile`/`.zshrc`:
+
+```bash
+export GUARD_NOTIFY=false
+```
+
+## Development
+
+- Source hosted on GitHub: https://github.com/guard/guard-test
+- Report issues/Questions/Feature requests on GitHub Issues: https://github.com/guard/guard-test/issues
+
+Pull requests are very welcome!
+Make sure your patches are well tested.
+Please create a topic branch for every separate change you make.
+
+## Versioning
+
+Guard::Test follows [Semantic Versioning](http://semver.org), both SemVer and SemVerTag.
+
+## Author
+
+[Rémy Coutable](https://github.com/rymai)
+
+## Contributors
+
+https://github.com/guard/guard-test/contributors
+
+## Kudos
+
+Many thanks to [Thibaud Guillaume-Gentil](https://github.com/thibaudgg) for creating the excellent Guard gem.

data/lib/guard/test.rb

@@ -1,30 +1,68 @@
+# encoding: utf-8
 require 'guard'
 require 'guard/guard'
 
+# Thanks Aaron and Eric! http://redmine.ruby-lang.org/issues/show/3561
+# Eric Hodel: "whenever you use a gem that replaces stdlib functionality you should use #gem before #require."
+begin
+  require 'turn'
+  gem 'test-unit' if RUBY_VERSION >= '1.9'
+rescue LoadError
+  gem 'test-unit'
+end
+
+require 'test/unit'
+
 module Guard
   class Test < Guard
 
     autoload :Runner,    'guard/test/runner'
     autoload :Inspector, 'guard/test/inspector'
 
+    def initialize(watchers=[], options={})
+      super
+      @options = {
+        :all_on_start   => true,
+        :all_after_pass => true,
+        :keep_failed    => true
+      }.update(options)
+      @last_failed  = false
+      @failed_paths = []
+
+      @runner = Runner.new(options)
+    end
+
     def start
-      Runner.set_test_unit_runner(options)
-      UI.info "Guard::Test is running!"
+      ::Guard::UI.info("Guard::Test #{TestVersion::VERSION} is running!")
+      run_all if @options[:all_on_start]
     end
 
     def run_all
-      clean_and_run(["test"], :message => "Running all tests")
+      passed = @runner.run(Inspector.clean(['test']), :message => 'Running all tests')
+
+      @failed_paths = [] if passed
+      @last_failed  = !passed
     end
 
-    def run_on_change(paths)
-      clean_and_run(paths)
+    def reload
+      @failed_paths = []
     end
 
-  private
+    def run_on_change(paths)
+      paths += @failed_paths if @options[:keep_failed]
+      passed = @runner.run(Inspector.clean(paths))
 
-    def clean_and_run(paths, options={})
-      paths = Inspector.clean(paths)
-      Runner.run(paths, options) unless paths.empty?
+      if passed
+        # clean failed paths memory
+        @failed_paths -= paths if @options[:keep_failed]
+        # run all the tests if the changed tests failed, like autotest
+        run_all if @last_failed && @options[:all_after_pass]
+      else
+        # remember failed paths for the next change
+        @failed_paths += paths if @options[:keep_failed]
+        # track whether the changed tests failed for the next change
+        @last_failed = true
+      end
     end
 
   end

data/lib/guard/test.rbc

@@ -1,5 +1,5 @@
 !RBIX
-10937318184790222022
+17831730954501249321
 x
 M
 1
@@ -9,7 +9,7 @@ x
 10
 __script__
 i
-46
+134
 5
 7
 0
@@ -28,36 +28,124 @@ i
 1
 1
 15
-99
+26
+93
+0
+15
+29
+59
+0
+5
 7
 3
-65
+64
+47
 49
+1
+1
+15
+45
 4
+5
+7
+6
+64
+49
+7
+1
+9
+55
+5
+7
+8
+64
+47
+49
+9
+1
+8
+56
+1
+30
+8
+93
+26
+93
+1
+15
+24
+13
+45
+10
+11
+12
+49
+12
+1
+10
+76
+8
+88
+15
+5
+7
+8
+64
+47
+49
+9
+1
+25
+8
+93
+15
+92
+1
+27
+34
+92
+0
+27
+15
+5
+7
+13
+64
+47
+49
+1
+1
+15
+99
+7
+14
+65
+49
+15
 2
 13
 99
 12
 7
-5
+16
 12
 7
-6
+17
 12
 65
 12
 49
-7
+18
 4
 15
 49
-5
+16
 0
 15
 2
 11
 I
-6
+8
 I
 0
 I
@@ -66,7 +154,7 @@ I
 0
 n
 p
-8
+19
 s
 5
 guard
@@ -76,6 +164,35 @@ require
 s
 11
 guard/guard
+s
+4
+turn
+x
+12
+RUBY_VERSION
+n
+s
+3
+1.9
+x
+2
+>=
+s
+9
+test-unit
+x
+3
+gem
+x
+9
+LoadError
+n
+x
+3
+===
+s
+9
+test/unit
 x
 5
 Guard
@@ -157,7 +274,7 @@ x
 4
 Test
 i
-84
+94
 5
 66
 5
@@ -224,15 +341,25 @@ i
 8
 4
 15
-5
-48
-13
-15
 99
 7
+13
+7
 14
+65
+67
+49
+7
+0
+49
+8
+4
+15
+99
 7
 15
+7
+16
 65
 67
 49
@@ -252,7 +379,7 @@ I
 0
 n
 p
-16
+17
 x
 6
 Runner
@@ -269,89 +396,240 @@ s
 20
 guard/test/inspector
 x
-5
-start
+10
+initialize
 M
 1
 n
 n
 x
-5
-start
+10
+initialize
 i
-20
-45
+107
+23
+0
+10
+9
+35
+0
+19
 0
+15
+23
 1
-5
-48
-2
+10
+23
+44
+43
+0
+78
 49
-3
+1
+1
+19
 1
 15
-45
+54
+89
+2
+15
+44
+43
+0
+4
+3
+49
+1
+1
+13
+7
+3
+2
+49
 4
+2
+15
+13
+7
 5
+2
+49
+4
+2
+15
+13
 7
 6
-64
+2
+49
+4
+2
+15
+20
+1
 49
 7
 1
+38
+8
+15
+3
+38
+9
+15
+35
+0
+38
+10
+15
+45
 11
-I
+12
+13
+71
+13
+47
+9
+99
+47
+49
+14
+0
+13
+20
+1
+47
+49
 2
+1
+15
+8
+104
+20
+1
+49
+13
+1
+38
+15
+11
 I
-0
+6
 I
-0
+2
 I
 0
+I
+2
 n
 p
-8
+16
 x
-6
-Runner
-n
+4
+Hash
 x
-7
-options
+16
+new_from_literal
 x
-20
-set_test_unit_runner
+10
+initialize
 x
-2
-UI
-n
-s
-23
-Guard::Test is running!
+12
+all_on_start
+x
+3
+[]=
+x
+14
+all_after_pass
+x
+11
+keep_failed
+x
+6
+update
+x
+8
+@options
+x
+12
+@last_failed
+x
+13
+@failed_paths
+x
+6
+Runner
+n
+x
+3
+new
+x
+8
+allocate
 x
-4
-info
-p
 7
+@runner
+p
+23
 I
 -1
 I
-a
+16
 I
-0
+17
 I
-b
+17
 I
-a
+1b
+I
+1c
 I
-c
+24
 I
-14
+19
+I
+2c
+I
+1a
+I
+34
+I
+1b
+I
+3b
+I
+1c
+I
+40
+I
+18
+I
+43
+I
+1d
+I
+47
+I
+1e
+I
+4c
+I
+20
+I
+6b
 x
 68
 /Users/remy/Development/Ruby/Gems/guard/guard-test/lib/guard/test.rb
 p
-0
+2
+x
+8
+watchers
+x
+7
+options
 x
 17
 method_visibility
@@ -359,6 +637,130 @@ x
 15
 add_defn_method
 x
+5
+start
+M
+1
+n
+n
+x
+5
+start
+i
+39
+44
+43
+0
+43
+1
+7
+2
+45
+3
+4
+43
+5
+47
+101
+6
+7
+7
+63
+3
+49
+8
+1
+15
+39
+9
+7
+10
+49
+11
+1
+9
+37
+5
+48
+12
+8
+38
+1
+11
+I
+4
+I
+0
+I
+0
+I
+0
+n
+p
+13
+x
+5
+Guard
+x
+2
+UI
+s
+12
+Guard::Test 
+x
+11
+TestVersion
+n
+x
+7
+VERSION
+x
+4
+to_s
+s
+12
+ is running!
+x
+4
+info
+x
+8
+@options
+x
+12
+all_on_start
+x
+2
+[]
+x
+7
+run_all
+p
+9
+I
+-1
+I
+23
+I
+0
+I
+24
+I
+17
+I
+25
+I
+26
+I
+0
+I
+27
+x
+68
+/Users/remy/Development/Ruby/Gems/guard/guard-test/lib/guard/test.rb
+p
+0
+x
 7
 run_all
 M
@@ -369,50 +771,91 @@ x
 7
 run_all
 i
-28
-5
-7
+59
+39
 0
+45
+1
+2
+7
+3
 64
 35
 1
+49
+4
+1
 44
 43
-1
+5
 79
 49
-2
+6
 1
 13
 7
-3
 7
-4
+7
+8
 64
 49
-5
+9
 2
 15
-47
 49
-6
+10
+2
+19
+0
+15
+20
+0
+9
+46
+35
+0
+38
+11
+8
+47
+1
+15
+20
+0
+10
+55
 2
+8
+56
+3
+38
+12
 11
 I
-6
+7
 I
-0
+1
 I
 0
 I
 0
 n
 p
+13
+x
 7
+@runner
+x
+9
+Inspector
+n
 s
 4
 test
 x
+5
+clean
+x
 4
 Hash
 x
@@ -428,139 +871,215 @@ x
 3
 []=
 x
+3
+run
+x
 13
-clean_and_run
+@failed_paths
+x
+12
+@last_failed
 p
-5
+11
 I
 -1
 I
-f
+28
 I
 0
 I
-10
+29
 I
-1c
+24
+I
+2b
+I
+2f
+I
+0
+I
+30
+I
+2c
+I
+3b
 x
 68
 /Users/remy/Development/Ruby/Gems/guard/guard-test/lib/guard/test.rb
 p
-0
+1
 x
-13
-run_on_change
+6
+passed
+x
+6
+reload
 M
 1
 n
 n
 x
-13
-run_on_change
+6
+reload
 i
-8
 5
-20
+35
 0
-47
-49
+38
 0
-1
 11
 I
-3
-I
 1
 I
-1
+0
 I
-1
+0
+I
+0
 n
 p
 1
 x
 13
-clean_and_run
+@failed_paths
 p
 5
 I
 -1
 I
-13
+2f
 I
 0
 I
-14
+30
 I
-8
+5
 x
 68
 /Users/remy/Development/Ruby/Gems/guard/guard-test/lib/guard/test.rb
 p
-1
-x
-5
-paths
-x
-7
-private
+0
 x
 13
-clean_and_run
+run_on_change
 M
 1
 n
 n
 x
 13
-clean_and_run
+run_on_change
 i
-46
-23
-1
-10
-14
-44
-43
+110
+39
 0
-78
-49
+7
 1
+49
+2
 1
+9
 19
+20
+0
+39
+3
+81
+4
+19
+0
+8
+20
 1
 15
+39
+5
 45
-2
-3
+6
+7
 20
 0
 49
-4
+8
+1
+49
+9
 1
 19
-0
+1
 15
 20
+1
+9
+85
+39
 0
+7
+1
 49
-5
+2
+1
+9
+60
+39
+3
+20
+0
+82
+10
+38
+3
+8
+61
+1
+15
+39
+11
+13
+9
+75
+15
+39
 0
+7
+12
+49
+2
+1
 9
-35
+82
+5
+48
+13
+8
+83
 1
 8
-45
-45
-6
-7
-20
+109
+39
 0
-20
+7
 1
 49
+2
+1
+9
+104
+39
+3
+20
+0
+81
+4
+38
+3
 8
+105
+1
+15
 2
+38
+11
 11
 I
 5
@@ -569,16 +1088,28 @@ I
 I
 1
 I
-2
+1
 n
 p
-9
+14
 x
-4
-Hash
+8
+@options
 x
-16
-new_from_literal
+11
+keep_failed
+x
+2
+[]
+x
+13
+@failed_paths
+x
+1
++
+x
+7
+@runner
 x
 9
 Inspector
@@ -587,31 +1118,76 @@ x
 5
 clean
 x
-6
-empty?
-x
-6
-Runner
-n
-x
 3
 run
-p
+x
+1
+-
+x
+12
+@last_failed
+x
+14
+all_after_pass
+x
 7
+run_all
+p
+27
 I
 -1
 I
-19
+33
 I
-e
+0
 I
-1a
+34
 I
-19
+14
 I
-1b
+0
+I
+15
+I
+35
+I
+25
+I
+37
+I
+29
+I
+39
+I
+3d
+I
+0
+I
+3e
 I
-2e
+3b
+I
+53
+I
+0
+I
+55
+I
+3e
+I
+69
+I
+0
+I
+6a
+I
+40
+I
+6d
+I
+0
+I
+6e
 x
 68
 /Users/remy/Development/Ruby/Gems/guard/guard-test/lib/guard/test.rb
@@ -621,40 +1197,40 @@ x
 5
 paths
 x
-7
-options
+6
+passed
 p
 15
 I
 2
 I
-7
+13
 I
 d
 I
-8
+14
 I
 18
 I
-a
+16
 I
 26
 I
-f
+23
 I
 34
 I
-13
+28
 I
 42
 I
-17
+2f
 I
-46
+50
 I
-19
+33
 I
-54
+5e
 x
 68
 /Users/remy/Development/Ruby/Gems/guard/guard-test/lib/guard/test.rb
@@ -668,7 +1244,7 @@ p
 I
 2
 I
-5
+11
 I
 1f
 x
@@ -680,21 +1256,49 @@ x
 13
 attach_method
 p
-7
+21
 I
 0
 I
-1
+2
 I
 9
 I
-2
+3
 I
 12
 I
-4
+8
+I
+22
+I
+9
+I
+38
+I
+0
+I
+40
+I
+a
+I
+4d
+I
+b
+I
+5d
+I
+0
+I
+61
+I
+e
+I
+6a
+I
+10
 I
-2e
+86
 x
 68
 /Users/remy/Development/Ruby/Gems/guard/guard-test/lib/guard/test.rb