# File lib/tmail/mail.rb, line 86
      def load( fname )
        new(FilePort.new(fname))
      end

# File lib/tmail/mail.rb, line 99
    def initialize( port = nil, conf = DEFAULT_CONFIG )
      @port = port || StringPort.new
      @config = Config.to_config(conf)

      @header      = {}
      @body_port   = nil
      @body_parsed = false
      @epilogue    = ''
      @parts       = []

      @port.ropen {|f|
          parse_header f
          parse_body f unless @port.reproducible?
      }
    end

# File lib/tmail/mail.rb, line 93
      def parse( str )
        new(StringPort.new(str))
      end

# File lib/tmail/mail.rb, line 212
    def []( key )
      @header[key.downcase]
    end

# File lib/tmail/mail.rb, line 235
    def []=( key, val )
      dkey = key.downcase

      if val.nil?
        @header.delete dkey
        return nil
      end

      case val
      when String
        header = new_hf(key, val)
      when HeaderField
        ;
      when Array
        ALLOW_MULTIPLE.include? dkey or
                raise ArgumentError, "#{key}: Header must not be multiple"
        @header[dkey] = val
        return val
      else
        header = new_hf(key, val.to_s)
      end
      if ALLOW_MULTIPLE.include? dkey
        (@header[dkey] ||= []).push header
      else
        @header[dkey] = header
      end

      val
    end

# File lib/tmail/mail.rb, line 134
    def accept( strategy )
      with_multipart_encoding(strategy) {
          ordered_each do |name, field|
            next if field.empty?
            strategy.header_name canonical(name)
            field.accept strategy
            strategy.puts
          end
          strategy.puts
          body_port().ropen {|r|
              strategy.write r.read
          }
      }
    end

# File lib/tmail/net.rb, line 88
    def add_date
      self.date = Time.now
    end

# File lib/tmail/net.rb, line 84
    def add_message_id( fqdn = nil )
      self.message_id = ::TMail::new_message_id(fqdn)
    end

# File lib/tmail/attachments.rb, line 19
    def attachment?(part)
      (part['content-disposition'] && part['content-disposition'].disposition == "attachment") ||
      part.header['content-type'].main_type != "text"
    end

# File lib/tmail/attachments.rb, line 24
    def attachments
      if multipart?
        parts.collect { |part| 
          if part.multipart?
            part.attachments
          elsif attachment?(part)
            content   = part.body # unquoted automatically by TMail#body
            file_name = (part['content-location'] &&
                          part['content-location'].body) ||
                        part.sub_header("content-type", "name") ||
                        part.sub_header("content-disposition", "filename")
            
            next if file_name.blank? || content.blank?
            
            attachment = Attachment.new(content)
            attachment.original_filename = file_name.strip
            attachment.content_type = part.content_type
            attachment
          end
        }.flatten.compact
      end      
    end

# File lib/tmail/interface.rb, line 993
    def base64_decode
      Base64.decode(self.body, @config.strict_base64decode?)
    end

# File lib/tmail/interface.rb, line 984
    def base64_decode!
      if /base64/i === self.transfer_encoding('')
        store 'Content-Transfer-Encoding', '8bit'
        self.body = base64_decode
      end
    end

# File lib/tmail/interface.rb, line 978
    def base64_encode
      Base64.folding_encode(self.body)
    end

# File lib/tmail/interface.rb, line 971
    def base64_encode!
      store 'Content-Transfer-Encoding', 'Base64'
      self.body = base64_encode
    end

# File lib/tmail/interface.rb, line 292
    def bcc( default = nil )
      addrs2specs(bcc_addrs(nil)) || default
    end

# File lib/tmail/interface.rb, line 331
    def bcc=( *strs )
      set_string_array_attr 'Bcc', strs
    end

# File lib/tmail/interface.rb, line 210
    def bcc_addrs( default = nil )
      if h = @header['bcc']
        h.addrs
      else
        default
      end
    end

# File lib/tmail/interface.rb, line 256
    def bcc_addrs=( arg )
      set_addrfield 'bcc', arg
    end

# File lib/tmail/quoting.rb, line 36
    def body(to_charset = 'utf-8', &block)
      attachment_presenter = block || Proc.new { |file_name| "Attachment: #{file_name}\n" }

      if multipart?
        parts.collect { |part|
          header = part["content-type"]

          if part.multipart?
            part.body(to_charset, &attachment_presenter)
          elsif header.nil?
            ""
          elsif !attachment?(part)
            part.unquoted_body(to_charset)
          else
            attachment_presenter.call(header["name"] || "(unnamed)")
          end
        }.join
      else
        unquoted_body(to_charset)
      end
    end

# File lib/tmail/mail.rb, line 426
    def body=( str )
      # Sets the body of the email to a new (encoded) string.
      # 
      # We also reparses the email if the body is ever reassigned, this is a performance hit, however when
      # you assign the body, you usually want to be able to make sure that you can access the attachments etc.
      # 
      # Usage:
      # 
      #  mail.body = "Hello, this is\nthe body text"
      #  # => "Hello, this is\nthe body"
      #  mail.body
      #  # => "Hello, this is\nthe body"
      @body_parsed = false
      parse_body(StringInput.new(str))
      parse_body
      @body_port.wopen {|f| f.write str }
      str
    end

# File lib/tmail/mail.rb, line 410
    def body_port
      parse_body
      @body_port
    end

# File lib/tmail/interface.rb, line 280
    def cc( default = nil )
      addrs2specs(cc_addrs(nil)) || default
    end

# File lib/tmail/interface.rb, line 318
    def cc=( *strs )
      set_string_array_attr 'Cc', strs
    end

# File lib/tmail/interface.rb, line 190
     def cc_addrs( default = nil )
      if h = @header['cc']
        h.addrs
      else
        default
      end
    end

# File lib/tmail/interface.rb, line 242
    def cc_addrs=( arg )
      set_addrfield 'cc', arg
    end

# File lib/tmail/interface.rb, line 837
    def charset( default = nil )
      if h = @header['content-type']
        h['charset'] or default
      else
        default
      end
    end

# File lib/tmail/interface.rb, line 856
    def charset=( str )
      if str
        if h = @header[ 'content-type' ]
          h['charset'] = str
        else
          store 'Content-Type', "text/plain; charset=#{str}"
        end
      end
      str
    end

# File lib/tmail/mail.rb, line 317
    def clear
      @header.clear
    end

# File lib/tmail/interface.rb, line 720
    def content_type( default = nil )
      if h = @header['content-type']
        h.content_type || default
      else
        default
      end
    end

# File lib/tmail/interface.rb, line 1085
    def create_forward
      setup_forward create_empty_mail()
    end

# File lib/tmail/interface.rb, line 1071
    def create_reply
      setup_reply create_empty_mail()
    end

# File lib/tmail/interface.rb, line 115
    def date( default = nil )
      if h = @header['date']
        h.date
      else
        default
      end
    end

# File lib/tmail/interface.rb, line 132
    def date=( time )
      if time
        store 'Date', time2str(time)
      else
        @header.delete 'date'
      end
      time
    end

# File lib/tmail/mail.rb, line 321
    def delete( key )
      @header.delete key.downcase
    end

# File lib/tmail/mail.rb, line 325
    def delete_if
      @header.delete_if do |key,val|
        if Array === val
          val.delete_if {|v| yield key, v }
          val.empty?
        else
          yield key, val
        end
      end
    end

# File lib/tmail/net.rb, line 77
    def delete_no_send_fields
      NOSEND_FIELDS.each do |nm|
        delete nm
      end
      delete_if {|n,v| v.empty? }
    end

# File lib/tmail/interface.rb, line 1005
    def destinations( default = nil )
      ret = []
      %w( to cc bcc ).each do |nm|
        if h = @header[nm]
          h.addrs.each {|i| ret.push i.address }
        end
      end
      ret.empty? ? default : ret
    end

# File lib/tmail/interface.rb, line 918
    def disposition( default = nil )
      if h = @header['content-disposition']
        h.disposition || default
      else
        default
      end
    end

# File lib/tmail/interface.rb, line 961
    def disposition_param( name, default = nil )
      if h = @header['content-disposition']
        h[name] || default
      else
        default
      end
    end

# File lib/tmail/mail.rb, line 415
    def each( &block )
      body_port().ropen {|f| f.each(&block) }
    end

# File lib/tmail/interface.rb, line 1021
    def each_destination( &block )
      destinations([]).each do |i|
        if Address === i
          yield i
        else
          i.each(&block)
        end
      end
    end

# File lib/tmail/mail.rb, line 288
    def each_field( &block )
      @header.values.flatten.each(&block)
    end

# File lib/tmail/mail.rb, line 274
    def each_header
      @header.each do |key, val|
        [val].flatten.each {|v| yield key, v }
      end
    end

# File lib/tmail/mail.rb, line 282
    def each_header_name( &block )
      @header.each_key(&block)
    end

# File lib/tmail/mail.rb, line 464
    def each_part( &block )
      parts().each(&block)
    end

# File lib/tmail/mail.rb, line 448
    def epilogue
      parse_body
      @epilogue.dup
    end

# File lib/tmail/mail.rb, line 453
    def epilogue=( str )
      parse_body
      @epilogue = str
      str
    end

# File lib/tmail/interface.rb, line 1049
    def error_reply_addresses( default = nil )
      if s = sender(nil)
        [s]
      else
        from_addrs(default)
      end
    end

# File lib/tmail/interface.rb, line 403
    def friendly_from( default = nil )
      h = @header['from']
      a, = h.addrs
      return default unless a
      return a.phrase if a.phrase
      return h.comments.join(' ') unless h.comments.empty?
      a.spec
    end

# File lib/tmail/interface.rb, line 379
    def from( default = nil )
      addrs2specs(from_addrs(nil)) || default
    end

# File lib/tmail/interface.rb, line 392
    def from=( *strs )
      set_string_array_attr 'From', strs
    end

# File lib/tmail/interface.rb, line 349
    def from_addrs( default = nil )
      if h = @header['from']
        h.addrs
      else
        default
      end
    end

# File lib/tmail/interface.rb, line 367
    def from_addrs=( arg )
      set_addrfield 'from', arg
    end

# File lib/tmail/attachments.rb, line 15
    def has_attachments?
      multipart? && parts.any? { |part| attachment?(part) }
    end

# File lib/tmail/mail.rb, line 200
    def header
      @header.dup
    end

# File lib/tmail/interface.rb, line 49
    def header_string( name, default = nil )
      h = @header[name.downcase] or return default
      h.to_s
    end

# File lib/tmail/interface.rb, line 616
    def in_reply_to( default = nil )
      if h = @header['in-reply-to']
        h.ids
      else
        default
      end
    end

# File lib/tmail/interface.rb, line 633
    def in_reply_to=( *idstrs )
      set_string_array_attr 'In-Reply-To', idstrs
    end

# File lib/tmail/mail.rb, line 117
    def inspect
      "\#<#{self.class} port=#{@port.inspect} bodyport=#{@body_port.inspect}>"
    end

# File lib/tmail/mail.rb, line 340
    def key?( key )
      @header.key? key.downcase
    end

# File lib/tmail/mail.rb, line 336
    def keys
      @header.keys
    end

# File lib/tmail/interface.rb, line 740
    def main_type( default = nil )
      if h = @header['content-type']
        h.main_type || default
      else
        default
      end
    end

# File lib/tmail/interface.rb, line 585
    def message_id( default = nil )
      if h = @header['message-id']
        h.id || default
      else
        default
      end
    end

# File lib/tmail/interface.rb, line 600
    def message_id=( str )
      set_string_attr 'Message-Id', str
    end

# File lib/tmail/net.rb, line 92
    def mime_encode
      if parts.empty?
        mime_encode_singlepart
      else
        mime_encode_multipart true
      end
    end

# File lib/tmail/net.rb, line 116
    def mime_encode_binary( body )
      self.body = [body].pack('m')
      s