resque_ui 3.1.7 → 3.2.0

data/lib/resque_ui/overrides/resque/worker.rb

@@ -22,8 +22,10 @@ module Resque
 
     alias_method :id, :to_s
 
-    def pid
-      to_s.split(':').second
+    # When the worker gets the -USR2 signal, to_s may give a different value for the thread and queue portion
+    def pause_key
+      key = to_s.split(':')
+      "worker:#{key.first}:#{key.second}:all_workers:paused"
     end
 
     def thread
@@ -76,6 +78,35 @@ module Resque
       @shutdown = true
     end
 
+    def paused
+      redis.get pause_key
+    end
+
+    # are we paused?
+    # OVERRIDE so UI can tell if we're paused
+    def paused?
+      @paused || paused.present?
+    end
+
+    # Stop processing jobs after the current one has completed (if we're
+    # currently running one).
+    #OVERRIDE to set a redis key so UI knows it's paused too
+    # Would prefer to call super but get no superclass method error
+    def pause_processing
+      log "USR2 received; pausing job processing"
+      @paused = true
+      redis.set(pause_key, Time.now.to_s)
+    end
+
+    # Start processing jobs again after a pause
+    #OVERRIDE to set remove redis key so UI knows it's unpaused too
+    # Would prefer to call super but get no superclass method error
+    def unpause_processing
+      log "CONT received; resuming job processing"
+      @paused = false
+      redis.del(pause_key)
+    end
+
     # Looks for any workers which should be running on this server
     # and, if they're not, removes them from Redis.
     #
@@ -96,6 +127,29 @@ module Resque
       end
     end
 
+    # Unregisters ourself as a worker. Useful when shutting down.
+    # OVERRIDE to also remove the pause key
+    # Would prefer to call super but get no superclass method error
+    def unregister_worker
+      # If we're still processing a job, make sure it gets logged as a
+      # failure.
+      if (hash = processing) && !hash.empty?
+        job = Job.new(hash['queue'], hash['payload'])
+        # Ensure the proper worker is attached to this job, even if
+        # it's not the precise instance that died.
+        job.worker = self
+        job.fail(DirtyExit.new)
+      end
+
+      redis.srem(:workers, self)
+      redis.del("worker:#{self}")
+      redis.del("worker:#{self}:started")
+      redis.del(pause_key)
+
+      Stat.clear("processed:#{self}")
+      Stat.clear("failed:#{self}")
+    end
+
     def all_workers_in_pid_working
       workers_in_pid.select { |w| (hash = w.processing) && !hash.empty? }
     end
@@ -168,14 +222,6 @@ module Resque
       end.compact
     end
 
-    # Returns an array of string pids of all the other workers on this
-    # machine. Useful when pruning dead workers on startup.
-    def worker_pids
-      `ps -A -o pid,command | grep [r]esque`.split("\n").map do |line|
-        line.split(' ')[0]
-      end
-    end
-
     def status=(status)
       data = encode(job.merge('status' => status))
       redis.set("worker:#{self}", data)
@@ -208,6 +254,22 @@ module Resque
       end
     end
 
+    def pause
+      if Rails.env =~ /development|test/
+        system("kill -USR2  #{self.pid}")
+      else
+        system("cd #{Rails.root}; #{ResqueUi::Cap.path} #{Rails.env} resque:pause_worker pid=#{self.pid} host=#{self.ip}")
+      end
+    end
+
+    def continue
+      if Rails.env =~ /development|test/
+        system("kill -CONT  #{self.pid}")
+      else
+        system("cd #{Rails.root}; #{ResqueUi::Cap.path} #{Rails.env} resque:continue_worker pid=#{self.pid} host=#{self.ip}")
+      end
+    end
+
     def restart
       queues = self.queues_in_pid.join('#')
       quit

data/lib/resque_ui/overrides/resque_status/job_with_status.rb

@@ -1,5 +1,8 @@
 module Resque
   class JobWithStatus
+
+    attr_reader :worker
+
     # Adds a job of type <tt>klass<tt> to the queue with <tt>options<tt>.
     # Returns the UUID of the job
     # override to pass actual parameters instead of a single hash, to make backward compatible with existing resque jobs.
@@ -16,6 +19,47 @@ module Resque
     def tick(*messages)
       kill! if should_kill? || status.killed?
       set_status({'status' => 'working'}, *messages)
+      # check to see if the worker doing the job has been paused, pause the job if so
+      if self.worker && self.worker.paused?
+        loop do
+          # Set the status to paused.
+          # May need to do this repeatedly because there could be workers in a chained job still doing work.
+          pause! unless status.paused?
+          break unless self.worker.paused?
+          sleep 60
+        end
+        set_status({'status' => 'working'}, *messages) unless status && (status.completed? || status.paused? || status.killed?)
+      end
+    end
+
+    # Pause the current job, setting the status to 'paused'
+    def pause!
+      set_status({
+                     'status' => 'paused',
+                     'message' => "#{worker} paused at #{Time.now}"
+                 })
+    end
+
+    # Create a new instance with <tt>uuid</tt> and <tt>options</tt>
+    # OVERRIDE to add the worker attr
+    def initialize(uuid, worker, options = {})
+      @uuid = uuid
+      @options = options
+      @worker = worker
+    end
+
+    # This is the method called by Resque::Worker when processing jobs. It
+    # creates a new instance of the job class and populates it with the uuid and
+    # options.
+    #
+    # You should not override this method, rather the <tt>perform</tt> instance method.
+    # OVERRIDE to pass the block in order to set the worker status, returns the worker object
+    def self.perform(uuid=nil, options = {})
+      uuid ||= Resque::Status.generate_uuid
+      worker = yield
+      instance = new(uuid, worker, options)
+      instance.safe_perform! { |status| yield status if block_given? }
+      instance
     end
 
     # Run by the Resque::Worker when processing this job. It wraps the <tt>perform</tt>
@@ -25,7 +69,7 @@ module Resque
     def safe_perform!
       unless should_kill? || (status && status.killed?)
         set_status({'status' => 'working'})
-        perform
+        perform { |status| yield status if block_given?  }
         kill! if should_kill?
         completed unless status && status.completed?
         on_success if respond_to?(:on_success)

data/lib/resque_ui/overrides/resque_status/status.rb

@@ -1,5 +1,10 @@
 module Resque
   class Status
+    # The STATUSES constant is frozen, so we'll just manually add the paused? method here
+    def paused?
+        self['status'] === 'paused'
+    end
+
     # Return the <tt>num</tt> most recent status/job UUIDs in reverse chronological order.
     #override the gem to fix the ordering
     def self.status_ids(range_start = nil, range_end = nil)

data/rdoc/Resque/Job.html

@@ -163,16 +163,80 @@
             
             <p>Attempts to perform the work represented by this job instance. Calls <a
 href="Job.html#method-i-perform">perform</a> on the class given in the
-payload with the arguments given in the payload. The worker is passed in so
-the status can be set for the UI to display.</p>
+payload with the arguments given in the payload. A block is sent so a
+message can be yielded back to be set in the worker.</p>
             
 
             
             <div class="method-source-code" id="perform-source">
 <pre>
-<span class="ruby-comment"># File lib/resque_ui/overrides/resque/job.rb, line 7</span>
+<span class="ruby-comment"># File lib/resque_ui/overrides/resque/job.rb, line 8</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">perform</span>
-  <span class="ruby-identifier">args</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">payload_class</span>.<span class="ruby-identifier">perform</span>(*<span class="ruby-identifier">args</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">status</span><span class="ruby-operator">|</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">worker</span>.<span class="ruby-identifier">status</span> = <span class="ruby-identifier">status</span> } <span class="ruby-operator">:</span> <span class="ruby-identifier">payload_class</span>.<span class="ruby-identifier">perform</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">status</span><span class="ruby-operator">|</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">worker</span>.<span class="ruby-identifier">status</span> = <span class="ruby-identifier">status</span> }
+  <span class="ruby-identifier">job</span> = <span class="ruby-identifier">payload_class</span>
+  <span class="ruby-identifier">job_args</span> = <span class="ruby-identifier">args</span> <span class="ruby-operator">||</span> []
+  <span class="ruby-identifier">job_was_performed</span> = <span class="ruby-keyword">false</span>
+
+  <span class="ruby-identifier">before_hooks</span> = <span class="ruby-constant">Plugin</span>.<span class="ruby-identifier">before_hooks</span>(<span class="ruby-identifier">job</span>)
+  <span class="ruby-identifier">around_hooks</span> = <span class="ruby-constant">Plugin</span>.<span class="ruby-identifier">around_hooks</span>(<span class="ruby-identifier">job</span>)
+  <span class="ruby-identifier">after_hooks</span> = <span class="ruby-constant">Plugin</span>.<span class="ruby-identifier">after_hooks</span>(<span class="ruby-identifier">job</span>)
+  <span class="ruby-identifier">failure_hooks</span> = <span class="ruby-constant">Plugin</span>.<span class="ruby-identifier">failure_hooks</span>(<span class="ruby-identifier">job</span>)
+
+  <span class="ruby-keyword">begin</span>
+    <span class="ruby-comment"># Execute before_perform hook. Abort the job gracefully if</span>
+    <span class="ruby-comment"># Resque::DontPerform is raised.</span>
+    <span class="ruby-keyword">begin</span>
+      <span class="ruby-identifier">before_hooks</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">hook</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">job</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">hook</span>, *<span class="ruby-identifier">job_args</span>)
+      <span class="ruby-keyword">end</span>
+    <span class="ruby-keyword">rescue</span> <span class="ruby-constant">DontPerform</span>
+      <span class="ruby-keyword">return</span> <span class="ruby-keyword">false</span>
+    <span class="ruby-keyword">end</span>
+
+    <span class="ruby-comment"># Execute the job. Do it in an around_perform hook if available.</span>
+    <span class="ruby-keyword">if</span> <span class="ruby-identifier">around_hooks</span>.<span class="ruby-identifier">empty?</span>
+      <span class="ruby-identifier">job</span>.<span class="ruby-identifier">perform</span>(*<span class="ruby-identifier">job_args</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">status</span><span class="ruby-operator">|</span>
+        <span class="ruby-keyword">self</span>.<span class="ruby-identifier">worker</span>.<span class="ruby-identifier">status</span> = <span class="ruby-identifier">status</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">status</span>.<span class="ruby-identifier">present?</span>
+        <span class="ruby-keyword">self</span>.<span class="ruby-identifier">worker</span>
+      <span class="ruby-keyword">end</span>
+      <span class="ruby-identifier">job_was_performed</span> = <span class="ruby-keyword">true</span>
+    <span class="ruby-keyword">else</span>
+      <span class="ruby-comment"># We want to nest all around_perform plugins, with the last one</span>
+      <span class="ruby-comment"># finally calling perform</span>
+      <span class="ruby-identifier">stack</span> = <span class="ruby-identifier">around_hooks</span>.<span class="ruby-identifier">reverse</span>.<span class="ruby-identifier">inject</span>(<span class="ruby-keyword">nil</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">last_hook</span>, <span class="ruby-identifier">hook</span><span class="ruby-operator">|</span>
+        <span class="ruby-keyword">if</span> <span class="ruby-identifier">last_hook</span>
+          <span class="ruby-identifier">lambda</span> <span class="ruby-keyword">do</span>
+            <span class="ruby-identifier">job</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">hook</span>, *<span class="ruby-identifier">job_args</span>) { <span class="ruby-identifier">last_hook</span>.<span class="ruby-identifier">call</span> }
+          <span class="ruby-keyword">end</span>
+        <span class="ruby-keyword">else</span>
+          <span class="ruby-identifier">lambda</span> <span class="ruby-keyword">do</span>
+            <span class="ruby-identifier">job</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">hook</span>, *<span class="ruby-identifier">job_args</span>) <span class="ruby-keyword">do</span>
+              <span class="ruby-identifier">result</span> = <span class="ruby-identifier">job</span>.<span class="ruby-identifier">perform</span>(*<span class="ruby-identifier">job_args</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">status</span><span class="ruby-operator">|</span>
+                <span class="ruby-keyword">self</span>.<span class="ruby-identifier">worker</span>.<span class="ruby-identifier">status</span> = <span class="ruby-identifier">status</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">status</span>.<span class="ruby-identifier">present?</span>
+                <span class="ruby-keyword">self</span>.<span class="ruby-identifier">worker</span>
+              <span class="ruby-keyword">end</span>
+              <span class="ruby-identifier">job_was_performed</span> = <span class="ruby-keyword">true</span>
+              <span class="ruby-identifier">result</span>
+            <span class="ruby-keyword">end</span>
+          <span class="ruby-keyword">end</span>
+        <span class="ruby-keyword">end</span>
+      <span class="ruby-keyword">end</span>
+      <span class="ruby-identifier">stack</span>.<span class="ruby-identifier">call</span>
+    <span class="ruby-keyword">end</span>
+
+    <span class="ruby-comment"># Execute after_perform hook</span>
+    <span class="ruby-identifier">after_hooks</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">hook</span><span class="ruby-operator">|</span>
+      <span class="ruby-identifier">job</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">hook</span>, *<span class="ruby-identifier">job_args</span>)
+    <span class="ruby-keyword">end</span>
+
+    <span class="ruby-comment"># Return true if the job was performed</span>
+    <span class="ruby-keyword">return</span> <span class="ruby-identifier">job_was_performed</span>
+
+      <span class="ruby-comment"># If an exception occurs during the job execution, look for an</span>
+      <span class="ruby-comment"># on_failure hook then re-raise.</span>
+  <span class="ruby-keyword">rescue</span> <span class="ruby-constant">Object</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">e</span>
+    <span class="ruby-identifier">failure_hooks</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">hook</span><span class="ruby-operator">|</span> <span class="ruby-identifier">job</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">hook</span>, <span class="ruby-identifier">e</span>, *<span class="ruby-identifier">job_args</span>) }
+    <span class="ruby-identifier">raise</span> <span class="ruby-identifier">e</span>
+  <span class="ruby-keyword">end</span>
 <span class="ruby-keyword">end</span></pre>
             </div><!-- perform-source -->
             

data/rdoc/Resque/JobWithStatus.html

@@ -67,12 +67,18 @@
           
           <li><a href="#method-c-enqueue">::enqueue</a></li>
           
+          <li><a href="#method-c-new">::new</a></li>
+          
+          <li><a href="#method-c-perform">::perform</a></li>
+          
           <li><a href="#method-i-counter">#counter</a></li>
           
           <li><a href="#method-i-incr_counter">#incr_counter</a></li>
           
           <li><a href="#method-i-name">#name</a></li>
           
+          <li><a href="#method-i-pause-21">#pause!</a></li>
+          
           <li><a href="#method-i-safe_perform-21">#safe_perform!</a></li>
           
           <li><a href="#method-i-tick">#tick</a></li>
@@ -151,6 +157,28 @@
       
 
       
+      <!-- Attributes -->
+      <div id="attribute-method-details" class="method-section section">
+        <h3 class="section-header">Attributes</h3>
+
+        
+        <div id="worker-attribute-method" class="method-detail">
+          <a name="worker"></a>
+          
+          <div class="method-heading attribute-method-heading">
+            <span class="method-name">worker</span><span
+              class="attribute-access-type">[R]</span>
+          </div>
+
+          <div class="method-description">
+          
+          
+          
+          </div>
+        </div>
+        
+      </div><!-- attribute-method-details -->
+      
 
       <!-- Methods -->
       
@@ -180,7 +208,7 @@ with existing resque jobs.</p>
             
             <div class="method-source-code" id="enqueue-source">
 <pre>
-<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 6</span>
+<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 9</span>
 <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">enqueue</span>(<span class="ruby-identifier">klass</span>, <span class="ruby-identifier">options</span> = {})
   <span class="ruby-identifier">uuid</span> = <span class="ruby-constant">Resque</span><span class="ruby-operator">::</span><span class="ruby-constant">Status</span>.<span class="ruby-identifier">create</span> <span class="ruby-value">:name</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-node">&quot;#{self.name}: #{options.inspect}&quot;</span>
   <span class="ruby-constant">Resque</span>.<span class="ruby-identifier">enqueue</span>(<span class="ruby-identifier">klass</span>, <span class="ruby-identifier">uuid</span>, <span class="ruby-identifier">options</span>)
@@ -196,6 +224,85 @@ with existing resque jobs.</p>
         </div><!-- enqueue-method -->
 
       
+        <div id="new-method" class="method-detail ">
+          <a name="method-c-new"></a>
+
+          
+          <div class="method-heading">
+            <span class="method-name">new</span><span
+              class="method-args">(uuid, worker, options = {})</span>
+            <span class="method-click-advice">click to toggle source</span>
+          </div>
+          
+
+          <div class="method-description">
+            
+            <p>Create a new instance with <tt>uuid</tt> and <tt>options</tt> OVERRIDE to
+add the worker attr</p>
+            
+
+            
+            <div class="method-source-code" id="new-source">
+<pre>
+<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 45</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">uuid</span>, <span class="ruby-identifier">worker</span>, <span class="ruby-identifier">options</span> = {})
+  <span class="ruby-ivar">@uuid</span> = <span class="ruby-identifier">uuid</span>
+  <span class="ruby-ivar">@options</span> = <span class="ruby-identifier">options</span>
+  <span class="ruby-ivar">@worker</span> = <span class="ruby-identifier">worker</span>
+<span class="ruby-keyword">end</span></pre>
+            </div><!-- new-source -->
+            
+          </div>
+
+          
+
+          
+        </div><!-- new-method -->
+
+      
+        <div id="perform-method" class="method-detail ">
+          <a name="method-c-perform"></a>
+
+          
+          <div class="method-heading">
+            <span class="method-name">perform</span><span
+              class="method-args">(uuid=nil, options = {})</span>
+            <span class="method-click-advice">click to toggle source</span>
+          </div>
+          
+
+          <div class="method-description">
+            
+            <p>This is the method called by <a href="Worker.html">Resque::Worker</a> when
+processing jobs. It creates a new instance of the job class and populates
+it with the uuid and options.</p>
+
+<p>You should not override this method, rather the <tt>perform</tt> instance
+method. OVERRIDE to pass the block in order to set the worker status,
+returns the worker object</p>
+            
+
+            
+            <div class="method-source-code" id="perform-source">
+<pre>
+<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 57</span>
+<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">perform</span>(<span class="ruby-identifier">uuid</span>=<span class="ruby-keyword">nil</span>, <span class="ruby-identifier">options</span> = {})
+  <span class="ruby-identifier">uuid</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">Resque</span><span class="ruby-operator">::</span><span class="ruby-constant">Status</span>.<span class="ruby-identifier">generate_uuid</span>
+  <span class="ruby-identifier">worker</span> = <span class="ruby-keyword">yield</span>
+  <span class="ruby-identifier">instance</span> = <span class="ruby-identifier">new</span>(<span class="ruby-identifier">uuid</span>, <span class="ruby-identifier">worker</span>, <span class="ruby-identifier">options</span>)
+  <span class="ruby-identifier">instance</span>.<span class="ruby-identifier">safe_perform!</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">status</span><span class="ruby-operator">|</span> <span class="ruby-keyword">yield</span> <span class="ruby-identifier">status</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">block_given?</span> }
+  <span class="ruby-identifier">instance</span>
+<span class="ruby-keyword">end</span></pre>
+            </div><!-- perform-source -->
+            
+          </div>
+
+          
+
+          
+        </div><!-- perform-method -->
+
+      
       </div><!-- public-class-method-details -->
     
       <div id="public-instance-method-details" class="method-section section">
@@ -221,7 +328,7 @@ with existing resque jobs.</p>
             
             <div class="method-source-code" id="counter-source">
 <pre>
-<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 55</span>
+<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 99</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">counter</span>(<span class="ruby-identifier">counter</span>)
   <span class="ruby-constant">Resque</span><span class="ruby-operator">::</span><span class="ruby-constant">Status</span>.<span class="ruby-identifier">counter</span>(<span class="ruby-identifier">counter</span>, <span class="ruby-identifier">uuid</span>)
 <span class="ruby-keyword">end</span></pre>
@@ -254,7 +361,7 @@ with existing resque jobs.</p>
             
             <div class="method-source-code" id="incr_counter-source">
 <pre>
-<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 51</span>
+<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 95</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">incr_counter</span>(<span class="ruby-identifier">counter</span>)
   <span class="ruby-constant">Resque</span><span class="ruby-operator">::</span><span class="ruby-constant">Status</span>.<span class="ruby-identifier">incr_counter</span>(<span class="ruby-identifier">counter</span>, <span class="ruby-identifier">uuid</span>)
 <span class="ruby-keyword">end</span></pre>
@@ -287,7 +394,7 @@ with existing resque jobs.</p>
             
             <div class="method-source-code" id="name-source">
 <pre>
-<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 47</span>
+<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 91</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">name</span>
   <span class="ruby-node">&quot;#{self.class.name}: #{options.inspect}&quot;</span>
 <span class="ruby-keyword">end</span></pre>
@@ -301,6 +408,42 @@ with existing resque jobs.</p>
         </div><!-- name-method -->
 
       
+        <div id="pause-21-method" class="method-detail ">
+          <a name="method-i-pause-21"></a>
+
+          
+          <div class="method-heading">
+            <span class="method-name">pause!</span><span
+              class="method-args">()</span>
+            <span class="method-click-advice">click to toggle source</span>
+          </div>
+          
+
+          <div class="method-description">
+            
+            <p>Pause the current job, setting the status to ‘paused’</p>
+            
+
+            
+            <div class="method-source-code" id="pause-21-source">
+<pre>
+<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 36</span>
+<span class="ruby-keyword">def</span> <span class="ruby-identifier">pause!</span>
+  <span class="ruby-identifier">set_status</span>({
+                 <span class="ruby-string">'status'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">'paused'</span>,
+                 <span class="ruby-string">'message'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-node">&quot;#{worker} paused at #{Time.now}&quot;</span>
+             })
+<span class="ruby-keyword">end</span></pre>
+            </div><!-- pause-21-source -->
+            
+          </div>
+
+          
+
+          
+        </div><!-- pause-21-method -->
+
+      
         <div id="safe_perform-21-method" class="method-detail ">
           <a name="method-i-safe_perform-21"></a>
 
@@ -323,11 +466,11 @@ work, it will set the status as failed and re-raise the error.</p>
             
             <div class="method-source-code" id="safe_perform-21-source">
 <pre>
-<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 25</span>
+<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 69</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">safe_perform!</span>
   <span class="ruby-keyword">unless</span> <span class="ruby-identifier">should_kill?</span> <span class="ruby-operator">||</span> (<span class="ruby-identifier">status</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">status</span>.<span class="ruby-identifier">killed?</span>)
     <span class="ruby-identifier">set_status</span>({<span class="ruby-string">'status'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">'working'</span>})
-    <span class="ruby-identifier">perform</span>
+    <span class="ruby-identifier">perform</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">status</span><span class="ruby-operator">|</span> <span class="ruby-keyword">yield</span> <span class="ruby-identifier">status</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">block_given?</span>  }
     <span class="ruby-identifier">kill!</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">should_kill?</span>
     <span class="ruby-identifier">completed</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">status</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">status</span>.<span class="ruby-identifier">completed?</span>
     <span class="ruby-identifier">on_success</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:on_success</span>)
@@ -377,10 +520,21 @@ This will kill the job if it has been added to the kill list with
             
             <div class="method-source-code" id="tick-source">
 <pre>
-<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 16</span>
+<span class="ruby-comment"># File lib/resque_ui/overrides/resque_status/job_with_status.rb, line 19</span>
 <span class="ruby-keyword">def</span> <span class="ruby-identifier">tick</span>(*<span class="ruby-identifier">messages</span>)
   <span class="ruby-identifier">kill!</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">should_kill?</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">status</span>.<span class="ruby-identifier">killed?</span>
   <span class="ruby-identifier">set_status</span>({<span class="ruby-string">'status'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">'working'</span>}, *<span class="ruby-identifier">messages</span>)
+  <span class="ruby-comment"># check to see if the worker doing the job has been paused, pause the job if so</span>
+  <span class="ruby-keyword">if</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">worker</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">worker</span>.<span class="ruby-identifier">paused?</span>
+    <span class="ruby-identifier">loop</span> <span class="ruby-keyword">do</span>
+      <span class="ruby-comment"># Set the status to paused.</span>
+      <span class="ruby-comment"># May need to do this repeatedly because there could be workers in a chained job still doing work.</span>
+      <span class="ruby-identifier">pause!</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">status</span>.<span class="ruby-identifier">paused?</span>
+      <span class="ruby-keyword">break</span> <span class="ruby-keyword">unless</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">worker</span>.<span class="ruby-identifier">paused?</span>
+      <span class="ruby-identifier">sleep</span> <span class="ruby-value">60</span>
+    <span class="ruby-keyword">end</span>
+    <span class="ruby-identifier">set_status</span>({<span class="ruby-string">'status'</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-string">'working'</span>}, *<span class="ruby-identifier">messages</span>) <span class="ruby-keyword">unless</span> <span class="ruby-identifier">status</span> <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">status</span>.<span class="ruby-identifier">completed?</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">status</span>.<span class="ruby-identifier">paused?</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">status</span>.<span class="ruby-identifier">killed?</span>)
+  <span class="ruby-keyword">end</span>
 <span class="ruby-keyword">end</span></pre>
             </div><!-- tick-source -->