the_force 0.0.1

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2010 Symbolforce, LLC
+
+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/Rakefile

@@ -0,0 +1,38 @@
+require 'rake'
+
+include_file_globs = ['README.rdoc', 'LICENSE', 'Rakefile', 'init.rb', '{lib}/**/*']
+exclude_file_globs = []
+
+spec = Gem::Specification.new do |s| 
+  s.name              = "the_force"
+  s.version           = '0.0.1'
+  s.author            = "Ryan Ziegler"
+  s.email             = "info@symbolforce.com"
+  s.homepage          = "http://www.symbolforce.com"
+  s.platform          = Gem::Platform::RUBY
+  s.summary           = "Common code for Symbolforce"
+  s.description       = "Common code for Symbolforce"
+  s.files             = FileList[include_file_globs].to_a - FileList[exclude_file_globs].to_a
+  s.require_path      = "lib"
+  s.test_files        = FileList["test/**/test_*.rb"].to_a
+#  s.has_rdoc          = true
+  s.extra_rdoc_files  = FileList["README*"].to_a
+  s.rdoc_options << '--line-numbers' << '--inline-source'
+end
+
+desc "Generate gemspec for gemcutter"
+task :gemspec => :clean do
+  File.open("#{spec.name}.gemspec", 'w') do |f|
+    f.write spec.to_ruby
+  end
+end
+
+desc 'Clean up files.'
+task :clean do
+  FileUtils.rm "*.gemspec" rescue nil
+  FileUtils.rm "the_force-0.0.1.gem" rescue nil
+end
+
+desc 'Default, do nothing'
+task :default do 
+end

data/init.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__), "lib", "the_force")

data/lib/the_force/keep_trying.rb

@@ -0,0 +1,26 @@
+require 'system_timer'
+
+#CRZ - :exceptions uses is_a? not instance_of?
+module TheForce
+  def self.keep_trying(times = 3, options = {}, &b)
+    options = {:exceptions => [StandardError], :timeout => false}.merge(options)
+    options[:exceptions] = [options[:exceptions]] unless options[:exceptions].is_a? Array
+    options[:exceptions] << Timeout::Error if options[:timeout]
+
+    try = 0;
+    loop do
+      begin
+        try += 1
+        if options[:timeout]
+          SystemTimer.timeout_after(options[:timeout]) do
+            return yield(try)
+          end
+        else
+          return yield(try)
+        end
+      rescue Exception => e
+        raise if (try >= times) or not options[:exceptions].any? {|exception| e.is_a? exception}
+      end
+    end
+  end
+end

data/lib/the_force/thread_pool.rb

@@ -0,0 +1,108 @@
+require 'thread'
+begin
+  require 'fasttread'
+rescue LoadError
+  $stderr.puts "Using the ruby-core thread implementation"
+end
+
+module TheForce
+  class ThreadPool
+    class Worker
+      def initialize(thread_queue)
+        @mutex = Mutex.new
+        @cv = ConditionVariable.new
+        @queue = thread_queue
+        @running = true
+        @thread = Thread.new do
+          @mutex.synchronize do
+            while @running
+              @cv.wait(@mutex)
+              block = get_block
+              if block
+                @mutex.unlock
+                block.call
+                @mutex.lock
+                reset_block
+              end
+              @queue << self
+            end
+          end
+        end
+      end
+
+      def name
+        @thread.inspect
+      end
+
+      def get_block
+        @block
+      end
+
+      def set_block(block)
+        @mutex.synchronize do
+          raise RuntimeError, "Thread already busy." if @block
+          @block = block
+          # Signal the thread in this class, that there's a job to be done
+          @cv.signal
+        end
+      end
+
+      def reset_block
+        @block = nil
+      end
+
+      def busy?
+        @mutex.synchronize { !@block.nil? }
+      end
+
+      def stop
+        @mutex.synchronize do
+          @running = false
+          @cv.signal
+        end
+        @thread.join
+      end
+    end
+
+    attr_accessor :max_size
+
+    def initialize(max_size = 10)
+      @max_size = max_size
+      @queue = Queue.new
+      @workers = []
+    end
+
+    def size
+      @workers.size
+    end
+
+    def busy?
+      @queue.size < @workers.size
+    end
+
+    def shutdown
+      @workers.each { |w| w.stop }
+      @workers = []
+    end
+
+    alias :join :shutdown
+
+    def process(block=nil,&blk)
+      block = blk if block_given?
+      worker = get_worker
+      worker.set_block(block)
+    end
+
+    private
+
+    def get_worker
+      if !@queue.empty? or @workers.size == @max_size
+        return @queue.pop
+      else
+        worker = Worker.new(@queue)
+        @workers << worker
+        worker
+      end
+    end
+  end
+end

data/lib/the_force/timer.rb

@@ -0,0 +1,80 @@
+#CRZ - Have been thinking making this something you mixin...that may solve the binding issue in self.timer...
+#CRZ - or just make Timer a class and you create it and then start/stop etc...multiple timers at once?
+#    - lets wait til I need to do that
+
+###CRZ - just use the benchmark module...this is redundant
+
+module TheForce
+  module Timer
+    @timers = []
+    @timer_depth = 0
+  
+    #CRZ - for mixin; expects just a symbol and list of args
+    #    - helps solve passing symbol problem
+    def timer(*args, &b); 
+      if block_given?
+      	Force::Timer.timer(*args, &b)
+      else
+        Force::Timer.timer args[0] do
+          send(args.shift, *args)
+        end
+      end
+    end
+    def report_timers(*args); Force::Timer.report_timers(*args); end
+  
+    # CRZ - totally not thread coherent, but still useful
+    #     - I wanted to allow you to pass in a symbol which was the method to time...but when I send(symbol) from inside this module, 
+    #       the method loses its binding. for example, a method in another class which you time now wouldnt havent access to its
+    #       instance variables...
+    def self.timer(*args)
+      name = args.shift if args.length > 0
+  
+      puts "TIMER #{name || ""} starting..."
+      @timer_depth += 1
+      start_time = Time.now
+      yield
+      end_time = Time.now
+      @timer_depth -= 1
+      puts "TIMER #{name || ""} ended: #{seconds_to_time(end_time - start_time)} elapsed"
+    
+      @timers << [name || "", (end_time - start_time), @timer_depth]
+    end
+  
+    def self.report_timers
+      puts 
+      puts "-- TIMER REPORT IN ORDER OF timer METHOD *FINISHING*, NOT STARTING --"
+      @timers.each do |x| 
+        puts "#{'  ' * x[2]}#{x[0].to_s.ljust(50-(2*x[2]), " ")} : #{seconds_to_time(x[1])}"
+      end
+      puts
+    end
+
+    ###CRZ - might be nice to metaprogrammize and auto wrap the list of methods
+    #def assign_timer(*methods)
+    #end
+
+    private
+    #CRZ - prints a minimal string of type 1d1h1m1.001s
+    #    - always prints seconds, but won't print other units of time unless they are relevant
+    #    - hard to make this pretty...too many special cases; isn't this built already somewhere?
+    def self.seconds_to_time(secs)
+      units, suffixes, widths = [86400000, 3600000, 60000, 1000, 1], %w(d h m . s), [0,0,0,0,3]
+
+      rest, times = (secs * 1000).to_i, [] #start with millis
+      units.each do |x|
+        times << (rest / x)
+        rest %= x
+      end
+
+      time, started = "", false
+      suffixes.each_with_index do |x, i|
+        next if times[i] == 0 and not started and not i == (suffixes.length - 2)
+      
+        started = true
+        time += times[i].to_s.rjust(widths[i], '0') + x
+      end
+  
+      time
+    end
+  end
+end  

data/lib/the_force.rb

@@ -0,0 +1,3 @@
+require 'the_force/keep_trying'
+require 'the_force/timer'
+require 'the_force/thread_pool'

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+name: the_force
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Ryan Ziegler
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-01-19 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Common code for Symbolforce
+email: info@symbolforce.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- LICENSE
+- Rakefile
+- init.rb
+- lib/the_force/keep_trying.rb
+- lib/the_force/thread_pool.rb
+- lib/the_force/timer.rb
+- lib/the_force.rb
+has_rdoc: true
+homepage: http://www.symbolforce.com
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Common code for Symbolforce
+test_files: []
+