mperham-politics 0.2.0 → 0.2.4

data/History.rdoc

@@ -1,6 +1,24 @@
 = Changelog
 
-== 0.2.0 (2008-10-??)
+== 0.2.4 (2009-01-28)
+
+* Reduce leader token expiration time to discourage a get/set race condition. (Brian Dainton)
+
+== 0.2.3 (2009-01-12)
+
+* Fix invalid result check in previous change. (Brian Dainton)
+
+== 0.2.2 (2009-01-07)
+
+* Fix invalid leader? logic in TokenWorker which could allow
+  two workers to become leader at the same time. (Brian Dainton)
+
+== 0.2.1 (2008-11-04)
+
+* Cleanup and prepare for public release for RubyConf 2008.
+* Election Day.  Politics.  Get it?  Hee hee.
+
+== 0.2.0 (2008-10-24)
 
 * Remove BucketWorker based on initial feedback.  Add StaticQueueWorker as a more reliable replacement.
 

data/README.rdoc

@@ -21,7 +21,11 @@ toes?  There are several answers:
 1. Elect a leader for a short period of time.  The leader is the process which performs the
    actual processing.  After a length of time, a new leader is elected from the group.  This
    is fault tolerant but not as scalable, as only one process is performing the task at a given
-   point in time.  See the +TokenWorker+ and +PaxosMember+ mixins.
+   point in time.  See the +TokenWorker+ mixin.
+
+== Installation
+
+  sudo gem install mperham-politics -s http://gems.github.com
 
 == Dependencies
 
@@ -39,6 +43,7 @@ TokenWorker mixin
 Name::      Mike Perham
 Email::     mailto:mperham@gmail.com
 Twitter::   http://twitter.com/mperham
+Homepage::  http://mikeperham.com/
 
 This software is free for you to use as you'd like.  If you find it useful, please consider giving 
 me a recommendation at {Working with Rails}[http://workingwithrails.com/person/10797-mike-perham].

data/examples/queue_worker_example.rb

@@ -0,0 +1,37 @@
+#gem 'mperham-politics'
+require 'politics'
+require 'politics/static_queue_worker'
+
+# Test this example by starting memcached locally and then in two irb sessions, run this:
+#
+=begin
+ require 'queue_worker_example'
+ p = Politics::QueueWorkerExample.new
+ p.start
+=end
+#
+# You can then watch as one of them is elected leader.  You can kill the leader and verify
+# the backup process is elected after approximately iteration_length seconds.
+#
+module Politics
+  class QueueWorkerExample
+    include Politics::StaticQueueWorker
+    TOTAL_BUCKETS = 20
+
+    def initialize
+      register_worker 'queue-example', TOTAL_BUCKETS, :iteration_length => 60, :servers => memcached_servers
+    end
+    
+    def start
+      process_bucket do |bucket|
+        puts "PID #{$$} processing bucket #{bucket}/#{TOTAL_BUCKETS} at #{Time.now}..."
+        sleep 1.5
+      end
+    end
+    
+    def memcached_servers
+      ['127.0.0.1:11211']
+    end
+
+  end
+end

data/examples/token_worker_example.rb

@@ -4,15 +4,15 @@ require 'politics/token_worker'
 
 # Test this example by starting memcached locally and then in two irb sessions, run this:
 #
-#
-# You can then watch as one of them is elected leader.  You can kill the leader and verify
-# the backup process is elected after approximately iteration_length seconds.
-#
 =begin
  require 'token_worker_example'
  p = Politics::TokenWorkerExample.new
  p.start
 =end
+#
+# You can then watch as one of them is elected leader.  You can kill the leader and verify
+# the backup process is elected after approximately iteration_length seconds.
+#
 module Politics
   class TokenWorkerExample
     include Politics::TokenWorker

data/lib/politics/static_queue_worker.rb

@@ -1,4 +1,3 @@
-puts 'hello'
 require 'socket'
 require 'ipaddr'
 require 'uri'
@@ -235,12 +234,12 @@ module Politics
       handle = Net::DNS::MDNSSD.register("#{self.group_name}-#{local_ip}-#{$$}", 
           "_#{group_name}._tcp", 'local', @port)
           
-      ['INT', 'TERM'].each { |signal| 
-        trap(signal) do
-          handle.stop
-          server.stop_service
-        end
-      }
+      # ['INT', 'TERM'].each { |signal| 
+      #   trap(signal) do
+      #     handle.stop
+      #     server.stop_service
+      #   end
+      # }
 	  end
 		
 		def bonjour_scan

data/lib/politics/token_worker.rb

@@ -142,17 +142,15 @@ module Politics
     
     # Nominate ourself as leader by contacting the memcached server
     # and attempting to add the token with our name attached.
+    # The result will tell us if memcached stored our value and therefore
+    # if we are now leader.
     def nominate
-      memcache_client.add(token, worker_name, iteration_length)
+      result = memcache_client.add(token, worker_name, (iteration_length * 0.9).to_i)
+      @leader = (result =~ /\ASTORED/)
     end
 
-    # Check to see if we are leader by looking at the process name
-    # associated with the token.
     def leader?
-      @leader ||= begin
-        master_worker = memcache_client.get(token)
-        worker_name == master_worker
-      end
+      @leader
     end
 
     # Easy to mock or monkey-patch if another MemCache client is preferred.

data/lib/politics/version.rb

@@ -1,5 +1,5 @@
 module Politics
   module Version
-    STRING = "0.2.0"
+    STRING = "0.2.3"
   end
 end

data/lib/politics.rb

@@ -1,5 +1,3 @@
-require 'logger'
-
 module Politics
 
   def self.log=(value)
@@ -7,6 +5,11 @@ module Politics
   end
   
   def self.log
-    @log ||= Logger.new(STDOUT)
+    @log ||= if defined?(RAILS_DEFAULT_LOGGER)
+      RAILS_DEFAULT_LOGGER
+    else
+      require 'logger'
+      Logger.new(STDOUT)
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: mperham-politics
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  version: 0.2.4
 platform: ruby
 authors: 
 - Mike Perham
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-10-27 00:00:00 -07:00
+date: 2009-01-11 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency