load_runner 1.0.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in load_runner.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Don Najd
+
+MIT License
+
+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.md

@@ -0,0 +1,78 @@
+# LoadRunner
+
+![alt text](http://my.stratos.net/~hewston95/RTM45/loderunner.png "Logo Title Text 1")
+
+Take some Ruby Code and pass it to LoadRunner::Queue and you'll be able to
+ * Run the code n number of times in parallel
+ * Rand stagger the execution
+ * Run the code threaded and staggered for a specific amount of time (ex. 5 minutes)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'load_runner'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install load_runner
+
+## Basic Usage
+
+Create a LoadRunner Queue
+
+    q = LoadRunner::Queue.new
+
+pass a block of work for 4 threads
+    
+    q.load(4) do 
+    	puts 'hi'
+    end
+
+run it
+
+	q.run
+
+## Ways to Run a Queue
+
+Run parallel threads
+
+    q.run
+
+Run threads and stagger by rand number between 1-5
+	
+	q.run_and_stagger(5)
+
+Run threads for 2 minutes
+
+	q.run_for_duration(120)
+
+Run threads for 2 minutes and stagger by rand number between 1-5
+
+	q.run_for_duration(120, 5)
+
+
+## Concurrency
+
+To run the threads in a truely concurrent fashion across multiple processors you must:
+ * Add LoadRunner Gem to your GemFile
+ * Then set your project up to use JRuby. 
+
+I use RBEnv so I run the following commands from the project folder:
+
+ 	rbenv install jruby-1.7.3
+ 	rbenv local jruby-1.7.3
+
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/load_runner.rb

@@ -0,0 +1,143 @@
+require "load_runner/version"
+
+module LoadRunner
+
+	class Queue
+		attr_accessor :failures
+		
+		def initialize(logger = nil)
+
+			# logger
+			if logger!=nil
+				@logger = logger
+			end
+
+			# setup
+			@threads = []
+			@transactions = 0
+			@num_threads = 1
+			@failures = 0
+		end
+
+		def load(num_threads=1, &work)
+			@num_threads = num_threads
+			@work = work  # save work for new threads
+
+			# create threads
+			num_threads.times do ||
+
+				# do work
+				create_thread
+
+				# log
+				if @logger!=nil
+	    			@logger.debug "action=create|name=thread"
+	    		end
+		  	end
+		end
+
+		def run()
+			@start_time = Time.now
+			start_all
+			wait_until_finished
+		end
+
+		def run_and_stagger(max_sleep=10)
+			@start_time = Time.now
+			start_all { rand_sleep(max_sleep) }
+			wait_until_finished
+		end
+
+		def run_for_duration(num_seconds, max_sleep=0)
+			@start_time = Time.now	
+
+			# keep them running
+			to_time = Time.now + num_seconds
+
+			# log
+			if @logger!=nil
+				@logger.debug "action=run_for_durration|until=#{to_time}"
+			end
+
+			# duration
+			while (Time.now <= to_time)
+				@threads.each do |t| 
+
+					# restart threads
+					if (t.status=="sleep")
+						rand_sleep(max_sleep)
+						t.run
+					end	
+
+					if (t.status==false or t.status == nil)
+						@transactions += 1
+						@threads.delete t
+						thread = create_thread
+						rand_sleep(max_sleep) 
+						thread.run
+
+						# log
+						if @logger!=nil
+							@logger.debug "thread_count=#{@threads.count}"
+						end
+					end
+				end
+			end
+			wait_until_finished()
+		end
+
+		private
+
+		def create_thread()
+		  	thread = Thread.new do ||
+		  		Thread.stop
+		  		@work.call
+		  	end
+		  	@threads << thread
+		  	return thread
+		end
+
+		def start_all(&block)
+			@threads.each do |t| 
+				
+				# pausing block?
+				block
+
+				# log
+				if @logger!=nil
+					@logger.debug "action=start|name=thread"
+				end
+
+				# run thread
+				t.run
+			end
+		end
+
+		# wait for threads to complete
+		def wait_until_finished()
+			@threads.each do |t| 
+				if (t.status=="run")
+					t.join;  # wait to finish
+
+					# log
+					if @logger!=nil
+						@logger.debug "action=stop|name=thread"
+					end
+				end
+			end
+
+			# log
+			if @logger!=nil
+				@logger.debug "transactions=#{@transactions}|threads=#{@num_threads}|failures=#{@failures}|duration=#{Time.now - @start_time}"
+			end
+		end
+
+		# random sleep
+		def rand_sleep(max_sleep=10)
+			if max_sleep > 0
+				time_to_sleep = rand(0)/max_sleep
+				sleep(time_to_sleep)
+			end
+		end
+	end
+end

data/lib/load_runner/version.rb

@@ -0,0 +1,3 @@
+module LoadRunner
+  VERSION = "1.0.0"
+end

data/load_runner.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'load_runner/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "load_runner"
+  spec.version       = LoadRunner::VERSION
+  spec.authors       = ["Don Najd"]
+  spec.email         = ["dnajd7@gmail.com"]
+  spec.description   = %q{Load Runner Ruby Gem allows you to run a block of code many times in parallel, stagger execution or run it for a specific amount of time}
+  spec.summary       = %q{Run a block of code many times in parallel, stagger execution or run it for a specific amount of time}
+  spec.homepage      = "https://github.com/dnajd/load_runner"
+  spec.license       = "BSD"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: load_runner
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Don Najd
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Load Runner Ruby Gem allows you to run a block of code many times in
+  parallel, stagger execution or run it for a specific amount of time
+email:
+- dnajd7@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/load_runner.rb
+- lib/load_runner/version.rb
+- load_runner.gemspec
+homepage: https://github.com/dnajd/load_runner
+licenses:
+- BSD
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Run a block of code many times in parallel, stagger execution or run it for
+  a specific amount of time
+test_files: []