tjplurker 1.0.2 → 1.0.3

data/lib/tjplurker.rb

@@ -95,6 +95,9 @@ class TJPlurker
         rescue Timeout::Error => ex
             $tjpLog.warn(self.class){"Request timeout, retry."}
             retry
+        rescue Errno::ECONNRESET => ex
+            $tjpLog.warn(self.class){"Connection reset, retry."}
+            retry
         rescue => ex
             $tjpLog.fatal(self.class){"Unknown error, skip."}
             puts ex.class, ex.message, ex.backtrace
@@ -139,6 +142,9 @@ class TJPlurker
         rescue Timeout::Error => ex
             $tjpLog.warn(self.class){"Request timeout, retrying."}
             retry
+        rescue Errno::ECONNRESET => ex
+            $tjpLog.warn(self.class){"Connection reset, retry."}
+            retry
         rescue JSON::ParserError => ex
             $tjpLog.error(self.class){"JSON parse error, request failed."}
         rescue => ex
@@ -149,8 +155,8 @@ class TJPlurker
         return json
     end
     
+    # Format the json from the comet server. See TJPlurker#comet_channel
     class NotificationData
-        
         # Can be +new_plurk+ or +new_response+.
         attr_reader :type
         attr_reader :response_count
@@ -200,6 +206,7 @@ class TJPlurker
             @services = []
         end
         
+        # Starting a loop and invokes services when a notification was listened.
         def start
             $tjpLog.info(self.class){"Start robot."}
             Thread.new{
@@ -221,6 +228,7 @@ class TJPlurker
             }
         end
         
+        # +service+:: Can be instance TJPlurker::Service or class TJPlurker::Service or it's descendant classes.
         def add_service service
             if service.is_a? Service
                 @services << service
@@ -244,24 +252,28 @@ class TJPlurker
             end
         end
         
+        # Invoke when listened a new plurk.
         def decide tjplurker, data
             true
         end
         
         def action tjplurker, data
-            p data
-        end
-        
-        def serve tjplurker, data
             if @serve_proc
                 @serve_proc[tjplurker, data]
             else
-                action(tjplurker, data) if decide(tjplurker, data)
+                p data
             end
         end
+        
+        def serve tjplurker, data
+            action(tjplurker, data) if decide(tjplurker, data)
+        end
     end
     
     class ThreadService < Service
+        # +lasting+:: How long in second will a thread lives. If one plurk just be responsed, then it will live another +lasting+ time.
+        #
+        # +refresh+:: Interval that checks if thread should terminate.
         def initialize name=self.class.to_s, lasting=60, refresh=1, &proc
             super name
             @lasting = lasting
@@ -270,16 +282,12 @@ class TJPlurker
             @mutex = Mutex.new
         end
         
-        def decide tjplurker, data
-            true
-        end
+        # Invoke after thread termination.
+        # You can use this to tell users this service just terminate.
+        def final tjplurker, data
         
-        def action tjplurker, data
-            @serve_proc[tjplurker, data]
         end
         
-        def final tjplurker, data
-        end
         def serve tjplurker, data
             if data.type=='new_plurk' && decide(tjplurker, data)
                 @plurk_id_hash[data.plurk_id] = Thread.new(data.plurk_id){|plurk_id|
@@ -311,7 +319,6 @@ class TJPlurker
             end
         end
     end
-
 end
 
 if __FILE__ == $0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tjplurker
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,12 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-05-24 00:00:00.000000000 +08:00
-default_executable: 
+date: 2011-05-27 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &19617900 !ruby/object:Gem::Requirement
+  requirement: &15370380 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -22,7 +21,7 @@ dependencies:
         version: 1.4.2
   type: :runtime
   prerelease: false
-  version_requirements: *19617900
+  version_requirements: *15370380
 description: A safe Plurk API wrapper based on Ruby and mainly designed for easily
   making plurk robot.
 email: tonytonyjan.cs97@g2.nctu.edu.tw
@@ -31,7 +30,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/tjplurker.rb
-has_rdoc: true
 homepage: http://code.google.com/p/tjplurker
 licenses: []
 post_install_message: 
@@ -52,7 +50,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.5.2
+rubygems_version: 1.8.4
 signing_key: 
 specification_version: 3
 summary: A safe Plurk API wrapper based on Ruby and mainly designed for easily making