TMail is now out as a gem!

The gem servers are not updating right this minute as the index is being rebuilt, however, once they are up you should be able to:

gem install tmail

to get your favorite TMail installed.

In the mean time you can go to http://tmail.rubyforge.org/ to get the latest release.

Here are the release notes.

TMail 1.1.0
========================

I recently released 1.0, this was for three reasons:

(1) it put the release out as a gem and
(2) to put TMail onto the gem versioning system.
(3) get TMail ready for Rails 2.0RC

However, shortly after releasing 1.0.0 I found an inconsistency in the way that TMail handles the quoting of header fields. Specifically, it was not being RFC compliant in leaving quotes on some fields and removing them from others.

Specifically, the major change is that in the header:

Content-Disposition: attachment; filename="README.txt.pif"

TMail will now return this as:

Content-Disposition: attachment; filename=README.txt.pif

This was not really a bug fix, more of a consequence of handling some other situations (like TMail NOT quoting some other headers correctly).

TMail will still quote a file name if it contains any of the special characters per RFC 1521.

Note, this has the potentiality of breaking something, but probably only in a test suite as the following is still true:

mail['content-disposition'] = 'attachment; filename="test.rb"'
mail.disposition_param('filename') == 'test.rb'

The only change is doing a mail.to_s will return filename=test.rb which is more in accordance with 1521.

There was a patch for this for the 1.0.0 release, but after a LOT of reading of code and digging through the logic of how it was originally designed, I think I have it figured out with a fairly elegant solution.

So, now, out of the 3366 assertions in the TMail test suite, there are two edge case bugs, one is TMail still does not handle the address "@"@me.com properly, changing it to @@.me.com and the second is an edge case on Japanese text encoding and decoding.

I will get to these over the next week or two.

Some more documentation has been done, there is a quick start guide at http://tmail.rubyforge.org/ as well as RDocs in the gem install and soon on the website.

Installation is via:

# gem install tmail

On your favorite OS. The MSWin32 version uses a pure ruby solution, where as the plain vanilla gem uses C code for the scanner and base64 components. If you want these components on a windows platform, get the normal gem, but make sure you have nmake available (I don't use windows a lot and have not automated this, still need to work out how to do it).


Regards

Mikel Lindsaar