merb_resque_mailer 0.1

data/README.md

@@ -0,0 +1,52 @@
+Merb Resque Mailer
+==================
+
+Plugin for Merb which allows putting mail deliveries onto [Resque](http://github.com/defunkt/resque) queue.
+
+Usage
+-----
+
+Include Resque::Mailer module in your Merb::MailController subclass(es) like this: 
+
+    class UserMailer < Merb::MailController
+      include Resque::Mailer
+      ...
+    end
+
+or directly in Merb::MailController class if you want to enable it for all mailers:
+
+    class Merb::MailController
+      include Resque::Mailer
+      ...
+    end
+
+Jobs are added to "mailer" queue so you should start at least one worker listening on "mailer" queue:
+
+    QUEUE=mailer rake merb_env resque:work
+
+From now on all emails will be sent asynchronously using Resque worker(s).
+
+Installation
+------------
+
+Gem is hosted on gemcutter.org, simply install it by:
+
+    gem install merb_resque_mailer
+
+and require it in your app (or just add it bundler's Gemfile).
+
+Configuration
+-------------
+
+You can configure for which environments you don't want to use Merb Resque Mailer by setting Resque::Mailer.excluded_environments option (by default :test env is excluded). If you want to exclude also :development env put following code somewhere in config/init.rb:
+    Resque::Mailer.excluded_environments = [:test, :development]
+
+or
+
+    Resque::Mailer.excluded_environments << :development
+
+Credits
+-------
+
+This piece of code was inspired by work of [Nick Plante](http://github.com/zapnap) who created [resque_mailer](http://github.com/zapnap/resque_mailer) for Rails' ActionMailer. Rewritten to work with Merb Mailer by [Marcin Kulik](http://github.com/sickill).
+

data/lib/merb_resque_mailer.rb

@@ -0,0 +1,40 @@
+require 'resque'
+
+module Resque
+  module Mailer
+    
+    def self.excluded_environments=(*environments)
+      @@excluded_environments = environments && environments.flatten.collect! { |env| env.to_sym }
+    end
+    
+    def self.excluded_environments
+      @@excluded_environments ||= [:test]
+    end
+
+    def self.included(base)
+      base.extend(ClassMethods)
+      base.class_eval do
+        alias_method :dispatch_and_deliver!, :dispatch_and_deliver
+        
+        def dispatch_and_deliver(method, mail_params)
+          if ::Resque::Mailer.excluded_environments.include?(Merb.env.to_sym)
+            dispatch_and_deliver!(method, mail_params)
+          else
+            ::Resque.enqueue(self.class, @params, method, mail_params)
+          end
+        end
+      end
+    end
+ 
+    module ClassMethods
+      def queue
+        :mailer
+      end
+ 
+      def perform(params, method, mail_params)
+        new(params).dispatch_and_deliver!(method, mail_params)
+      end
+    end
+
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: merb_resque_mailer
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Marcin Kulik
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-01-10 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: resque
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: 
+email: marcin.kulik@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/merb_resque_mailer.rb
+- README.md
+has_rdoc: true
+homepage: http://sickill.net
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Merb plugin for putting mail delivery jobs onto Resque queue
+test_files: []
+