RubyGems - mime - Versions diffs - 0.1 → 0.2.0 - Mend

mime 0.1 → 0.2.0

Files changed (29) hide show

data/README.rdoc +303 -0
data/Rakefile +8 -24
data/lib/mime.rb +1 -1
data/lib/mime/discrete_media_factory.rb +2 -3
data/lib/mime/headers/internet.rb +15 -13
data/lib/mime/headers/mime.rb +18 -18
data/lib/mime/message.rb +10 -0
data/mime.gemspec +18 -0
data/test/scaffold/application.msg +4 -4
data/test/scaffold/audio.msg +3 -3
data/test/scaffold/{index.html → data.htm} +0 -0
data/test/scaffold/image.msg +0 -0
data/test/scaffold/multipart_alternative.msg +10 -12
data/test/scaffold/multipart_alternative_related.msg +0 -0
data/test/scaffold/multipart_form_data_file_and_text.msg +0 -0
data/test/scaffold/multipart_form_data_mixed.msg +0 -0
data/test/scaffold/multipart_form_data_text.msg +31 -26
data/test/scaffold/multipart_mixed_inline_and_attachment.msg +0 -0
data/test/scaffold/multipart_mixed_inline_and_attachment2.msg +0 -0
data/test/scaffold/multipart_related.msg +0 -0
data/test/scaffold/plain_text_email.msg +9 -7
data/test/scaffold/text.msg +2 -2
data/test/scaffold/video.msg +4 -4
data/test/test_mime.rb +417 -0
data/test/test_mime.rb-try +616 -0
metadata +53 -51
data/README +0 -256
data/test/mime_test.rb +0 -386
data/test/scaffold/multipart_form_data_file.msg +0 -0

@@ -43,6 +43,16 @@ module MIME
       # standards compliant message.
       #++
+      # FIXME writing directly to body VS setting body with a MediaType gives an
+      # imbalance of "\r\n". Setting body directly with string requires a CRLF
+      # prepended, but not the case for TextMedia for instance. So where do we
+      # handle this? Perhaps HeaderContainer#to_s should append a CRLF, or
+      # self#body should detect String and automatically prepend CRLF??? Then we
+      # remove the CRLF here between the headers and body.
+      #
+      # Also, TextMedia adds the Content-ID and Content-Type headers, which we
+      # don't get if body is set directly with String. Does this matter?
       "#{headers}\r\n#{body}\r\n"
     end

data/mime.gemspec ADDED

@@ -0,0 +1,18 @@
+version = File.read('./lib/mime.rb')[/VERSION = '(.*)'/, 1]
+Gem::Specification.new('mime', version) do |s|
+  s.author      = 'Clint Pachl'
+  s.email       = 'pachl@ecentryx.com'
+  s.homepage    = 'http://ecentryx.com/gems/mime'
+  s.license     = 'ISC'
+  s.summary     = 'Multipurpose Internet Mail Extensions (MIME) Library'
+  s.description = <<-EOF
+A library for building RFC compliant Multipurpose Internet Mail Extensions
+(MIME) messages. It can be used to construct standardized MIME messages for use
+in client/server communications, such as Internet mail or HTTP
+multipart/form-data transactions.
+  EOF
+  s.files       = Dir['README.rdoc', 'Rakefile', 'mime.gemspec',
+                      'lib/**/*.rb', 'test/**/*']
+  s.test_files  = Dir['test/*.rb']
+end

data/test/scaffold/application.msg CHANGED

@@ -1,8 +1,8 @@
-Message-ID: <350015069@1033007998>
 Date: Wed, 29 Oct 2008 22:02:00 -0700
-MIME-Version: 1.0 (Ruby MIME v0.1)
+Message-ID: <350015069@1033007998>
+MIME-Version: 1.0 (Ruby MIME v0.2.0)
 Content-ID: <10330079680.971971651113797>
-Content-Transfer-Encoding: binary
 Content-Type: application/octet-stream
+Content-Transfer-Encoding: binary
-011000100110100101101110011000010111001001111001
+0110000101110101011001000110100101101111

data/test/scaffold/audio.msg CHANGED

@@ -1,8 +1,8 @@
-Message-ID: <738362674@978907908>
 Date: Wed, 29 Oct 2008 22:06:46 -0700
-MIME-Version: 1.0 (Ruby MIME v0.1)
+Message-ID: <738362674@978907908>
+MIME-Version: 1.0 (Ruby MIME v0.2.0)
 Content-ID: <9789078880.11546613041526>
-Content-Transfer-Encoding: binary
 Content-Type: audio/midi
+Content-Transfer-Encoding: binary
 0110000101110101011001000110100101101111

data/test/scaffold/{index.html → data.htm} RENAMED

File without changes

data/test/scaffold/image.msg CHANGED

Binary file

data/test/scaffold/multipart_alternative.msg CHANGED

@@ -1,17 +1,15 @@
-Content-ID: <9825632980.129140062591039>
-Content-Type: multipart/alternative; boundary=Boundary_9825632980.209951487532625
+Content-ID: <154873488180000.3045551269054866>
+Content-Type: multipart/alternative; boundary=Boundary_154873488180000.5284747660488839
---Boundary_9825632980.209951487532625
-Content-ID: <9825630380.420138704080548>
-Content-Type: text/plain; charset=us-ascii
+--Boundary_154873488180000.5284747660488839
+Content-ID: <154873488189000.6392244491224042>
+Content-Type: text/enhanced; charset=us-ascii
 *Header*
-message
---Boundary_9825632980.209951487532625
-Content-ID: <9825630480.371191475053649>
+message
+--Boundary_154873488180000.5284747660488839
+Content-ID: <154873488185800.3424043482513621>
 Content-Type: text/html; charset=iso-8859-1
-<html><body><h1>Header</h1><p>message</p></body></html>
---Boundary_9825632980.209951487532625--
+<html><body><h1>Header</h1><p>message</p></body></html>
+--Boundary_154873488180000.5284747660488839--

data/test/scaffold/multipart_alternative_related.msg CHANGED

Binary file

data/test/scaffold/multipart_form_data_file_and_text.msg CHANGED

Binary file

data/test/scaffold/multipart_form_data_mixed.msg CHANGED

Binary file

data/test/scaffold/multipart_form_data_text.msg CHANGED

@@ -1,22 +1,33 @@
-Content-ID: <10552388980.162896129188505>
-Content-Type: multipart/form-data; boundary=Boundary_10552388980.858426568801724
+Content-ID: <88135231713600.7894413004791365>
+Content-Type: multipart/form-data; boundary=Boundary_88135231713600.3996846921776409
---Boundary_10552388980.858426568801724
-Content-ID: <10552388580.731954240756742>
-Content-Disposition: form-data; name="txt3"
-Content-Type: text/html
+--Boundary_88135231713600.3996846921776409
+Content-ID: <88135231717000.5720607746781624>
+Content-Type: text/xml
+Content-Disposition: form-data; name="xml"
-<html>
-<body>
-<h1>Sample HTML File</h1>
-<p>this is the body</p>
-</body>
-</html>
+<media_types abstract="true">
+	<discrete_media_types abstract="true">
+		<application_media></application_media>
+		<audio_media></audio_media>
+		<image_media></image_media>
+		<text_media></text_media>
+		<video_media></video_media>
+	</discrete_media_types>
+	<composite_media_types abstract="true">
+		<multipart_media abstract="true">
+			<form_data></form_data>
+			<alternative></alternative>
+		</multipart>
+		<message_media>
+		</message_media>
+	</composite>
+</media_types>
---Boundary_10552388980.858426568801724
-Content-ID: <10552388580.731954240756742>
-Content-Disposition: form-data; name="txt3"
+--Boundary_88135231713600.3996846921776409
+Content-ID: <88135231721400.4415016053712104>
 Content-Type: text/html
+Content-Disposition: form-data; name="htm"
 <html>
 <body>
@@ -25,16 +36,10 @@ Content-Type: text/html
 </body>
 </html>
---Boundary_10552388980.858426568801724
-Content-ID: <10552385980.313922062472258>
-Content-Disposition: form-data; name="txt2"
-Content-Type: text/enhanced
-this is t2
---Boundary_10552388980.858426568801724
-Content-ID: <10552385480.358570542235564>
-Content-Disposition: form-data; name="txt1"
+--Boundary_88135231713600.3996846921776409
+Content-ID: <88135231725400.11623307734175536>
 Content-Type: text/plain; charset=us-ascii
+Content-Disposition: form-data; name="txt"
-this is t1
---Boundary_10552388980.858426568801724--
+text body
+--Boundary_88135231713600.3996846921776409--

data/test/scaffold/multipart_mixed_inline_and_attachment.msg CHANGED

Binary file

data/test/scaffold/multipart_mixed_inline_and_attachment2.msg CHANGED

Binary file

data/test/scaffold/multipart_related.msg CHANGED

Binary file

data/test/scaffold/plain_text_email.msg CHANGED

@@ -1,9 +1,11 @@
-Cc: bossman@domain.com <Head Honcho>
+Date: Tue, 17 Dec 2013 04:54:56 -0700
+Message-ID: <776432154@10297424291820>
+MIME-Version: 1.0 (Ruby MIME v0.0.0)
+To: John <john@example.com>, paul@example.com, Mary <mary@example.com>
+Cc: boss@example.com <Head Honcho>
+From: jane@example.com
 Subject: This is an important email
-Message-ID: <474040392@1043863700>
-From: person4@domain.com
-To: Mary <person3@domain.com>, person2@domain.com, Harry <person1@domain.com>
-Date: Mon, 27 Oct 2008 07:08:50 -0700
-MIME-Version: 1.0 (Ruby MIME v0.1)
+Content-ID: <102975158103800.7998663631497803>
+Content-Type: text/plain; charset=us-ascii
-This is the all important email body
+Hello, world!

data/test/scaffold/text.msg CHANGED

@@ -1,6 +1,6 @@
-Message-ID: <357114433@1021851988>
 Date: Wed, 29 Oct 2008 14:55:34 -0700
-MIME-Version: 1.0 (Ruby MIME v0.1)
+Message-ID: <357114433@1021851988>
+MIME-Version: 1.0 (Ruby MIME v0.1.0)
 Content-ID: <10218519780.0838656876757202>
 Content-Type: text/plain; charset=us-ascii

data/test/scaffold/video.msg CHANGED

@@ -1,8 +1,8 @@
-Message-ID: <740518531@1061166128>
 Date: Wed, 29 Oct 2008 21:56:48 -0700
-MIME-Version: 1.0 (Ruby MIME v0.1)
+Message-ID: <740518531@1061166128>
+MIME-Version: 1.0 (Ruby MIME v0.1.0)
 Content-ID: <10611659780.38729886896997>
-Content-Transfer-Encoding: binary
 Content-Type: video/mpeg
+Content-Transfer-Encoding: binary
-0111011001101001011001000110010101101111
+0110000101110101011001000110100101101111

data/test/test_mime.rb ADDED

@@ -0,0 +1,417 @@
+gem 'minitest'  # minitest in 1.9 stdlib is crufty
+require 'minitest/autorun'
+require 'mime'
+Encoding.default_external = 'ASCII-8BIT'  # may be able to remove in 2.0
+class MIMETest < Minitest::Test
+  CRLF = "\r\n"
+  BINARY_DATA = '0110000101110101011001000110100101101111'
+  ### DISCRETE MESSAGE CONSTRUCTION (SINGLE ENTITY) ###
+  def test_make_top_level_rfc2822_message
+    msg = MIME::Message.new
+    msg.body = "\r\nmessage body"
+    headers, body = msg.to_s.split(CRLF*2)
+    assert_match(/^Message-ID: <\d+@\d+>/, headers)
+    assert_match(/^Date: ..., \d{1,2} ... \d{4} \d\d:\d\d:\d\d -\d{4}/, headers)
+    assert_match(/^MIME-Version: 1.0 \(Ruby MIME v\d\.\d\.\d\)/, headers)
+    assert_equal 3, headers.split(CRLF).count
+    assert_equal "message body", body.chomp
+  end
+  def test_make_audio_message
+    audio_media = MIME::AudioMedia.new(BINARY_DATA, 'audio/midi')
+    audio_media.content_transfer_encoding = 'binary'
+    assert_equal_mime_msg 'audio.msg', MIME::Message.new(audio_media)
+  end
+  def test_make_application_message
+    app_media = MIME::ApplicationMedia.new(BINARY_DATA)
+    app_media.content_transfer_encoding = 'binary'
+    assert_equal_mime_msg 'application.msg', MIME::Message.new(app_media)
+  end
+  def test_make_image_message
+    image = IO.read(sd('image.jpg'))
+    image_media = MIME::ImageMedia.new(image)
+    image_media.content_type = 'image/jpeg'
+    image_media.content_transfer_encoding = 'binary'
+    assert_equal_mime_msg 'image.msg', MIME::Message.new(image_media)
+  end
+  def test_make_text_message
+    body = MIME::TextMedia.new('a plain text message')
+    assert_equal_mime_msg 'text.msg', MIME::Message.new(body)
+  end
+  def test_make_video_message
+    video_media = MIME::VideoMedia.new(BINARY_DATA)
+    video_media.content_type = 'video/mpeg'
+    video_media.content_transfer_encoding = 'binary'
+    assert_equal_mime_msg 'video.msg', MIME::Message.new(video_media)
+  end
+  def test_construction_of_plain_text_email_message
+    email = MIME::Message.new
+    email.to = {
+      'john@example.com' => 'John',
+      'paul@example.com' => nil,
+      'mary@example.com' => 'Mary'
+    }
+    email.cc = {'Head Honcho' => 'boss@example.com'}
+    email.from = {'jane@example.com' => nil}
+    email.subject = 'This is an important email'
+    email.body = MIME::TextMedia.new('Hello, world!')
+    assert_equal_mime_msg 'plain_text_email.msg', email
+  end
+  ### COMPOSITE MESSAGE CONSTRUCTION (MULTIPLE ENTITIES) ###
+  def test_multipart_form_data_with_text_entities
+    txt_data = 'text body'
+    htm_data = IO.read(sd('data.htm'))
+    xml_data = IO.read(sd('data.xml'))
+    txt = MIME::TextMedia.new(txt_data)
+    htm = MIME::TextMedia.new(htm_data, 'text/html')
+    xml = MIME::TextMedia.new(xml_data, 'text/xml')
+    form = MIME::MultipartMedia::FormData.new
+    form.add_entity txt, 'txt'
+    form.add_entity htm, 'htm'
+    form.add_entity xml, 'xml'
+    assert_equal_mime_msg 'multipart_form_data_text.msg', form
+  end
+  def test_multipart_form_data_with_text_and_file_entities
+    img1_filename = 'image.jpg'
+    img2_filename = 'ruby.png'
+    img1_data = IO.read(sd(img1_filename))
+    img2_data = IO.read(sd(img2_filename))
+    img1 = MIME::ImageMedia.new(img1_data, 'image/jpeg')
+    img2 = MIME::ImageMedia.new(img2_data, 'image/png')
+    img1.content_transfer_encoding = '8bit'
+    img2.content_transfer_encoding = '8bit'
+    desc_data = 'This is plain text description of images.'
+    desc = MIME::TextMedia.new(desc_data)
+    form = MIME::MultipartMedia::FormData.new
+    form.add_entity desc, 'description'
+    form.add_entity img2, 'image_2', img2_filename
+    form.add_entity img1, 'image_1', img1_filename
+    assert_equal_mime_msg 'multipart_form_data_file_and_text.msg', form
+  end
+  # Similar to example 6 in RFC1867.
+  def test_multipart_form_data_with_mixed_entity
+    txt = MIME::TextMedia.new('Joe Blow')
+    img1 = MIME::DiscreteMediaFactory.create(sd('image.jpg'))
+    img2 = MIME::DiscreteMediaFactory.create(sd('ruby.png'))
+    mixed_msg = MIME::MultipartMedia::Mixed.new
+    mixed_msg.attach_entity(img2)
+    mixed_msg.attach_entity(img1)
+    form = MIME::MultipartMedia::FormData.new
+    form.add_entity(mixed_msg, 'pics')
+    form.add_entity(txt, 'field1')
+    assert_equal_mime_msg 'multipart_form_data_mixed.msg', form
+  end
+  def test_multipart_alternative_message
+    txt_data = "*Header*\nmessage"
+    htm_data = "<html><body><h1>Header</h1><p>message</p></body></html>"
+    txt_msg = MIME::TextMedia.new(txt_data)
+    htm_msg = MIME::TextMedia.new(htm_data)
+    txt_msg.content_type = ('text/enhanced; charset=us-ascii')
+    htm_msg.content_type = ('text/html; charset=iso-8859-1')
+    msg = MIME::MultipartMedia::Alternative.new
+    msg.add_entity htm_msg
+    msg.add_entity txt_msg
+    assert_equal_mime_msg 'multipart_alternative.msg', msg
+  end
+  def test_multipart_alternative_with_related_html_entity
+    img = MIME::DiscreteMediaFactory.create(sd('ruby.png'))
+    img.content_transfer_encoding = 'binary'
+    html_msg = MIME::TextMedia.new(<<EOF, 'text/html; charset=iso-8859-1')
+<html>
+<body>
+  <h1>HTML multipart/alternative message</h1>
+  <p>txt before pix</p>
+  <img alt="cool ruby" src="cid:#{img.content_id}"/>
+  <p>txt after pix</p>
+</body>
+</html>
+EOF
+    html_msg.content_transfer_encoding = '7bit'
+    text_msg = MIME::TextMedia.new(<<EOF)
+*HTML multipart/alternative message*
+txt before pix
+<cool ruby image>
+txt after pix
+EOF
+    text_msg.content_transfer_encoding = '7bit'
+    related_msg = MIME::MultipartMedia::Related.new
+    related_msg.inline_entity(img)
+    related_msg.add_entity(html_msg)
+    msg = MIME::MultipartMedia::Alternative.new
+    msg.add_entity(related_msg)
+    msg.add_entity(text_msg)
+    assert_equal_mime_msg 'multipart_alternative_related.msg', msg
+  end
+  def test_multipart_mixed_with_inline_and_attachment
+    msg = MIME::MultipartMedia::Mixed.new
+    open(sd('image.jpg')) do |img_file|
+      img_data = img_file.read
+      img_msg = MIME::ImageMedia.new(img_data, 'image/jpeg')
+      msg.attach_entity(img_msg, 'filename' => img_file.path)
+    end
+    msg.inline_entity(MIME::TextMedia.new('Plain Text'))
+    assert_equal_mime_msg 'multipart_mixed_inline_and_attachment.msg', msg
+  end
+  def test_multipart_mixed_message_using_media_factory
+    bot_img = MIME::DiscreteMediaFactory.create(sd('image.jpg'))
+    top_img = MIME::DiscreteMediaFactory.create(sd('ruby.png'))
+    top_txt = MIME::DiscreteMediaFactory.create(sd('data.htm'))
+    msg = MIME::MultipartMedia::Mixed.new
+    msg.attach_entity(bot_img)
+    msg.attach_entity(top_img)
+    msg.inline_entity(top_txt)
+    assert_equal_mime_msg 'multipart_mixed_inline_and_attachment2.msg', msg
+  end
+  def test_multipart_related_html_message_with_embedded_image
+    img = MIME::DiscreteMediaFactory.create(sd('/ruby.png'))
+    img.content_transfer_encoding = 'binary'
+    html_msg = MIME::TextMedia.new(<<EOF, 'text/html; charset=iso-8859-1')
+<html>
+<body>
+  <h1>HTML multipart/related message</h1>
+  <p>
+    txt before pix
+    <img alt="cool ruby" src="cid:#{img.content_id}">
+  </p>
+  <p>txt after pix</p>
+</body>
+</html>
+EOF
+    html_msg.content_transfer_encoding = '7bit'
+    msg = MIME::MultipartMedia::Related.new
+    msg.inline_entity(img)
+    msg.add_entity(html_msg)
+    assert_equal_mime_msg 'multipart_related.msg', msg
+  end
+  ### GENERAL RFC ADHERENCE ###
+  def test_boundary_format
+    form = MIME::MultipartMedia::FormData.new
+    %w(one two three four).each do |ent|
+      form.add_entity(MIME::TextMedia.new(ent), ent)
+    end
+    boundary = form.to_s.scan(/--Boundary_.*\r\n/).each
+    first_boundary = boundary.next
+    assert_equal first_boundary, boundary.next
+    assert_equal first_boundary, boundary.next
+    assert_equal first_boundary, boundary.next
+    refute_equal first_boundary, (last_boundary = boundary.next)
+    assert_match(/^--Boundary_\d+\.\d+\r\n/, first_boundary)
+    assert_match(/^--Boundary_\d+\.\d+--\r\n/, last_boundary)
+  end
+  def test_unique_content_ids_in_multipart_message
+    form = MIME::MultipartMedia::FormData.new
+    %w(one two three four).each do |ent|
+      form.add_entity(MIME::TextMedia.new(ent), ent)
+    end
+    # 5 IDs: main header ID + 4 entity IDs
+    content_ids = form.to_s.scan(/^Content-ID: <(\d+.\d+)>/)
+    assert_equal 5, content_ids.flatten.uniq.count  # IDs must be unique
+  end
+  def test_content_disposition_filenames
+    filename1 = 'book.pdf'
+    filename2 = 'mini.mov'
+    filename3 = 'song.mp3'
+    filename4 = 'none.txt'
+    filename5 = 'none.htm'
+    file1 = MIME::DiscreteMediaFactory.create(sd filename1)
+    file2 = MIME::DiscreteMediaFactory.create(sd filename2)
+    file3 = MIME::DiscreteMediaFactory.create(sd filename3)
+    file4 = MIME::TextMedia.new('txt')
+    file5 = MIME::TextMedia.new('htm')
+    file6 = MIME::TextMedia.new('xml')
+    form = MIME::MultipartMedia::FormData.new
+    # file backed objects
+    form.add_entity file1, 'file_1'                      # none
+    form.add_entity file2, 'file_2', filename2           # relative
+    form.add_entity file3, 'file_3', "/tmp/#{filename3}" # absolute
+    # non-file backed objects
+    form.add_entity file4, 'file_4', "/tmp/#{filename4}" # absolute
+    form.add_entity file5, 'file_5', filename5           # relative
+    form.add_entity file6, 'file_6'                      # none
+    msg = form.to_s
+    hdr = 'Content-Disposition: form-data;'
+    # only the file basename should be assigned to filename, never a path
+    assert_match(/^#{hdr} name="file_1"; filename="#{filename1}"\r\n/, msg)
+    assert_match(/^#{hdr} name="file_2"; filename="#{filename2}"\r\n/, msg)
+    assert_match(/^#{hdr} name="file_3"; filename="#{filename3}"\r\n/, msg)
+    assert_match(/^#{hdr} name="file_4"; filename="#{filename4}"\r\n/, msg)
+    assert_match(/^#{hdr} name="file_5"; filename="#{filename5}"\r\n/, msg)
+    assert_match(/^#{hdr} name="file_6"\r\n/, msg)
+  end
+  ### LIBRARY OPERATION ###
+  def test_no_instantiation_of_abstract_classes
+    e = MIME::AbstractClassError
+    assert_raises(e) {MIME::MediaType.new(nil, nil)}
+    assert_raises(e) {MIME::DiscreteMediaType.new(nil)}
+    assert_raises(e) {MIME::CompositeMediaType.new(nil)}
+    assert_raises(e) {MIME::MultipartMedia.new(nil)}
+  end
+  def test_content_type_detection
+    (o = Object.new).extend(MIME::ContentTypes)
+    # test file extension; file path is irrelevant here
+    assert_equal 'application/pdf',          o.file_type('a.pdf')
+    assert_equal 'video/quicktime',          o.file_type('b.mov')
+    assert_equal 'application/octet-stream', o.file_type('c.iso')
+    assert_equal 'audio/mpeg',               o.file_type('/d/e.mp3')
+    assert_equal 'text/css',                 o.file_type('/f/g/h.css')
+    assert_equal nil,                        o.file_type('i.nil')
+    # test using file object
+    img_type = open(sd('ruby.png')) {|f| o.file_type(f)}
+    assert_equal 'image/png',  img_type
+    refute_equal 'image/jpeg', img_type
+  end
+  def test_object_instantiation_using_discrete_media_factory
+    app_file     = sd('book.pdf')
+    audio_file   = sd('song.mp3')
+    text_file    = sd('data.xml')
+    video_file   = sd('mini.mov')
+    image_file   = sd('image.jpg')
+    unknown_file = sd('unknown.yyy')
+    dmf = MIME::DiscreteMediaFactory
+    # test using file path
+    assert_kind_of MIME::ApplicationMedia, dmf.create(app_file)
+    assert_kind_of MIME::AudioMedia,       dmf.create(audio_file)
+    assert_kind_of MIME::TextMedia,        dmf.create(text_file)
+    assert_kind_of MIME::VideoMedia,       dmf.create(video_file)
+    assert_kind_of MIME::ImageMedia,       dmf.create(image_file)
+    # test using file object
+    open(image_file) do |image_file_obj|
+      assert_kind_of MIME::ImageMedia, dmf.create(image_file_obj)
+    end
+    open(text_file) do |text_file_obj|
+      assert_kind_of MIME::TextMedia, dmf.create(text_file_obj)
+    end
+    # raise for unknown file path and File object
+    assert_raises(MIME::UnknownContentError) {dmf.create(unknown_file)}
+    open(unknown_file) do |unknown_file_obj|
+      assert_raises(MIME::UnknownContentError) {dmf.create(unknown_file_obj)}
+    end
+  end
+  def test_discrete_media_factory_with_specified_invalid_conent_type
+    invalid_ctype1 = 'application-x/pdf'
+    invalid_ctype2 = 'application'
+    valid_ctype    = 'application/pdf'
+    pdf = sd('book.pdf')
+    assert_raises(MIME::UnknownContentError) {
+      MIME::DiscreteMediaFactory.create(pdf, invalid_ctype1)
+    }
+    assert_raises(MIME::UnknownContentError) {
+      MIME::DiscreteMediaFactory.create(pdf, invalid_ctype2)
+    }
+    assert MIME::DiscreteMediaFactory.create(pdf, valid_ctype)
+  end
+  def test_discrete_media_factory_creates_path_singleton_method
+    pdf_file_path = sd('book.pdf')
+    media_obj = MIME::DiscreteMediaFactory.create(pdf_file_path)
+    assert_equal pdf_file_path, media_obj.path
+    open(pdf_file_path) do |pdf_file_obj|
+      media_obj = MIME::DiscreteMediaFactory.create(pdf_file_obj)
+      assert_equal pdf_file_path, media_obj.path
+    end
+  end
+  private
+  #
+  # Test equality of the +expected+ and +actual+ MIME messages.
+  #
+  def assert_equal_mime_msg expected, actual
+    m1 = generalize_msg(IO.read(sd(expected)))
+    m2 = generalize_msg(actual.to_s)
+    assert_equal m1, m2
+  end
+  #
+  # Remove unique identifiers to make +message+ structurally comparable.
+  #
+  def generalize_msg message
+    # Very delicate REs that are inter-dependent, be careful!
+    cid      = /cid:\d+\.\d+/
+    id       = /-ID: <\d+[@.]\d+>\r\n/
+    boundary = /Boundary_\d+\.\d+/
+    date     = /^Date: .* -\d{4}\r\n/
+    version  = /Ruby MIME v\d\.\d\.\d/
+    message.
+      gsub(cid,      "cid").
+      gsub(id,       "-ID:\r\n").
+      gsub(boundary, "Boundary_").
+      sub(date,      "Date:\r\n").
+      sub(version,   "Ruby MIME")
+  end
+  #
+  # Return the path of the scaffold +file+.
+  #
+  def sd file
+    File.join(File.dirname(__FILE__), 'scaffold', file)
+  end
+end