TMail is an email handler library for Ruby. TMail can extract data from mail, and write data to mail following the relevant RFCs on the subject.

You can get the latest version of TMail from the TMail RubyForge project or via Ruby Gems "tmail"

TMail is written in Ruby and a (very) small bit of supporting C that has pure ruby replacements if you can't compile on your computer. This means TMail will work, out of the box, on any platform that can run Ruby 1.8 or Ruby 1.9.

TMail is a commonly used library and is production ready. The ActionMailer component of Ruby on Rails uses it as well as the the Nitro web framework and many and others - including the Ruby-Talk mail gateway.

What TMail does is allow you to play with Emails like you would any Ruby object. So to change the To address of an email, instead of something like:

  my_message = "From mikel@example.org\nReceived by.... etc"
  my_message.sub(/^To: .*?@.*?$/, "To: mikel@elsewhere.org")

Which (a) will break easily and (b) is just not the Ruby-Way™ You can do:

  email = TMail::Mail.parse("From mikel@example.org\nReceived by.... etc")
  email['to'] = 'mikel@elsewhere.org'

And TMail will take care of the details. Isn't that nicer?

TMail was created by Minero Aoki. It is currently maintained by Mikel and Trans as a RubyForge Project   .

For the impatient there is a quickstart guide that will get you up and running with TMail in a few minutes, for the rest, there is the full documentation by RDoc (comming soon) as well as an online user manual (needs updating).