threadsafe_benchmark 1.0.0

data/Changelog

@@ -0,0 +1,2 @@
+2007-12-12  Sean Soper <sean.soper@revolutionhealth.com>
+ * First release

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Revolution Health Group LLC. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,39 @@
+== Summary
+When testing products such as services which need to be stress tested as much as possible, it's necessary to use multi-threading to get as close to real world usage as possible. To reduce the duplication of code, this plugin utilizes Ruby's built-in Benchmark for the base functionality while preventing the output from clobbering through the use of thread-specific IO buffers.
+
+== Install
+Download the gem or source from http://rubyforge.org/projects/revhealth/
+
+== Dependencies
+None save for Ruby 1.8.x.
+
+== Usage
+Anywhere you need to do multi-threaded testing, just use 'threadsafe_bm' instead of the standard 'bm' call. The method has also been aliased as 'ts_bm'.
+
+== Sample
+require 'rubygems'
+require_gem 'threadsafe_benchmark'
+include ThreadsafeBenchmark
+
+threads = []
+max_num = 5000
+
+5.to_i.times { |i| 
+  threads << Thread.new(max_num) { |n| 
+    threadsafe_bm(6) { |x|
+      x.report("for:")   { for i in 1..n; a = "1"; end }
+      x.report("times:") { n.times do   ; a = "1"; end }
+      x.report("upto:")  { 1.upto(n) do ; a = "1"; end }
+    }
+  }
+}
+
+threads.each { |t| t.join }
+
+== License
+This code is released under the MIT license.
+
+== Support
+The RubyForge page for all RHG-related plugins is http://rubyforge.org/projects/revhealth
+
+You can email the RHG Rails team at rails-trunk@revolutionhealth.com

data/Rakefile

@@ -0,0 +1,43 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+
+dist_dirs = [ "config", "lib", "samples" ]
+
+manifest = YAML.load_file(File.join(File.dirname(__FILE__),"config", "manifest.yml"))
+
+gem_spec = Gem::Specification.new do |s|
+    tiny_ver    = 0
+    s.platform  = Gem::Platform::RUBY
+    s.name      = manifest[:name]
+    s.version   = manifest[:version].join(".") + ".#{tiny_ver}" 
+    s.author    = "RHG Team"
+    s.email     = "rails-trunk@revolution.com"
+    s.summary   = manifest[:description]
+    s.files = [ "Changelog", "MIT-LICENSE", "Rakefile", "README" ]
+    dist_dirs.each do |dir|
+      s.files = s.files + Dir.glob( "#{dir}/**/*" ).delete_if { |item| /(\.[svn|log|db])|(schema\.rb)/ === item }
+    end
+    s.autorequire = s.name
+    s.require_path  =   "lib"
+    s.has_rdoc  =   false
+    s.extra_rdoc_files  =   ["README", "Changelog"]
+    manifest[:dependencies].each do|pkg,version|
+      s.add_dependency(pkg, version)
+    end if manifest[:dependencies]
+end
+    
+gem = Rake::GemPackageTask.new(gem_spec) do |pkg|
+  pkg.need_tar = true
+  pkg.need_zip = true
+end
+
+desc 'Generate documentation for the plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = manifest[:name].gsub(/_/, ' ').capitalize
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/*.rb')
+end

data/config/manifest.yml

@@ -0,0 +1,6 @@
+---
+:version: [1, 0]
+:name: "threadsafe_benchmark"
+:title: "Threadsafe Benchmark"
+:description: "Allows for thread-safe benchmarking"
+:dependencies: 

data/lib/threadsafe_benchmark.rb

@@ -0,0 +1,50 @@
+require 'stringio'
+require 'benchmark'
+
+# == Overview
+#
+# The ThreadsafeBenchmark module provides methods for benchmarking Ruby 
+# code in a thread-safe manner. Use it as you would the standard Benchmark
+# module.
+
+module ThreadsafeBenchmark
+  include Benchmark
+  
+  class Report
+    def initialize(width = 0, fmtstr = nil)
+      @width, @fmtstr = width, fmtstr
+    end
+
+    def item(label = "", *fmt, &blk) # :yield:
+      Thread.current["io"] << label.ljust(@width)
+      res = Benchmark::measure(&blk)
+      Thread.current["io"] << res.format(@fmtstr, *fmt)
+      res
+    end
+
+    alias :report :item
+  end
+
+  def threadsafe_benchmark(caption = "", label_width = nil, fmtstr = nil, *labels)
+    Thread.current["io"] = StringIO.new
+    label_width ||= 0
+    fmtstr ||= Benchmark::FMTSTR
+    raise ArgumentError, "no block" unless iterator?
+    unless Thread.main["caption"]
+      puts caption
+      Thread.main["caption"] = true
+    end
+    results = yield(ThreadsafeBenchmark::Report.new(label_width, fmtstr))
+    Array === results and results.grep(Tms).each {|t|
+      Thread.current["io"] << (labels.shift || t.label || "").ljust(label_width)
+      Thread.current["io"] << t.format(fmtstr)
+    }
+    puts Thread.current["io"].string
+  end
+  alias :ts_benchmark :threadsafe_benchmark
+
+  def threadsafe_bm(label_width = 0, *labels, &blk)
+    threadsafe_benchmark(" "*label_width + Benchmark::CAPTION, label_width, Benchmark::FMTSTR, *labels, &blk)
+  end
+  alias :ts_bm :threadsafe_bm
+end

data/samples/iterations.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/ruby
+
+require File.join(File.dirname(__FILE__), '..', 'lib', 'threadsafe_benchmark')
+include ThreadsafeBenchmark
+
+threads = []
+max_num = 5000
+
+5.to_i.times { |i| 
+  threads << Thread.new(max_num) { |n| 
+    threadsafe_bm(6) { |x|
+      x.report("for:")   { for i in 1..n; a = "1"; end }
+      x.report("times:") { n.times do   ; a = "1"; end }
+      x.report("upto:")  { 1.upto(n) do ; a = "1"; end }
+    }
+  }
+}
+
+threads.each { |t| t.join }

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: threadsafe_benchmark
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+date: 2007-12-13 00:00:00 -05:00
+summary: Allows for thread-safe benchmarking
+require_paths: 
+- lib
+email: rails-trunk@revolution.com
+homepage: 
+rubyforge_project: 
+description: 
+autorequire: threadsafe_benchmark
+default_executable: 
+bindir: bin
+has_rdoc: false
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- RHG Team
+files: 
+- Changelog
+- MIT-LICENSE
+- Rakefile
+- README
+- config/manifest.yml
+- lib/threadsafe_benchmark.rb
+- samples/iterations.rb
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+- Changelog
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+