tlb-testunit18 0.3.2

data/README.markdown

@@ -0,0 +1,46 @@
+## Using tlb.rb:
+
+__tlb.rb__ uses [tlb](https://github.com/test-load-balancer/tlb "TLB") under the hood. It runs a sub-process which talks to the actual tlb-server(or equivallent) to balance and post run-feedback.
+Balancer process is actually an HTTP server which listen to a certain TCP port so tlb-ruby library can talk to it. 
+This is controlled by an environment variable named *'TLB_BALANCER_PORT'*, which can be set to any port number(integer between 1024 to 65535) that is guaranteed to remain un-bound while the build runs.
+
+In addition to this extra environment variable, the usual TLB environment variable setup is required(so the balancer knows things like what partitioning algorithm to use or the type of server it has to talk to etc). 
+Detailed documentation of TLB environment variable configuration is available at [http://test-load-balancer.github.com](http://test-load-balancer.github.com "Tlb Documentation")
+
+__tlb.rb__ supports RSpec(1.x and 2.x), Cucumber and Test::Unit, which are the most widely used testing frameworks in the Ruby world. 
+
+__tlb.rb__ is fully compatible with both Ruby 1.9 and 1.8 across __MRI__ and __JRuby__. However, 1.9 support will be available only version 0.3.2 onwards.
+
+We test __tlb.rb__ on MRI and JRuby, however it should work with other flavours of Ruby(like REE) as well.
+
+## Getting tlb.rb:
+
+__RSpec2__ support(both __1.9__ and __1.8__):
+    $ gem install tlb-rspec2
+
+__Cucumber__ support(both __1.9__ and __1.8__):
+    $ gem install tlb-cucumber
+
+__RSpec1__ support(both __1.9__ and __1.8__):
+    $ gem install tlb-rspec1
+
+__Test::Unit__ support on Ruby __1.9__:(available 0.3.2 onwards)
+    $ gem install tlb-testunit19
+
+__Test::Unit__ support on Ruby __1.8__:(available 0.3.2 onwards)
+    $ gem install tlb-testunit18
+    
+If a version older than 0.3.2, please use 
+    $ gem install tlb-testunit
+for Test::Unit support.
+    
+## Setting it up for your project
+
+Please refer documentation on [http://test-load-balancer.github.com/](http://test-load-balancer.github.com/ "TLB Website") for detailed setup instructions. 
+
+Documentation also explains TLB concepts and customization options in fair amount of detail. We highly recomend going through the TLB documentation.
+
+## Want a feature? Found a bug? 
+
+Post it at [Issue Tracker](http://code.google.com/p/tlb/issues/list "Issue Tracker").
+  

data/testunit/lib/tlb/test_unit/mediator_inflection.rb

@@ -0,0 +1,29 @@
+require 'rubygems'
+require 'tlb'
+require 'tlb/test_unit/test_splitter'
+require 'tlb/test_unit/test_observer'
+require 'test/unit/ui/testrunnermediator'
+
+module Tlb::TestUnit::MediatorInflection
+  def self.included base
+    base.send(:alias_method, :run_suite_without_tlb, :run_suite)
+    base.send(:remove_method, :run_suite)
+    base.send(:include, InstanceMethods)
+
+    base.send(:include, Tlb::TestUnit::TestSplitter)
+    base.send(:include, Tlb::TestUnit::TestObserver)
+  end
+
+  module InstanceMethods
+    def run_suite
+      register_observers
+      prune_suite
+      run_suite_without_tlb
+    end
+  end
+
+end
+
+Test::Unit::UI::TestRunnerMediator.class_eval do
+  include Tlb::TestUnit::MediatorInflection
+end

data/testunit/lib/tlb/test_unit/test_observer.rb

@@ -0,0 +1,37 @@
+require 'tlb'
+require 'tlb/run_data'
+
+module Tlb::TestUnit::TestObserver
+  class TestUnitRunData
+    include Tlb::RunData
+
+    def suite_failed(failure)
+      update_suite_failed(suite_name_for(failure.test_name))
+    end
+
+    def suite_name_for(test_name)
+      test_name.scan(/\((.+)\)$/).flatten.first
+    end
+  end
+
+  def register_observers
+    run_data = TestUnitRunData.new
+
+    add_listener(Test::Unit::TestResult::FAULT) do |fault|
+      run_data.suite_failed(fault)
+    end
+
+    add_listener(Test::Unit::UI::TestRunnerMediator::FINISHED) do |*elapsed_time|
+      run_data.report_all_suite_data
+    end
+
+    add_listener(Test::Unit::TestSuite::STARTED) do |suite_name|
+      run_data.suite_started(suite_name)
+    end
+
+
+    add_listener(Test::Unit::TestSuite::FINISHED) do |suite_name|
+      run_data.update_suite_data(suite_name)
+    end
+  end
+end

data/testunit/lib/tlb/test_unit/test_splitter.rb

@@ -0,0 +1,10 @@
+require 'tlb'
+
+module Tlb::TestUnit::TestSplitter
+  def prune_suite
+    name_suite_map = @suite.tests.inject({}) { |map, test| map[test.name] = test; map }
+    names_to_run = Tlb.balance_and_order(@suite.tests.map { |test| test.name })
+    tests_to_run = names_to_run.inject([]) { |tests, name| tests << name_suite_map[name]; tests }
+    @suite.instance_variable_set('@tests', tests_to_run)
+  end
+end

data/testunit/lib/tlb/test_unit/test_task.rb

@@ -0,0 +1,13 @@
+require 'rake'
+require 'rake/testtask'
+require 'tlb'
+require 'tlb/util'
+
+class Tlb::TestUnit::TestTask < Rake::TestTask
+  def initialize *args
+    super do |this|
+      this.ruby_opts.unshift " -r#{Tlb::Util.quote_path(File.dirname(__FILE__), 'mediator_inflection')} "
+      yield this if block_given?
+    end
+  end
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification 
+name: tlb-testunit18
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.3.2
+platform: ruby
+authors: 
+- Janmejay Singh
+- Pavan KS
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-27 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: tlb-core
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 0.3.2
+  type: :runtime
+  version_requirements: *id002
+description: |
+  TLB-Ruby component that provides support for load balancing tests written using test::unit. This library consumes APIs provided by tlb-core.
+
+email: singh.janmejay@gmail.com;itspanzi@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- testunit/lib/tlb/test_unit/mediator_inflection.rb
+- testunit/lib/tlb/test_unit/test_observer.rb
+- testunit/lib/tlb/test_unit/test_splitter.rb
+- testunit/lib/tlb/test_unit/test_task.rb
+- README.markdown
+homepage: http://github.com/test-load-balancer/tlb.rb
+licenses: []
+
+post_install_message: |
+  =========================================================================
+  Documentation: Detailed configuration documentation can be found at http://test-load-balancer.github.com. Documentation section in this website hosts documentation for every public release.
+  
+  -------------------------------------------------------------------------
+  TLB Setup: You'll need a TLB-Server in your network that is reachable over the network from the machines you use to execute your project's test-suite. Please refer the TLB documentation for details.
+  
+  -------------------------------------------------------------------------
+  Example(s): We maintain a directory of tlb-enabled dummy projects written in different languages using different testing and build frameworks to help new TLB users get started and provide users a working project to refer to while hooking up TLB on their project(s).
+  Each of these projects have a shell script(named run_balanced.sh) that is meant to demonstrate a typical tlb-enabled build(by starting a local tlb server, and executing two partitions that run dummy tests locally). This script also starts its own server(so you do not need to worry about the TLB server for trying it out).
+  We recommend playing with the configuration-variable values being set in the shell-script(s) to understand the effect different values have on load-balancing/reordering behavior.
+  
+  Examples archive is released along-with TLB and is available for download at http://code.google.com/p/tlb/downloads/list.
+  
+  To execute the example project, drop into the example project directory(examples/rspec2_example for instance) and invoke the './run_balanced.sh'.
+  
+  -------------------------------------------------------------------------
+  Issue Tracker: http://code.google.com/p/tlb/issues/list
+  
+  =========================================================================
+
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- testunit/lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - <
+    - !ruby/object:Gem::Version 
+      version: "1.9"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: tlb-rb
+rubygems_version: 1.8.3
+signing_key: 
+specification_version: 3
+summary: tlb-testunit18-0.3.2
+test_files: []
+