acts_as_service 0.0.3 → 0.0.4

data/README.rdoc

@@ -10,9 +10,6 @@ Limitations:
 * only been tested while running inside a Rails application
   (e.g. script/runner MySrv.start). should work if you just specify a pidfile
   explicitly, but needs a little testing
-* smooth shutdown depends on your work method returning frequently (however
-  long you run without returning from perform_work_chunk is how long it might
-  take for the service to shut down
 
 Allows you to:
 * start, stop, restart your process

data/acts_as_service.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{acts_as_service}
-  s.version = "0.0.3"
+  s.version = "0.0.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Brian Percival"]
-  s.date = %q{2010-11-05}
+  s.date = %q{2011-01-17}
   s.description = %q{A gem with a mixin to let you turn a class into something that runs like a service,
 which you can MyService.start, MyService.stop, and MyService.restart. It tracks
 its own pid. For now, pretty sure it requires that the class is running inside

data/lib/acts_as_service.rb

@@ -37,6 +37,13 @@
 # code to initiate a shutdown (don't just exit() because there's pidfile
 # cleanup etc. to peform).
 #
+# if you'd like to have long-running work chunks that periodically check
+# for shutdowns, you can call _shutting_down? at any point, which will
+# return true if a shutdown has been initiated. However, recommend putting
+# reasonable amounts of work in each chunk and letting this service
+# infrastructure manage the decision-making about shutting down...it'll
+# in general keep your code cleaner.
+#
 # # my_service.rb:
 # 
 # require 'acts_as_service'
@@ -302,6 +309,14 @@ module ActsAsService
       return _pid == _pid_file_pid
     end
 
+
+    # returns true if the service is in the process of shutting down. let
+    # subclasses access if they'd like
+    #---------------------------------------------------------------------------
+    def _shutting_down?
+      ACTS_AS_SERVICE_SHUTTING_DOWN == _status
+    end
+
   end
 end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: acts_as_service
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 23
   prerelease: false
   segments: 
   - 0
   - 0
-  - 3
-  version: 0.0.3
+  - 4
+  version: 0.0.4
 platform: ruby
 authors: 
 - Brian Percival
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-11-05 00:00:00 -07:00
+date: 2011-01-17 00:00:00 -08:00
 default_executable: 
 dependencies: []