require 'optparse' require 'net/smtp' require 'smtp_tls' require 'rubygems' class Object # :nodoc: unless respond_to? :path2class then def self.path2class(path) path.split(/::/).inject self do |k,n| k.const_get n end end end end ## # Hack in RSET module Net # :nodoc: class SMTP # :nodoc: unless instance_methods.include? 'reset' then ## # Resets the SMTP connection. def reset getok 'RSET' end end end end module ActionMailer; end # :nodoc: ## # ActionMailer::ARSendmail delivers email from the email table to the # SMTP server configured in your application's config/environment.rb. # ar_sendmail does not work with sendmail delivery. # # ar_mailer can deliver to SMTP with TLS using smtp_tls.rb borrowed from Kyle # Maxwell's action_mailer_optional_tls plugin. Simply set the :tls option in # ActionMailer::Base's smtp_settings to true to enable TLS. # # See ar_sendmail -h for the full list of supported options. # # The interesting options are: # * --daemon # * --mailq # * --create-migration # * --create-model # * --table-name class ActionMailer::ARSendmail ## # The version of ActionMailer::ARSendmail you are running. VERSION = '1.3.2' ## # Maximum number of times authentication will be consecutively retried MAX_AUTH_FAILURES = 2 ## # Email delivery attempts per run attr_accessor :batch_size ## # Seconds to delay between runs attr_accessor :delay ## # Maximum age of emails in seconds before they are removed from the queue. attr_accessor :max_age ## # Be verbose attr_accessor :verbose ## # ActiveRecord class that holds emails attr_reader :email_class ## # True if only one delivery attempt will be made per call to run attr_reader :once ## # Times authentication has failed attr_accessor :failed_auth_count ## # Creates a new migration using +table_name+ and prints it on stdout. def self.create_migration(table_name) require 'active_support' puts <<-EOF class Add#{table_name.classify} < ActiveRecord::Migration def self.up create_table :#{table_name.tableize} do |t| t.column :from, :string t.column :to, :string t.column :last_send_attempt, :integer, :default => 0 t.column :mail, :text t.column :created_on, :datetime end end def self.down drop_table :#{table_name.tableize} end end EOF end ## # Creates a new model using +table_name+ and prints it on stdout. def self.create_model(table_name) require 'active_support' puts <<-EOF class #{table_name.classify} < ActiveRecord::Base end EOF end ## # Prints a list of unsent emails and the last delivery attempt, if any. # # If ActiveRecord::Timestamp is not being used the arrival time will not be # known. See http://api.rubyonrails.org/classes/ActiveRecord/Timestamp.html # to learn how to enable ActiveRecord::Timestamp. def self.mailq(table_name) klass = table_name.split('::').inject(Object) { |k,n| k.const_get n } emails = klass.find :all if emails.empty? then puts "Mail queue is empty" return end total_size = 0 puts "-Queue ID- --Size-- ----Arrival Time---- -Sender/Recipient-------" emails.each do |email| size = email.mail.length total_size += size create_timestamp = email.created_on rescue email.created_at rescue Time.at(email.created_date) rescue # for Robot Co-op nil created = if create_timestamp.nil? then ' Unknown' else create_timestamp.strftime '%a %b %d %H:%M:%S' end puts "%10d %8d %s %s" % [email.id, size, created, email.from] if email.last_send_attempt > 0 then puts "Last send attempt: #{Time.at email.last_send_attempt}" end puts " #{email.to}" puts end puts "-- #{total_size/1024} Kbytes in #{emails.length} Requests." end ## # Processes command line options in +args+ def self.process_args(args) name = File.basename $0 options = {} options[:Chdir] = '.' options[:Daemon] = false options[:Delay] = 60 options[:MaxAge] = 86400 * 7 options[:Once] = false options[:RailsEnv] = ENV['RAILS_ENV'] options[:TableName] = 'Email' opts = OptionParser.new do |opts| opts.banner = "Usage: #{name} [options]" opts.separator '' opts.separator "#{name} scans the email table for new messages and sends them to the" opts.separator "website's configured SMTP host." opts.separator '' opts.separator "#{name} must be run from a Rails application's root." opts.separator '' opts.separator 'Sendmail options:' opts.on("-b", "--batch-size BATCH_SIZE", "Maximum number of emails to send per delay", "Default: Deliver all available emails", Integer) do |batch_size| options[:BatchSize] = batch_size end opts.on( "--delay DELAY", "Delay between checks for new mail", "in the database", "Default: #{options[:Delay]}", Integer) do |delay| options[:Delay] = delay end opts.on( "--max-age MAX_AGE", "Maxmimum age for an email. After this", "it will be removed from the queue.", "Set to 0 to disable queue cleanup.", "Default: #{options[:MaxAge]} seconds", Integer) do |max_age| options[:MaxAge] = max_age end opts.on("-o", "--once", "Only check for new mail and deliver once", "Default: #{options[:Once]}") do |once| options[:Once] = once end opts.on("-d", "--daemonize", "Run as a daemon process", "Default: #{options[:Daemon]}") do |daemon| options[:Daemon] = true end opts.on( "--mailq", "Display a list of emails waiting to be sent") do |mailq| options[:MailQ] = true end opts.separator '' opts.separator 'Setup Options:' opts.on( "--create-migration", "Prints a migration to add an Email table", "to stdout") do |create| options[:Migrate] = true end opts.on( "--create-model", "Prints a model for an Email ActiveRecord", "object to stdout") do |create| options[:Model] = true end opts.separator '' opts.separator 'Generic Options:' opts.on("-c", "--chdir PATH", "Use PATH for the application path", "Default: #{options[:Chdir]}") do |path| usage opts, "#{path} is not a directory" unless File.directory? path usage opts, "#{path} is not readable" unless File.readable? path options[:Chdir] = path end opts.on("-e", "--environment RAILS_ENV", "Set the RAILS_ENV constant", "Default: #{options[:RailsEnv]}") do |env| options[:RailsEnv] = env end opts.on("-t", "--table-name TABLE_NAME", "Name of table holding emails", "Used for both sendmail and", "migration creation", "Default: #{options[:TableName]}") do |name| options[:TableName] = name end opts.on("-v", "--[no-]verbose", "Be verbose", "Default: #{options[:Verbose]}") do |verbose| options[:Verbose] = verbose end opts.on("-h", "--help", "You're looking at it") do usage opts end opts.separator '' end opts.parse! args return options if options.include? :Migrate or options.include? :Model ENV['RAILS_ENV'] = options[:RailsEnv] Dir.chdir options[:Chdir] do begin require 'config/environment' rescue LoadError usage opts, <<-EOF #{name} must be run from a Rails application's root to deliver email. #{Dir.pwd} does not appear to be a Rails application root. EOF end end return options end ## # Processes +args+ and runs as appropriate def self.run(args = ARGV) options = process_args args if options.include? :Migrate then create_migration options[:TableName] exit elsif options.include? :Model then create_model options[:TableName] exit elsif options.include? :MailQ then mailq options[:TableName] exit end if options[:Daemon] then require 'webrick/server' WEBrick::Daemon.start end new(options).run rescue SystemExit raise rescue SignalException exit rescue Exception => e $stderr.puts "Unhandled exception #{e.message}(#{e.class}):" $stderr.puts "\t#{e.backtrace.join "\n\t"}" exit 1 end ## # Prints a usage message to $stderr using +opts+ and exits def self.usage(opts, message = nil) if message then $stderr.puts message $stderr.puts end $stderr.puts opts exit 1 end ## # Creates a new ARSendmail. # # Valid options are: # :BatchSize:: Maximum number of emails to send per delay # :Delay:: Delay between deliver attempts # :TableName:: Table name that stores the emails # :Once:: Only attempt to deliver emails once when run is called # :Verbose:: Be verbose. def initialize(options = {}) options[:Delay] ||= 60 options[:TableName] ||= 'Email' options[:MaxAge] ||= 86400 * 7 @batch_size = options[:BatchSize] @delay = options[:Delay] @email_class = Object.path2class options[:TableName] @once = options[:Once] @verbose = options[:Verbose] @max_age = options[:MaxAge] @failed_auth_count = 0 end ## # Removes emails that have lived in the queue for too long. If max_age is # set to 0, no emails will be removed. def cleanup return if @max_age == 0 timeout = Time.now - @max_age conditions = ['last_send_attempt > 0 and created_on < ?', timeout] mail = @email_class.destroy_all conditions log "expired #{mail.length} emails from the queue" end ## # Delivers +emails+ to ActionMailer's SMTP server and destroys them. def deliver(emails) user = smtp_settings[:user] || smtp_settings[:user_name] Net::SMTP.start smtp_settings[:address], smtp_settings[:port], smtp_settings[:domain], user, smtp_settings[:password], smtp_settings[:authentication], smtp_settings[:tls] do |smtp| @failed_auth_count = 0 until emails.empty? do email = emails.shift begin res = smtp.send_message email.mail, email.from, email.to email.destroy log "sent email %011d from %s to %s: %p" % [email.id, email.from, email.to, res] rescue Net::SMTPFatalError => e log "5xx error sending email %d, removing from queue: %p(%s):\n\t%s" % [email.id, e.message, e.class, e.backtrace.join("\n\t")] email.destroy smtp.reset rescue Net::SMTPServerBusy => e log "server too busy, sleeping #{@delay} seconds" sleep delay return rescue Net::SMTPUnknownError, Net::SMTPSyntaxError, TimeoutError => e email.last_send_attempt = Time.now.to_i email.save rescue nil log "error sending email %d: %p(%s):\n\t%s" % [email.id, e.message, e.class, e.backtrace.join("\n\t")] raise e if TimeoutError === e smtp.reset end end end rescue Net::SMTPAuthenticationError => e @failed_auth_count += 1 if @failed_auth_count >= MAX_AUTH_FAILURES then log "authentication error, giving up: #{e.message}" raise e else log "authentication error, retrying: #{e.message}" end sleep delay rescue Net::SMTPServerBusy, SystemCallError, OpenSSL::SSL::SSLError # ignore SMTPServerBusy/EPIPE/ECONNRESET from Net::SMTP.start's ensure rescue TimeoutError # terminate our connection since Net::SMTP may be in a bogus state. sleep delay end ## # Prepares ar_sendmail for exiting def do_exit log "caught signal, shutting down" exit end ## # Returns emails in email_class that haven't had a delivery attempt in the # last 300 seconds. def find_emails options = { :conditions => ['last_send_attempt < ?', Time.now.to_i - 300] } options[:limit] = batch_size unless batch_size.nil? mail = @email_class.find :all, options log "found #{mail.length} emails to send" mail end ## # Installs signal handlers to gracefully exit. def install_signal_handlers trap 'TERM' do do_exit end trap 'INT' do do_exit end end ## # Logs +message+ if verbose def log(message) $stderr.puts message if @verbose ActionMailer::Base.logger.info "ar_sendmail: #{message}" end ## # Scans for emails and delivers them every delay seconds. Only returns if # once is true. def run install_signal_handlers loop do now = Time.now begin cleanup deliver find_emails rescue ActiveRecord::Transactions::TransactionError end break if @once sleep @delay if now + @delay > Time.now end end ## # Proxy to ActionMailer::Base::smtp_settings. See # http://api.rubyonrails.org/classes/ActionMailer/Base.html # for instructions on how to configure ActionMailer's SMTP server. # # Falls back to ::server_settings if ::smtp_settings doesn't exist for # backwards compatibility. def smtp_settings ActionMailer::Base.smtp_settings rescue ActionMailer::Base.server_settings end end