deep_test_pre 2.0

data/CHANGELOG

@@ -0,0 +1,47 @@
+1.2.2 (October 11, 2008)
+
+* Added libs option to DeepTest::TestTask for Rails 2.1 compatibility
+* RSpec 1.1.8  compatibility
+* Require RSpec 1.1.8
+
+1.2.1 (September 25, 2008)
+
+* rspec 1.1.4 compatibility
+* Requires rspec 1.1.4
+
+1.2.0 (March 28, 2008)
+
+* Added capability to run distributed
+* Changed to use straight DRb instead of Rinda (performance)
+* Changed error raised on before/after(:all) to warning
+* Added worker listener to setup mysql database for each worker
+* Run test server in same process
+* Check rspec version when loading rspec support
+* Add support for multiple worker listeners
+
+1.1.4 (March 11, 2008)
+
+* Fixed 2 RSpec pending example bugs
+* Fixed setting spec_opts with DeepTest bug
+* Raise an error if before or after all is defined
+* Added server_port to configuration options
+* Wait for signal from server indicating it is ready on startup
+
+1.1.3 (March 10, 2008)
+
+* Added Support for RSpec
+* Added DeepTest::TestTask#timeout_in_seconds to configure Rinda IO timeouts
+* Added worker_listener to configuration options
+
+1.1.2 (February 9, 2008)
+
+* Fix bug with run_test_suite script not exiting with correct exit code.
+
+1.1.1 (February 9, 2008)
+
+* No longer fork from Rake process.
+
+1.1.0 (December 23, 2007)
+
+* DeepTest::TestTask#processes= is now DeepTest::TestTask#number_of_workers=
+* No longer depend on the Daemons gem, use DeepTest::Warlock instead.

data/README.rdoc

@@ -0,0 +1,199 @@
+= DeepTest
+
+DeepTest enables tests to run in parallel using multiple processes.  Processes
+may spawned locally to take advantage of multiple processors on a single
+machine or distributed across many machines to take advantage of distributed
+processing.
+
+== Note
+
+This README has been updated to reflect changes made on the master branch that have
+not yet been released.  If you are looking for the README for DeepTest 1.2 it is
+availeble on the 1.2.x branch on github.
+
+== Usage
+
+In your Rakefile:
+
+  require "rubygems"
+  require "deep_test/rake_tasks"
+  
+  # sample DeepTest task
+
+  DeepTest::TestTask.new "task_name" do |t|
+    t.number_of_agents = 2   # optional, defaults to number of cores
+    t.pattern = "test/**/*_test.rb"
+    t.libs << "test" # may be necessary for Rails >= 2.1.x
+  end
+
+  # sample SpecTask using DeepTest
+
+  Spec::Rake::SpecTask.new(:deep_spec) do |t|
+    t.spec_files = FileList['spec/**/*_spec.rb']
+    t.deep_test :number_of_agents => 2   # optional, defaults to number of cores
+  end
+
+
+=== Specifying a Listener to be Notified of Events
+
+In my_listener.rb
+  class MyListener
+    def before_sync
+    end
+
+    def before_starting_agents
+    end
+
+    def starting(agent)
+    end
+
+    def starting_work(agent, work_unit)
+    end
+
+    def finished_work(agent, work_unit, result)
+    end
+  end
+
+In your Rakefile
+
+  DeepTest::TestTask.new "task_name" do |t|
+    ... 
+    t.listener = "MyListener"
+  end
+
+An instance of MyListener will be created for each agent that is
+started, and will receive events from that agent.  However, you must ensure
+that the MyListener class is loaded at the time that the test files are
+loaded, so it is available to be instantiated.  You can specify multiple
+listener classes by separating them with a comma.  For more information about
+when events are triggered, see the documentation at
+DeepTest::NullListener.
+
+
+=== Setting Up A New Database For Each Agent
+
+By default, DeepTest will reinitialize ActiveRecord connections if ActiveRecord
+is loaded when the agents are started.  This means all agents are running
+against the same database.  You may want each agent to use a database
+decidicated to it.  To facilitate this, DeepTest provides a agent listener to
+help you.  If you're using Rails with Mysql, simply configure DeepTest as 
+follows in your Rakefile:
+
+  DeepTest::TestTask.new "task_name" do |t|
+    ...
+    t.listener = "DeepTest::Database::MysqlSetupListener"
+  end
+
+
+Before spawning agents, DeepTest will dump the schema of the database for the
+current Rails environment (usually test).  As each agent starts up, the
+listener will create a database dedicated to that agent and load the schema
+into it.  The database will be dropped when the agent process exits.  
+
+If you're using Mysql but not using Rails, you'll have to create a subclass of
+MysqlSetupListener and override +master_database_config+ and +dump_file_name+,
+as the default implementations of these methods are Rails specific.
+
+
+If you're using a database other than Mysql, read the documentation for
+DeepTest::Database::SetupListener and create a new subclass for your database
+type.  If you do this, please consider contributing your subclass back to the
+project so that it can be included in later releases of DeepTest.
+
+=== Distributing Tests Across Multiple Machines
+
+In addition to running your tests in parallel, DeepTest can also distribute
+them across multiple machines.  It does this by first mirroring the local
+working copy that launched the tests on each machine that will be running tests.
+Then agents are launched on each of the machines and consume tests in the same
+fashion as when DeepTest is running locally.
+
+==== Requirements
+
+Before you can distribute tests, you must ensure that all the machines involved
+(including the machine with the local working copy) have rsync installed for
+mirroring working copies.  You must also have either SSH or an RSync daemon
+exposing your local working copy running on the local development machine.  For
+more information about rsync, visit the rsync
+webpage[http://www.samba.org/rsync/].  Currently only passwordless access is
+supported, so you must either setup your RSync daemon to be accessible without
+a password or enable passwordless SSH access from the test machines to the
+local development machine. DeepTest must also be installed as a gem on each
+test machine and available either as a gem or in your project on the local
+machine.
+
+==== Configuring Your Project
+
+There is no need to start a special daemon process on the machines that will
+be used to run DeepTest.  Simply specify the names of the hosts that you
+would like DeepTest to distribute to along with a set of sync_options telling
+it how to to rsync the project code.
+
+If you're using rsync over ssh, create a DeepTest test task similar to that
+below in your Rakefile.
+
+  DeepTest::TestTask.new "deep_test_distributed" do |t|
+    t.pattern = "test/**/*_test.rb" # whatever is appropriate for your project
+    t.distributed_hosts = %w[host1 host2]
+    t.sync_options = {
+      :source => <absolute path of project root on machine>,
+      :username => "username",
+      :remote_base_dir => <absolute path to keep working copies in on remote machine> # defaults to /tmp
+    }
+  end
+
+The :source entry in sync_options can be easily calculated based on the value
+of \_\_FILE__ when defining the task.  :username will be used by rsync to ssh
+back to the local machine and mirror the working copy.
+
+If you have an rsync daemon running in your local machine, configure the
+rake task as follows.
+
+  DeepTest::TestTask.new "deep_test_distributed" do |t|
+    t.pattern = "test/**/*_test.rb" # whatever is appropriate for your project
+    t.distributed_hosts = %w[host1 host2]
+    t.sync_options = {
+      :source => <name of rsync module from daemon configuration>,
+      :daemon => true,
+      :username => "username"
+    }
+  end
+
+Username is optional in both cases.  You'll need to either setup passwordless
+ssh access or run an rsync daemon that doesn't require passwords.
+
+There may be other options you'd like to pass to rsync in your particular
+scenario.  This can be done by adding an :rsync_options entry to sync_options.
+For example, if you're working on a Rails project you'll probably want to at
+least have something like this:
+
+  DeepTest::TestTask.new "deep_test_distributed" do |t|
+    ...
+    excludes = %w[.svn tmp/** log/**]
+    t.sync_options = {
+      ...
+      :rsync_options => excludes.map {|s| "'--exclude=#{s}'"}.join(' ')
+    }
+  end
+
+That way you can avoid spending any time mirroring tmp and log files that don't
+have any effect on the tests.  If you are running distributed tests against a
+database, consult the section above about creating a new database for each
+agent to see how to configure DeepTest for your project.  
+
+Any number of projects can be run using the same test servers, as long as
+they're all using the same version of Ruby and DeepTest.  
+
+== Contributors
+
+* anonymous z
+* Alex Chaffee
+* Dan[http://www.dcmanges.com/blog] Manges[http://www.dcmanges.com/blog]
+* David[http://davidvollbracht.com/] Vollbracht[http://davidvollbracht.com/]
+* Brian[http://blog.brianguthrie.com/] Guthrie[http://blog.brianguthrie.com/]
+* Shane[http://shanel.tumblr.com/] Liebling[http://shanel.tumblr.com/]
+* Scott Taylor
+
+== License
+
+DeepTest Released under Ruby's[http://www.ruby-lang.org/en/LICENSE.txt] license[http://www.ruby-lang.org/en/LICENSE.txt]

data/Rakefile

@@ -0,0 +1,137 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rake/contrib/sshpublisher'
+require 'yaml'
+
+require 'rubygems'
+gem('rspec', ENV['RSPEC_VERSION'] || '1.1.12')
+require 'spec/rake/spectask'
+
+$LOAD_PATH << File.dirname(__FILE__) + "/lib"
+
+require "deep_test/rake_tasks"
+
+task :default => %w[
+  test 
+  spec 
+  deep_test
+  deep_spec_1.1.12
+
+]
+
+#deep_spec_1.1.8
+#  distributed_test
+#  distributed_spec
+#  negative_acceptance_tests
+#  test_rails_project
+
+task :pc => :default
+
+Rake::TestTask.new do |t|
+  t.pattern = "test/**/*_test.rb"
+  t.libs += ['test', 'lib']
+end
+
+DeepTest::TestTask.new :deep_test do |t|
+  t.pattern = "test/**/*_test.rb"
+end
+
+DeepTest::TestTask.new(:manual_distributed_test) do |t|
+  t.pattern = "test/**/*_test.rb"
+  t.distributed_hosts = (ENV['HOSTS'] || '').split(' ')
+  t.sync_options = {:source => File.dirname(__FILE__), 
+                    :username => ENV['USERNAME'],
+                    :rsync_options => "--exclude=.svn"}
+end
+
+DeepTest::TestTask.new(:distributed_test) do |t|
+  t.pattern = "test/**/*_test.rb"
+  t.distributed_hosts = %w[localhost]
+  t.sync_options = {:source => File.dirname(__FILE__), 
+                    :rsync_options => "--exclude=.svn",
+                    :remote_base_dir => "/tmp/deep_test"}
+end
+
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:deep_spec) do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.deep_test({})
+end
+
+task :'deep_spec_1.1.8' do 
+  sh 'rake deep_spec RSPEC_VERSION=1.1.8'
+end
+
+task :'deep_spec_1.1.12' do
+  sh 'rake deep_spec RSPEC_VERSION=1.1.12'
+end
+
+Spec::Rake::SpecTask.new(:distributed_spec) do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.deep_test :distributed_hosts => %w[localhost],
+              :sync_options => {:source => File.dirname(__FILE__), 
+                                :rsync_options => "--exclude=.svn"}
+end
+
+Rake::TestTask.new(:negative_acceptance_tests) do |t|
+  t.pattern = "negative_acceptance_tests/tests.rb"
+end
+
+Rake::TestTask.new(:test_rails_project) do |t|
+  t.pattern = "sample_rails_project/deep_test.rb"
+end
+
+desc "Generate documentation"
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = "doc"
+  rdoc.title    = "DeepTest"
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include(
+    'README.rdoc', 
+    'CHANGELOG', 
+    'lib/deep_test/null_listener.rb',
+    'lib/deep_test/database/*.rb'
+  )
+end
+
+desc "Upload RDoc to RubyForge"
+task :publish_rdoc => [:rerdoc] do
+  rubyforge_config = "#{ENV['HOME']}/.rubyforge/user-config.yml"
+  username = YAML.load_file(rubyforge_config)["username"]
+  sh "chmod -R 775 doc"
+  sh "scp -rqp doc/* #{username}@rubyforge.org:/var/www/gforge-projects/deep-test"
+end
+
+specification = Gem::Specification.new do |s|
+  s.platform = Gem::Platform::RUBY
+	s.name   = "deep_test_pre"
+  s.summary = "DeepTest runs tests in multiple processes."
+	s.version = "2.0"
+	s.author = "anonymous z, Dan Manges, David Vollbracht"
+	s.description = s.summary
+	s.email = "daniel.manges@gmail.com"
+  s.homepage = "http://deep-test.rubyforge.org"
+  s.rubyforge_project = "deep-test"
+
+  s.has_rdoc = true
+  s.extra_rdoc_files = ['README.rdoc', 'CHANGELOG']
+  s.rdoc_options << '--title' << "DeepTest" << '--main' << 'README.rdoc' << '--line-numbers'
+
+  s.files = FileList['{lib,test}/**/*.{rb,rake}', 'README.rdoc', 'CHANGELOG', 'Rakefile'].to_a
+end
+
+Rake::GemPackageTask.new(specification) do |package|
+  package.need_zip = true
+  package.need_tar = true
+end
+
+Rake::Task[:gem].prerequisites.unshift :default
+
+task :tar do
+  system "tar zcf pkg/deep_test.tar.gz --exclude=.svn --exclude='*.tar.gz' --exclude='*.gem' --directory=.. deep_test"
+end

data/lib/deep_test.rb

@@ -0,0 +1,78 @@
+module DeepTest
+  class << self
+    def logger
+      @logger ||= DeepTest::Logger.new($stdout)
+    end
+
+    def logger=(logger)
+      @logger = logger
+    end
+  end  
+
+  class IncompleteTestRunError < StandardError
+    def initialize(count)
+      super "#{count} tests were not run because the DeepTest Agents died"
+    end
+
+    def backtrace
+      []
+    end
+  end
+end
+
+require "logger"
+require "timeout"
+require "thread"
+require "socket"
+require "webrick"
+require "timeout"
+require "base64"
+
+require File.dirname(__FILE__) + "/telegraph"
+require File.dirname(__FILE__) + "/deep_test/lib_root"
+require File.dirname(__FILE__) + "/deep_test/extensions/object_extension"
+
+require File.dirname(__FILE__) + "/deep_test/demon"
+require File.dirname(__FILE__) + "/deep_test/deadlock_detector"
+require File.dirname(__FILE__) + "/deep_test/local_deployment"
+require File.dirname(__FILE__) + "/deep_test/logger"
+
+require File.dirname(__FILE__) + "/deep_test/marshallable_exception_wrapper"
+require File.dirname(__FILE__) + "/deep_test/null_listener"
+require File.dirname(__FILE__) + "/deep_test/listener_list"
+require File.dirname(__FILE__) + "/deep_test/cpu_info"
+require File.dirname(__FILE__) + "/deep_test/failure_message"
+require File.dirname(__FILE__) + "/deep_test/options"
+require File.dirname(__FILE__) + "/deep_test/main"
+require File.dirname(__FILE__) + "/deep_test/result_reader"
+require File.dirname(__FILE__) + "/deep_test/rspec_detector"
+require File.dirname(__FILE__) + "/deep_test/central_command"
+require File.dirname(__FILE__) + "/deep_test/proxy_io"
+require File.dirname(__FILE__) + "/deep_test/test_task"
+require File.dirname(__FILE__) + "/deep_test/agent"
+require File.dirname(__FILE__) + "/deep_test/warlock"
+
+require File.dirname(__FILE__) + "/deep_test/database/setup_listener"
+require File.dirname(__FILE__) + "/deep_test/database/mysql_setup_listener"
+
+require File.dirname(__FILE__) + "/deep_test/distributed/shell_environment"
+require File.dirname(__FILE__) + "/deep_test/distributed/landing_ship"
+require File.dirname(__FILE__) + "/deep_test/distributed/dispatch_controller"
+require File.dirname(__FILE__) + "/deep_test/distributed/ssh_client_connection_info"
+require File.dirname(__FILE__) + "/deep_test/distributed/filename_resolver"
+require File.dirname(__FILE__) + "/deep_test/distributed/landing_fleet"
+require File.dirname(__FILE__) + "/deep_test/distributed/remote_deployment"
+require File.dirname(__FILE__) + "/deep_test/distributed/beachhead"
+require File.dirname(__FILE__) + "/deep_test/distributed/rsync"
+
+require File.dirname(__FILE__) + "/deep_test/metrics/data"
+require File.dirname(__FILE__) + "/deep_test/metrics/measurement"
+
+DeepTest::RSpecDetector.if_rspec_available do
+  require File.dirname(__FILE__) + "/deep_test/spec"
+end
+require File.dirname(__FILE__) + "/deep_test/test"
+
+require File.dirname(__FILE__) + "/deep_test/ui/console"
+require File.dirname(__FILE__) + "/deep_test/ui/null"
+