hydra 0.16.0 → 0.16.1

data/README.rdoc

@@ -1,4 +1,4 @@
-= Hѱdra
+= Hydra
 
 Spread your tests over multiple machines to test your code faster.
 
@@ -12,42 +12,15 @@ Hydra's goals are to make distributed testing easy. So as long as
 you can ssh into a computer and run the tests, you can automate
 the distribution with Hydra.
 
-== Usage
+== Usage and Configuration
 
-In your rakefile:
+Check out the wiki for usage and configuration information:
 
-  require 'hydra'
-  require 'hydra/tasks'
+http://wiki.github.com/ngauthier/hydra/
 
-  Hydra::TestTask.new('hydra') do |t|
-    t.add_files 'test/unit/**/*_test.rb'
-    t.add_files 'test/functional/**/*_test.rb'
-    t.add_files 'test/integration/**/*_test.rb'
-  end
+I've tried hard to keep accurate documentation via RDoc as well:
 
-Run:
-
-  $ rake hydra
-
-Hydra defaults to Single Core mode, so you may want to configure it
-to use two (or more) of your cores if you have a multi-processing machine.
-
-== Hydra + Cucumber
-
-Hydra can run cucumber features, but because of cucumber's specialized
-environment, cucumber features have to be run after your other tests.
-
-  Hydra::TestTask.new('hydra') do |t|
-    t.add_files 'test/unit/**/*_test.rb'
-    t.add_files 'test/functional/**/*_test.rb'
-    t.add_files 'test/integration/**/*_test.rb'
-    # cucumber
-    t.autosort = false
-    t.add_files 'features/**/*.feature'
-  end
-
-Hydra's autosort feature sorts files by their runtime, so we
-have to disable it in order to run cucumber features at the end
+http://rdoc.info/projects/ngauthier/hydra
 
 == Supported frameworks
 
@@ -55,146 +28,11 @@ Right now hydra only supports a few frameworks:
 
 * Test::Unit
 * Cucumber
+* RSpec
 
 We're working on adding more frameworks, and if you'd like to help, please
 send me a message and I'll show you where to code!
 
-== Running Remote Tasks
-
-You can run tasks across all of your remote workers easily with Hydra. In your rake file, add:
-
-  Hydra::RemoteTask.new('db:reset')
-
-Then you can run:
-
-  rake hydra:remote:db:reset
-
-== Running Global Tasks
-
-A Global task is a task run locally *and* remotely. It's used in the same way as RemoteTask:
-
-  Hydra::GlobalTask.new('db:reset')
-
-But it is invoked in a higher namespace:
-
-  rake hydra:db:reset
-
-== Configuration
-
-Place the config file in the main project directory as
-'hydra.yml' or 'config/hydra.yml'.
-
-=== Examples
-
-==== Dual Core 
-
-  workers:
-    - type: local
-      runners: 2
-
-==== Dual Core, with a remote Quad Core server
-
-The -p3022 tells it to connect on a different port
-
-  workers:
-    - type: local
-      runners: 2
-    - type: ssh
-      connect: user@example.com
-      ssh_opts: -p3022
-      directory: /absolute/path/to/project
-      runners: 4
-
-==== Two Remote Quad Cores with Synchronization
-
-You can use the 'sync' configuration to allow rsync to synchronize
-the local and remote directories every time you run hydra.
-
-  workers:
-    - type: ssh
-      connect: user@alpha.example.com
-      directory: /path/to/project/on/alpha/
-      runners: 4
-    - type: ssh
-      connect: user@beta.example.com
-      directory: /path/to/project/on/beta/
-      runners: 4
-
-  sync:
-      directory: /my/local/project/directory
-      exclude:
-        - tmp
-        - log
-        - doc
-
-=== Workers Options
-
-==== type
-
-Either "local" or "ssh".
-
-==== runners
-
-The *runners* option is how many processes will be running
-on the machine. It's best to pick the same number
-as the number of cores on that machine (as well as your
-own).
-
-=== SSH Options
-
-==== connect
-
-The *connect* option is passed to SSH. So if you've setup an
-ssh config alias to a server, you can use that. It is also
-used in rsync, so you cannot use options.
-
-==== ssh_opts
-
-The *ssh_opts* option is passed to SSH and to Rsync's RSH so
-that you can use the same ssh options for connecting and rsync.
-Use ssh_opts to set the port or compression options.
-
-==== directory
-
-The *directory* option is the path for the project directory
-where the tests should be run.
-
-=== Using Hydra::Listeners
-
-Hydra comes with a couple of listeners for the events it fires. By
-default, Hydra::Listener::MinimalOutput is used to display the
-files being tests and the ./F/E for each file and F/E output.
-
-It also uses Hydra::Listener::ReportGenerator to generate reports
-of the test files to that it can order them by their run times.
-
-To use another listener, just add a listeners node to the config file.
-For example, if you are on Ubuntu Linux (or have access to the 
-notify-send command) you can add a notifier listener like this:
-
-  listeners:
-    - Hydra::Listener::Notifier.new
-
-Note that if you make a listener node, the default listeners will be
-overridden, so you will no longer have the standard minimal output
-unless you do:
-
-  listeners:
-    - Hydra::Listener::Notifier.new
-    - Hydra::Listener::MinimalOutput.new
-
-Listeners take one argument to their contstructor: an IO object. So,
-you can easily output Hydra to a variety of log files. For example:
-
-  listeners:
-    - Hydra::Listener::ReportGenerator.new(File.new('/home/ngauthier/Desktop/hydra_log.yml', 'w'))
-
-== More Information
-
-For more information on Hydra, check out the rdocs:
-
-http://rdoc.info/projects/ngauthier/hydra
-
 == Copyright
 
 Copyright (c) 2010 Nick Gauthier. See LICENSE for details.

data/Rakefile

@@ -11,6 +11,8 @@ begin
     gem.homepage = "http://github.com/ngauthier/hydra"
     gem.authors = ["Nick Gauthier"]
     gem.add_development_dependency "shoulda", "= 2.10.3"
+    gem.add_development_dependency "rspec", "= 1.3.0"
+    gem.add_development_dependency "cucumber", "= 0.6.4"
   end
   Jeweler::GemcutterTasks.new
 rescue LoadError

data/VERSION

@@ -1 +1 @@
-0.16.0
+0.16.1

data/hydra.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{hydra}
-  s.version = "0.16.0"
+  s.version = "0.16.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Nick Gauthier"]
-  s.date = %q{2010-04-04}
+  s.date = %q{2010-04-06}
   s.description = %q{Spread your tests over multiple machines to test your code faster.}
   s.email = %q{nick@smartlogicsolutions.com}
   s.extra_rdoc_files = [
@@ -46,6 +46,7 @@ Gem::Specification.new do |s|
      "lib/hydra/pipe.rb",
      "lib/hydra/runner.rb",
      "lib/hydra/safe_fork.rb",
+     "lib/hydra/spec/autorun_override.rb",
      "lib/hydra/spec/hydra_formatter.rb",
      "lib/hydra/ssh.rb",
      "lib/hydra/stdio.rb",
@@ -78,18 +79,18 @@ Gem::Specification.new do |s|
   s.summary = %q{Distributed testing toolkit}
   s.test_files = [
     "test/pipe_test.rb",
-     "test/test_helper.rb",
      "test/ssh_test.rb",
-     "test/message_test.rb",
-     "test/master_test.rb",
-     "test/fixtures/write_file.rb",
-     "test/fixtures/slow.rb",
-     "test/fixtures/write_file_spec.rb",
-     "test/fixtures/features/step_definitions.rb",
-     "test/fixtures/hello_world.rb",
      "test/fixtures/write_file_alternate_spec.rb",
      "test/fixtures/sync_test.rb",
+     "test/fixtures/hello_world.rb",
+     "test/fixtures/features/step_definitions.rb",
      "test/fixtures/assert_true.rb",
+     "test/fixtures/slow.rb",
+     "test/fixtures/write_file_spec.rb",
+     "test/fixtures/write_file.rb",
+     "test/message_test.rb",
+     "test/test_helper.rb",
+     "test/master_test.rb",
      "test/runner_test.rb",
      "test/worker_test.rb"
   ]
@@ -100,11 +101,17 @@ Gem::Specification.new do |s|
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
       s.add_development_dependency(%q<shoulda>, ["= 2.10.3"])
+      s.add_development_dependency(%q<rspec>, ["= 1.3.0"])
+      s.add_development_dependency(%q<cucumber>, ["= 0.6.4"])
     else
       s.add_dependency(%q<shoulda>, ["= 2.10.3"])
+      s.add_dependency(%q<rspec>, ["= 1.3.0"])
+      s.add_dependency(%q<cucumber>, ["= 0.6.4"])
     end
   else
     s.add_dependency(%q<shoulda>, ["= 2.10.3"])
+    s.add_dependency(%q<rspec>, ["= 1.3.0"])
+    s.add_dependency(%q<cucumber>, ["= 0.6.4"])
   end
 end
 

data/lib/hydra/runner.rb

@@ -107,6 +107,8 @@ module Hydra #:nodoc:
       begin
         require 'spec'
         require 'hydra/spec/hydra_formatter'
+        # Ensure we override rspec's at_exit
+        require 'hydra/spec/autorun_override'
       rescue LoadError => ex
         return ex.to_s
       end

data/lib/hydra/spec/autorun_override.rb

@@ -0,0 +1,12 @@
+if defined?(Spec)
+  module Spec
+    module Runner
+      class << self
+        # stop the auto-run at_exit
+        def run
+          return 0
+        end 
+      end
+    end
+  end
+end

data/lib/hydra/spec/hydra_formatter.rb

@@ -1,13 +1,6 @@
-require 'spec/autorun'
 require 'spec/runner/formatter/progress_bar_formatter'
 module Spec
   module Runner
-    class << self
-      # stop the auto-run at_exit
-      def run
-        return 0
-      end 
-    end
     module Formatter
       class HydraFormatter < ProgressBarFormatter
         # Stifle the post-test summary

data/lib/hydra/tasks.rb

@@ -73,7 +73,7 @@ module Hydra #:nodoc:
       yield self if block_given?
 
       # Ensure we override rspec's at_exit
-      require 'hydra/spec/hydra_formatter'
+      require 'hydra/spec/autorun_override'
 
       @config = find_config_file
 

data/test/fixtures/write_file_alternate_spec.rb

@@ -1,4 +1,5 @@
 require 'tmpdir'
+require 'spec'
 context "file writing" do
   it "writes to a file" do
     File.open(File.join(Dir.tmpdir, 'alternate_hydra_test.txt'), 'a') do |f|

data/test/fixtures/write_file_spec.rb

@@ -1,4 +1,5 @@
 require 'tmpdir'
+require 'spec'
 context "file writing" do
   it "writes to a file" do
     File.open(File.join(Dir.tmpdir, 'hydra_test.txt'), 'a') do |f|

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 16
-  - 0
-  version: 0.16.0
+  - 1
+  version: 0.16.1
 platform: ruby
 authors: 
 - Nick Gauthier
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-04 00:00:00 -04:00
+date: 2010-04-06 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -31,6 +31,34 @@ dependencies:
         version: 2.10.3
   type: :development
   version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 4
+        version: 0.6.4
+  type: :development
+  version_requirements: *id003
 description: Spread your tests over multiple machines to test your code faster.
 email: nick@smartlogicsolutions.com
 executables: []
@@ -70,6 +98,7 @@ files:
 - lib/hydra/pipe.rb
 - lib/hydra/runner.rb
 - lib/hydra/safe_fork.rb
+- lib/hydra/spec/autorun_override.rb
 - lib/hydra/spec/hydra_formatter.rb
 - lib/hydra/ssh.rb
 - lib/hydra/stdio.rb
@@ -126,17 +155,17 @@ specification_version: 3
 summary: Distributed testing toolkit
 test_files: 
 - test/pipe_test.rb
-- test/test_helper.rb
 - test/ssh_test.rb
-- test/message_test.rb
-- test/master_test.rb
-- test/fixtures/write_file.rb
-- test/fixtures/slow.rb
-- test/fixtures/write_file_spec.rb
-- test/fixtures/features/step_definitions.rb
-- test/fixtures/hello_world.rb
 - test/fixtures/write_file_alternate_spec.rb
 - test/fixtures/sync_test.rb
+- test/fixtures/hello_world.rb
+- test/fixtures/features/step_definitions.rb
 - test/fixtures/assert_true.rb
+- test/fixtures/slow.rb
+- test/fixtures/write_file_spec.rb
+- test/fixtures/write_file.rb
+- test/message_test.rb
+- test/test_helper.rb
+- test/master_test.rb
 - test/runner_test.rb
 - test/worker_test.rb