jwz_threading

jwz_threading copied to clipboard

= jwz_threading

jwz_threading is a small ruby library which lets you order a list of E-Mails by conversation. That is, grouping messages together in parent/child relationships based on which messages are replies to which others.

The library implements the JWZ E-Mail threading algorithm as described by Jamie Zawinski (http://www.jwz.org/doc/threading.html).

There is an IMAP extension Internet Draft available which decribes the same here: http://www.jwz.org/doc/draft-ietf-imapext-thread-12.txt

== Requirements Ruby 1.8.* (not yet tested on Ruby 1.9.*)

Requires the following Ruby gems:

• TMail (http://tmail.rubyforge.org)

Only tested on OS X

== Documentation

The documentation is in RDoc format in the doc/rdoc subdirectory.

To generate new rdocs, type this:

$ rake rdoc

== Install

• Using ruby gem

  Type this (You might needs super user privileges):

  $ gem install jwz_threading

  on Mac OS X:

  $ sudo gem install jwz_threading

  Documentation for gem can be found here: http://www.rubygems.org

• Using setup.rb

  Type this (You might needs super user privileges):

  $ ruby setup.rb

  If you want to install a program in to your home directory ($HOME), use following instead:

  $ ruby setup.rb all --prefix=$HOME

  Documentation for setup.rb can be round here:http://i.loveruby.net/en/projects/setup/doc/usage.html

== Status

This package is currently BETAS and therefore considered to be changed heavily in the near future. I very much appreciate suggestions and comments.

== Tests

All tests can be found in /test directory.

To run all tests, type this:

 $ rake test

To run a code coverage report, type:

 $ rake rcov

Documentation for rcov can be found here http://eigenclass.org/hiki/rcov

== RDocs

To generate up-to-date rdocs, type:

 $ rake rdoc

== Contact

• Author: Frederik Dietz
• Website: http://github.com/fdietz/jwz_threading
• E-Mail: [email protected]

== License

The MIT License (see MIT-LICENSE file)