employer 0.3.1 → 0.4

data/README.md

@@ -68,8 +68,10 @@ won't be attempted again.
 Employer manages its jobs through its pipeline, in order to feed jobs into the
 pipeline and to get jobs out of the pipeline you need to connect a backend to
 it. You can either use a backend that someone has built already (if you're using
-Mongoid 3 you can use the employer-mongoid gem), or implement your own. A valid
-pipeline backend must implement the methods shown in the below code snippet:
+ActiveRecord 3.2.x you can use the employer-activerecord gem, and if you're
+using Mongoid 3 you can use the employer-mongoid gem), or implement your own. A 
+valid pipeline backend must implement the methods shown in the below code 
+snippet:
 
 ```ruby
 class CustomPipelineBackend
@@ -106,6 +108,18 @@ class CustomPipelineBackend
 end
 ```
 
+In the event that your backend needs to do something special before forking or
+starting a new thread to perform a job you can add in hooks on the appropriate 
+Employee class:
+
+```ruby
+Employer::Employees::ForkingEmployee.before_fork { # your code here }
+
+Employer::Employees::ThreadingEmployee.before_fork { # your code here }
+```
+
+You can add multiple hooks, they are executed in the order they were added.
+
 To hook up the backend to Employer you must generate and edit a config file by
 running `employer config` (or more likely `bundle exec employer config`). If you
 don't specify a custom path (with -c /path/to/employer\_config.rb) this will
@@ -119,12 +133,12 @@ generate config/employer.rb, the file will look something like this:
 # your database, etc.)
 # require "./config/environment"
 
-require "employer-mongoid"
+require "employer-activerecord"
 
 # Setup the backend for the pipeline, this is where the boss gets the jobs to
 # process. See the documentation for details on writing your own pipeline
 # backend.
-pipeline_backend Employer::Mongoid::Pipeline.new
+pipeline_backend Employer::ActiveRecord::Pipeline.new
 
 # Add loggers to log. Logged output will go to all of the loggers defined here.
 log_to ::Logger.new("./log/employer.log")

data/lib/employer/employees/abstract_employee.rb

@@ -5,6 +5,14 @@ module Employer
     class AbstractEmployee
       attr_reader :job, :logger
 
+      def self.before_fork_hooks
+        @before_fork_hooks ||= []
+      end
+
+      def self.before_fork(&block)
+        before_fork_hooks << block
+      end
+
       def initialize(logger)
         @logger = logger
       end
@@ -12,6 +20,7 @@ module Employer
       def work(job)
         raise Employer::Errors::EmployeeBusy unless free?
         @job = job
+        self.class.before_fork_hooks.each(&:call)
       end
 
       def perform_job

data/lib/employer/version.rb

@@ -1,3 +1,3 @@
 module Employer
-  VERSION = "0.3.1"
+  VERSION = "0.4"
 end

data/spec/support/shared_examples/employee.rb

@@ -40,6 +40,18 @@ shared_examples "an employee" do
       employee.should_receive(:free?).and_return(false)
       expect { employee.work(job) }.to raise_error(Employer::Errors::EmployeeBusy)
     end
+
+    it "executes before fork hooks" do
+      hook1 = lambda { "hook 1" }
+      hook1.should_receive(:call)
+
+      hook2 = lambda { "hook 2" }
+      hook2.should_receive(:call)
+
+      described_class.before_fork(&hook1)
+      described_class.before_fork(&hook2)
+      employee.work(job)
+    end
   end
 
   describe "#work_in_progress?" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: employer
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: '0.4'
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-11 00:00:00.000000000 Z
+date: 2013-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -135,7 +135,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 564123794148475375
+      hash: 3326102888235758125
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -144,7 +144,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 564123794148475375
+      hash: 3326102888235758125
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23