Path: | README.rdoc |
Last Update: | Sun Dec 04 11:12:59 +0000 2011 |
The RubyQmail Plugin provides support for the Qmail MTA and helpers for creating data-aware applications While initially intended to operate in a large-scale Qmail environment, some of these features may be useful for applications on other platforms. In fact, this plugin is not required if you are using Qmail because ActionMailer‘s sendmail and smtp configurations will work for simple Qmail installations.
NOTE: This is still in an early stage of development, but has been tested to insert email into the qmail queue via the qmail-queue and QMQP protocols.
Ruby Qmail takes a message in 3 parts
bounces-messageid@example.com
Ruby-Qmail used VERP (Variable Envelope Return Path) by default, so bounces will be returned in the form
bounces-messageid-recipientmailbox=recipientdomain@example.com
for individual returns. Qmail will also send a report to the return path (without the recipient address encoded)
bounces-messageid-@example.com
with addresses and error messages for all undeliverable addresses.
Call the insert command
RubyQmail::Queue.insert "bounces-123@example.com", ['recipient@email.com',...], message_file
The call returns true if the message was inserted. If you want more control and information, you can run it as:
rqq = RubyQmail::Queue.new sucess? = rqq.qmail_queue "bounces-123@example.com", ['recipient@email.com',...], message_file puts rqq.response #=> Response message
You can also specify a set of options on the invocation line as :name=>value parameters after the message file.
RubyQmail::Queue.insert "bounces-123@example.com", recipient_file, message_file, :method=>:qmqp
Options can be
bump version in a commit by itself I can ignore when I pull)
Copyright (c) 2009 Allen Fair. See LICENSE for details.