#!/usr/bin/ruby

# vim: set nosta noet ts=4 sw=4:

# An individual list message.

#

#    message = Ezmlm::List::Message.new( list, 24 )

#    message.thread    #=> (a thread object this message is part of)

#    message.from      #=> ["jalon.hermann@example.com"]

#    puts message.to_s #=> (raw email)

#

# This class passes all heavy lifting to the Mail::Message library.

# Please see it for specifics on usage.

#

# == Version

#

#  $Id$

#

#---

require 'pathname'

require 'ezmlm' unless defined?( Ezmlm )

require 'mail'

### A Ruby interface to an individual list message.

###

class Ezmlm::List::Message

	### Instantiate a new messag from a +list+ and a +message_number+.

	###

	def initialize( list, message_number=0 )

		raise ArgumentError, "Unknown list object." unless list.respond_to?( :listdir )

		raise ArgumentError, "Invalid message number (impossible)" if message_number < 1

		raise "Archiving is not enabled." unless list.archived?

		raise ArgumentError, "Invalid message number (out of list bounds)" if message_number > list.message_count

		@list = list

		@id   = message_number

		@post = self.load_message

	end

	# The list object this message is stored in.

	attr_reader :list

	# The list message delivery identifier.

	attr_reader :id

	# The Mail::Message object for this post.

	attr_reader :post

	### Return the thread object this message is

	### a member of.

	###

	def thread

		unless @thread_id

			idx = self.list.index

			@thread_id = idx[ self.id - 1 ][ :thread ]

		end

		return Ezmlm::List::Thread.new( self.list, @thread_id )

	end

	### Return the author object this message is

	### a member of.

	###

	def author

		unless @author_id

			idx = self.list.index

			@author_id = idx[ self.id - 1 ][ :author ]

		end

		return Ezmlm::List::Author.new( self.list, @author_id )

	end

	### Render the message as a string.

	###

	def to_s

		return self.post.to_s

	end

	### Provide implicit arrays (Mail::Message does not.)

	###

	def to_ary

		return [ self.post ]

	end

	### Pass all unknown methods to the underlying Mail::Message object.

	###

	def method_missing( meth, *args )

		return self.post.method( meth ).call( *args )

	end

	#########

	protected

	#########

	### Parse the message into a Mail::Message.

	###

	def load_message

		path = self.message_path

		raise "Unable to determine message path: %p" % [ path ] unless path.exist?

		return Mail.read( path.to_s )

	end

	### Return the path on disk for the message.

	###

	def message_path

		hashdir = self.id / 100

		message = "%02d" % [ self.id % 100 ]

		return self.list.listdir + 'archive' + hashdir.to_s + message.to_s

	end

end # class Ezmlm::List::Message