astrotrain

NOTE: Astrotrain is a full gem now. If you’re looking for the old Astrotrain on merb: github.com/entp/astrotrain/tree/merb git://github.com/entp/astrotrain.git (merb branch)

Scans incoming emails for mapped recipients and sends an HTTP POST somewhere.

# setup a config file.
# Point the queue_path at a directory that your mail server dumps each raw incoming mail.
require 'astrotrain'

Astrotrain.load path do
  DataMapper.setup(:default, {
    :adapter  => "mysql",
    :database => "astrotrain",
    :username => "root",
    :host     => "localhost"
  })
end
Astrotrain::Message.queue_path = "/path/to/maildir"
Astrotrain::Mapping::Transport.processing = true

# start up IRB
irb -I /var/astrotrain/lib -r config.rb

# manage mappings
LIB=/var/astrotrain/lib CONFIG=config.rb rake at:mappings
LIB=/var/astrotrain/lib CONFIG=config.rb rake at:map EMAIL=support@foo.com DEST=http://foo.com/email
LIB=/var/astrotrain/lib CONFIG=config.rb rake at:unmap MAP=123

# start the server that runs over the queue directory
LIB=/var/astrotrain/lib CONFIG=config.rb rake at:process

# start the sinatra API
ruby -I /var/astrotrain/lib /var/astrotrain/lib/astrotrain/api.rb config.rb

A single Astrotrain process currently handles email for two production applications, processing thousands daily. It’s far from perfect, but definitely usable.

TODO

Gem package - I realize the load paths could be simplified a bunch, so a gem package will come soon. Docs bounced emails