tlb-rspec2 0.1.1 → 0.3.0

data/.emacs_project

@@ -1 +1,7 @@
-(setq rspec-executable "rspec")
+(setq rspec-executable "rspec")
+(setenv "GEM_HOME" "/home/janmejay/.rvm/gems/ruby-1.8.7-head@vanilla")
+(setenv "GEM_PATH" "/home/janmejay/.rvm/gems/ruby-1.8.7-head@vanilla:/home/janmejay/.rvm/gems/ruby-1.8.7-head@global")
+(let ((gem-bin "/home/janmejay/.rvm/gems/ruby-1.8.7-head@vanilla/bin")
+      (path (getenv "PATH")))
+  (unless (string-match-p  gem-bin path)
+    (setenv "PATH" (concat gem-bin ":" path))))

data/.gitignore

@@ -1,4 +1,6 @@
 TAGS
 tmp
 tlb_store
-tlb-all*.jar
+tlb-*.jar
+.yardoc
+doc

data/README.markdown

@@ -1,33 +1,66 @@
 ## Using tlb_rb:
 
-tlb_rb uses [tlb](https://github.com/test-load-balancer/tlb "TLB") under the hood. It runs a sub-process(java process) which talks to the actual tlb-server(or equivallent) to balance and post run-feedback.
-Balancer process is actually an HTTP server which needs to listen to a certain TCP port so that tlb-ruby implementation can talk to it. 
+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 what server to talk to). 
-Detailed documentation of TLB environment variable configuration is available at [https://github.com/test-load-balancer/tlb/wiki/Configuration-Variables](https://github.com/test-load-balancer/tlb/wiki/Configuration-Variables "Tlb config reference")
+Detailed documentation of TLB environment variable configuration is available at [http://test-load-balancer.github.com](http://test-load-balancer.github.com "Tlb Documentation")
 
-As of now, rspec is the only test framework that tlb_rb supports. We plan to add support for other ruby-testing-frameworks soon.
+As of now, tlb.rb supports RSpec(1.x and 2.x) and Test::Unit, which are the two most widely used testing frameworks in Ruby. We plan to add support for other ruby-testing-frameworks soon.
 
 ## Setting it up for your project
 
 Please refer the [sample_projects](http://github.com/test-load-balancer/sample_projects "Tlb setup examples") to see the details of how to set it up.
 
 Usually, something equivallent of this in one of your Rake files should suffice:
-
-    PATH_TO_TLB = File.join(RAILS_ROOT, 'vendor', 'plugins', 'tlb_rb', 'lib', 'tlb')
-    require PATH_TO_TLB
-    require File.join(PATH_TO_TLB, 'spec_task')
-  
+__RSpec-1.x__:    
+    require 'rubygems'
+    gem 'tlb-rspec1'
+    require 'tlb/spec_task'
+    
     Tlb::SpecTask.new(:balanced_specs) do |t|
       t.spec_files = FileList['spec/**/*_spec.rb']
-      t.spec_opts << "--require #{PATH_TO_TLB},#{File.join(PATH_TO_TLB, 'spec_formatter')} --format 'Tlb::SpecFormatter:/dev/null' --format nested"
+      t.spec_opts << "--format progress"
     end
-  
-    desc "load balanced spec"
-    task :run_balanced => ['tlb:start', :balanced_specs]
-  
-Where run_balanced is the task you invoke at the top-level(invoked externally).
+    
+    load 'tasks/tlb.rake'
+    desc "run specs load-balanced(based on environment variables)"
+    task :bal => ['tlb:start', :balanced_specs]
 
-## RSpec version compatibility
-  The branch '__master__' is __RSpec-2.x__ compatible. If you use __RSpec-1__(i.e. __1.3.x__ etc, please use branch named '__rspec-1__'. If you come across any bugs with eiher RSpec-2 or 1 support, please post it as an bug on the issue tracker on github project page.
+__RSpec-2.x__:
+    require 'rubygems'
+    gem 'tlb-rspec2'
+    require 'tlb/rspec/spec_task'
+    
+    Tlb::RSpec::SpecTask.new(:run_balanced) do |t|
+      t.pattern = 'spec/**/*_spec.rb'
+    end
+    
+    load 'tasks/tlb.rake'
+    desc "run specs load-balanced(based on environment variables)"
+    task :bal => ['tlb:start', :run_balanced]
+
+__Test::Unit__:
+    require 'rake'
+    require 'rubygems'
+    gem 'tlb-testunit'
+    require 'tlb/test_unit/test_task'
+    
+    Tlb::TestUnit::TestTask.new(:test_balanced) do |t|
+      t.libs << "test"
+      t.test_files = FileList['test/**/*_test.rb']
+      t.verbose = true
+    end
+    
+    load 'tasks/tlb.rake'
+    
+    task :bal => ['tlb:start', :test_balanced]
+      
+Where __bal__ is the task you invoke at the top-level(invoked externally).
+
+## RSpec source-control and release-version/environment compatibility
+  The branch '__master__' supports __Test::Unit__ and __RSpec-2.x__. If you use __RSpec-1__(i.e. __1.3.x__ etc), please use the branch named '__rspec-1__'. 
+  Having said that, we encourage end-users to use the released gem versions insteed of using upstream snapshot. Detailed documentation for every released version is available at http://test-load-balancer.github.com.
+  Please post any issues on our [Issue Tracker](http://code.google.com/p/tlb/issues/list "Issue Tracker").
+  

data/Rakefile

@@ -14,9 +14,10 @@ namespace :test do
 end
 
 task :build_tlb do
-  Dir.glob("tlb-all*.jar").each { |jar| FileUtils.rm(jar) }
-  sh 'ant -f tlb/build.xml package'
-  Dir.glob('tlb/target/tlb-all*').each { |file| FileUtils.copy(file, ".") }
+  [Dir.glob("tlb-alien*.jar"), Dir.glob("tlb-server*.jar")].flatten.each { |jar| FileUtils.rm(jar) }
+  sh '(cd tlb && ant clean package -Doffline=t)'
+  Dir.glob('tlb/target/tlb-alien*').each { |file| FileUtils.copy(file, ".") }
+  Dir.glob('tlb/target/tlb-server*').each { |file| FileUtils.copy(file, "tests/") }
 end
 
 task :package do

data/gem_common.rb

@@ -5,21 +5,29 @@ TAG_VERSION = `git describe --abbrev=0`.gsub(/^v/, '')
 CODE_VERSION = `git describe --always`
 AUTHORS = ["Janmejay Singh", "Pavan KS"]
 EMAIL = "singh.janmejay@gmail.com;itspanzi@gmail.com"
-HOME_PAGE = "http://github.com/test-load-balancer/tlb_rb"
+HOME_PAGE = "http://github.com/test-load-balancer/tlb.rb"
 SUMMARY = "#{$name}-#{CODE_VERSION}"
 DESC = <<END
 TLB ruby implementation base, which provides support for load balancing tests written in #{$framework}.
-TLB_rb test suite is not bundled, please check http://github.com/test-load-balancer/tlb_rb for tests.
-Detailed configuration documentation can be found at https://github.com/test-load-balancer/tlb/wiki.
+TLB.rb test suite is not bundled, please check http://github.com/test-load-balancer/tlb.rb for tests.
+Detailed documentation is available at http://test-load-balancer.github.com.
 END
 POST_INSTALL_MESSAGE = <<END
 -------------------------------------------------------------------------
-Documentation: Detailed configuration documentation can be found at https://github.com/test-load-balancer/tlb/wiki.
------------------------------
-Example: https://github.com/test-load-balancer/sample_projects has examples projects and shell script to demonstrate a typical build(by starting a local tlb server, and executing two partitions locally). While partitions in these examples execute one after another, in an actual CI/pre-checkin build, they will actually run parallely on different machines.
-Its a good idea to play with the environment variables values being used in these shell-scripts to understand how they affect TLB's behaviour. You may want to check https://github.com/test-load-balancer/tlb/wiki/Configuration-Variables, which documents each variable and its effect.
------------------------------
-Issue tracker: Please report bugs/enhancements/feature-requests at http://code.google.com/p/tlb/issues/list. Github, Rubyforge or any other issue trackers are not monitored or updated.
+TLB 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 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 people 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).
+For demonstration purpose, aforementioned shell script executes partitions in the example-project one after another(serially). However, partitions will be executed parallely on different machines in a real-world setup(hence cutting the build time).
+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. You may want to check http://test-load-balancer.github.com, which links to 'detailed documentation' that covers each configuration variable and explains its purpose, effect and implication.
+
+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'.
+
+-------------------------------------------------------------------------
+TLB Issue Tracker: Please report/port bugs/enhancements/feature-requests on http://code.google.com/p/tlb/issues/list. Github, Rubyforge or any other issue trackers are not monitored or updated.
+
 -------------------------------------------------------------------------
 END
 RUBYFORGE_PROJECT = "tlb-rb"

data/lib/tlb.rb

@@ -99,7 +99,7 @@ module Tlb
   end
 
   def self.tlb_jar
-    File.expand_path(Dir.glob(File.join(root_dir, "tlb-all*")).first)
+    File.expand_path(Dir.glob(File.join(root_dir, "tlb-alien*")).first)
   end
 
   def self.server_command
@@ -113,7 +113,7 @@ module Tlb
   end
 
   def self.start_server
-    ENV[TLB_APP] = 'com.github.tlb.balancer.BalancerInitializer'
+    ENV[TLB_APP] = 'tlb.balancer.BalancerInitializer'
     @pid, input, out, err = Open4.popen4(server_command)
     @out_pumper = stream_pumper_for(out, TLB_OUT_FILE)
     @err_pumper = stream_pumper_for(err, TLB_ERR_FILE)

data/lib/tlb/rspec/reporter_inflection.rb

@@ -1,4 +1,5 @@
 require 'rspec/core/reporter'
+require File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'tlb'))
 require 'tlb/rspec/spec_formatter'
 
 module Tlb::RSpec::ReporterInflection

data/lib/tlb/rspec/spec_formatter.rb

@@ -1,4 +1,5 @@
 require 'rspec/core/formatters/base_formatter'
+require File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'tlb'))
 require 'tlb/run_data'
 require 'stringio'
 

data/lib/tlb/rspec/spec_task.rb

@@ -1,12 +1,13 @@
 require 'rspec/core/rake_task'
+require File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'tlb'))
+require 'tlb/util'
 
 class Tlb::RSpec::SpecTask < RSpec::Core::RakeTask
   def initialize *args
-    path_to_tlb = File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'tlb'))
     super do |this|
       yield this if block_given?
       this.rspec_opts ||= ''
-      this.rspec_opts = " --require #{path_to_tlb} --require tlb/rspec/reporter_inflection " + this.rspec_opts
+      this.rspec_opts = " --require #{Tlb::Util.quote_path(File.dirname(__FILE__), 'reporter_inflection')} " + this.rspec_opts
     end
   end
 

data/lib/tlb/run_data.rb

@@ -1,3 +1,5 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'tlb'))
+
 module Tlb::RunData
   class Suite < Struct.new(:identity, :start_time, :end_time, :failed)
     MILLS_PER_SEC = 1000

data/lib/tlb/util.rb

@@ -0,0 +1,11 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'tlb'))
+
+module Tlb::Util
+  def self.quote_path *fragments
+    single_quote(File.expand_path(File.join(*fragments)))
+  end
+
+  def self.single_quote arg
+    "'#{arg.gsub(/'/, "\\'")}'"
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: tlb-rspec2
 version: !ruby/object:Gem::Version 
-  hash: 25
-  prerelease: false
+  hash: 19
+  prerelease: 
   segments: 
   - 0
-  - 1
-  - 1
-  version: 0.1.1
+  - 3
+  - 0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Janmejay Singh
@@ -16,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-12-22 00:00:00 +05:30
+date: 2011-03-05 00:00:00 +05:30
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -67,8 +67,8 @@ dependencies:
   version_requirements: *id003
 description: |
   TLB ruby implementation base, which provides support for load balancing tests written in rspec-2.x.
-  TLB_rb test suite is not bundled, please check http://github.com/test-load-balancer/tlb_rb for tests.
-  Detailed configuration documentation can be found at https://github.com/test-load-balancer/tlb/wiki.
+  TLB.rb test suite is not bundled, please check http://github.com/test-load-balancer/tlb.rb for tests.
+  Detailed documentation is available at http://test-load-balancer.github.com.
 
 email: singh.janmejay@gmail.com;itspanzi@gmail.com
 executables: []
@@ -90,21 +90,30 @@ files:
 - lib/tlb/rspec/spec_formatter.rb
 - lib/tlb/rspec/spec_task.rb
 - lib/tlb/run_data.rb
+- lib/tlb/util.rb
 - tlb-rspec2.gemspec
 - tlb-testunit.gemspec
-- tlb-all-gv0.2-9-g1f1a4aa.jar
+- tlb-alien-g0.3.0.jar
 has_rdoc: true
-homepage: http://github.com/test-load-balancer/tlb_rb
+homepage: http://github.com/test-load-balancer/tlb.rb
 licenses: []
 
 post_install_message: |
   -------------------------------------------------------------------------
-  Documentation: Detailed configuration documentation can be found at https://github.com/test-load-balancer/tlb/wiki.
-  -----------------------------
-  Example: https://github.com/test-load-balancer/sample_projects has examples projects and shell script to demonstrate a typical build(by starting a local tlb server, and executing two partitions locally). While partitions in these examples execute one after another, in an actual CI/pre-checkin build, they will actually run parallely on different machines.
-  Its a good idea to play with the environment variables values being used in these shell-scripts to understand how they affect TLB's behaviour. You may want to check https://github.com/test-load-balancer/tlb/wiki/Configuration-Variables, which documents each variable and its effect.
-  -----------------------------
-  Issue tracker: Please report bugs/enhancements/feature-requests at http://code.google.com/p/tlb/issues/list. Github, Rubyforge or any other issue trackers are not monitored or updated.
+  TLB 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 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 people 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).
+  For demonstration purpose, aforementioned shell script executes partitions in the example-project one after another(serially). However, partitions will be executed parallely on different machines in a real-world setup(hence cutting the build time).
+  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. You may want to check http://test-load-balancer.github.com, which links to 'detailed documentation' that covers each configuration variable and explains its purpose, effect and implication.
+  
+  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'.
+  
+  -------------------------------------------------------------------------
+  TLB Issue Tracker: Please report/port bugs/enhancements/feature-requests on http://code.google.com/p/tlb/issues/list. Github, Rubyforge or any other issue trackers are not monitored or updated.
+  
   -------------------------------------------------------------------------
 
 rdoc_options: 
@@ -132,9 +141,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: tlb-rb
-rubygems_version: 1.3.7
+rubygems_version: 1.5.2
 signing_key: 
 specification_version: 3
-summary: tlb-rspec2-0.1.1
+summary: tlb-rspec2-0.3.0
 test_files: []