A Rails gem that generates an MVC stack that does email queuing
What it does
mq is a generator that generates an MVC stack for queuing emails. It has a UI too. I got tired of dealing with crappy email queuing systems in Rails, so I wrote my own.
How to Install
sudo gem install mq -s http://gemcutter.com
How to Use
Assuming you'd like to name your mq table
Generate the files necessary for your app:
./script/generate mq Email Notifier
mq requires your Mailer methods accept an email address as its first parameter, so a Mailer method should look like:
Of course, you can pass as many parameters as you'd like:
Notifier.send_email_method(email_address, some_object, some_other_object, ...)
Queue an email by calling
Email.queue with the name of your Notifier method as the first parameter, and the recipient email address as the second parameter, followed by anything else you'd like to pass.
You can pass multiple email addresses to the
Email.queue method and mq will automatically generate individual emails for the recipients.
Email.queue(:send_email_method, ["email@example.com", "firstname.lastname@example.org"], ...)
Delivery of queued email
You can create a cronjob (this on runs every five minutes)
*/5 * * * * cd /path/to/your/app && ./script/runner/Email.deliver_all
How to Test
Complete Rspec specs are included automatically. Well, complete aside from view specs as you'll just change the damned things anyway.