Sidekiq::Mailer adds to your ActionMailer classes the ability to send mails asynchronously.
If you want to make a specific mailer to work asynchronously just include Sidekiq::Mailer module:
class MyMailer < ActionMailer::Base include Sidekiq::Mailer def welcome(to) ... end end
Now every deliver you make with MyMailer will be asynchronous.
# Queues the mail to be sent asynchronously by sidekiq MyMailer.welcome('email@example.com').deliver
The default queue used by Sidekiq::Mailer is 'mailer'. So, in order to send mails with sidekiq you need to start a worker using:
sidekiq -q mailer
If you want to skip sidekiq you should use the 'deliver!' method:
# Mail will skip sidekiq and will be sent synchronously MyMailer.welcome('firstname.lastname@example.org').deliver!
By default Sidekiq::Mailer will retry to send an email if it failed. But you can override sidekiq options in your mailer.
Add this line to your application's Gemfile:
And then execute:
Or install it yourself as:
$ gem install sidekiq_mailer
Delayed e-mails is an awesome thing in production environments, but for e-mail specs/tests in testing environments it can be a mess causing specs/tests to fail because the e-mail haven't been sent directly. Therefore you can configure what environments that should be excluded like so:
# config/initializers/sidekiq_mailer.rb Sidekiq::Mailer.excluded_environments = [:test, :cucumber]
- Fork it
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Added some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request