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

mime 0.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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

data/lib/mime/message.rb CHANGED

@@ -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