InlineAttachment 0.1.0

data/README

@@ -0,0 +1,39 @@
+= Inline Attachment
+
+This package adds full support for embedding inline images into your HTML emails
+through ActionMailer.
+
+It is created from a Rails patch #2179 (found at http://dev.rubyonrails.org/ticket/2179).
+
+The goal of this gem is to remove the need for manual patching.
+
+== Installation
+
+To perform a system wide installation:
+
+<tt>gem install inline_attachment</tt>
+
+To use inline_attachment in your project, add the following line to your project's
+config/environment.rb:
+
+<tt>require 'inline_attachment'</tt>
+
+
+== Usage
+
+The code to add inline attachments into your HTML emails is pretty simple:
+
+	@cid = Time.now.to_f.to_s + "foobar.png@domain.com"
+ 
+	inline_attachment :content_type => "image/png", 
+	                  :body => File.read("#{RAILS_ROOT}/public/images/foobar.png"),
+	                  :filename => "foobar.png",
+	                  :cid => "<#{@cid}>"
+	
+Note that the above code should go into your ActionMailer.
+
+The instance variable @cid is the unique identifier your MIME email will be using to
+locate the attached image. All you have to do is then pass it over to your email
+template, and display it like so:
+
+	<img src="cid:<%= @cid %>" alt="Foo Bar" />

data/lib/inline_attachment.rb

@@ -0,0 +1,68 @@
+module ActionMailer
+  
+  module PartContainer
+
+    # Add an inline attachment to a multipart message. 
+    def inline_attachment(params, &block)
+      params = { :content_type => params } if String === params
+      params = { :disposition => "inline",
+                 :transfer_encoding => "base64" }.merge(params)
+      params[:headers] ||= {}
+      params[:headers]['Content-ID'] = params[:cid]
+      part(params, &block)
+    end
+
+  end
+
+  class Part 
+
+    def to_mail(defaults)
+      part = TMail::Mail.new
+
+      if @parts.empty?
+        part.content_transfer_encoding = transfer_encoding || "quoted-printable"
+        case (transfer_encoding || "").downcase
+          when "base64" then
+            part.body = TMail::Base64.folding_encode(body)
+          when "quoted-printable"
+            part.body = [Utils.normalize_new_lines(body)].pack("M*")
+          else
+            part.body = body
+        end
+
+        # Always set the content_type after setting the body and or parts
+
+        # CHANGE: treat attachments and inline files the same
+        if content_disposition == "attachment" || ((content_disposition == "inline") && filename)
+            part.set_content_type(content_type || defaults.content_type, nil,
+            squish("charset" => nil, "name" => filename))
+        else
+          part.set_content_type(content_type || defaults.content_type, nil,
+            "charset" => (charset || defaults.charset))    
+        end  
+                     
+        part.set_content_disposition(content_disposition, squish("filename" => filename)) unless content_disposition.blank?
+        headers.each {|k,v| part[k] = v }
+        # END CHANGE
+
+      else
+        if String === body
+          part = TMail::Mail.new
+          part.body = body
+          part.set_content_type content_type, nil, { "charset" => charset }
+          part.set_content_disposition "inline"
+          m.parts << part
+        end
+          
+        @parts.each do |p|
+          prt = (TMail::Mail === p ? p : p.to_mail(defaults))
+          part.parts << prt
+        end
+        
+        part.set_content_type(content_type, nil, { "charset" => charset }) if content_type =~ /multipart/
+      end
+    
+      part
+    end
+  end
+end

data/lib/tmail_content_id.rb

@@ -0,0 +1,40 @@
+module TMail
+
+  class HeaderField   # redefine
+  
+      FNAME_TO_CLASS = {
+        'date'                      => DateTimeHeader,
+        'resent-date'               => DateTimeHeader,
+        'to'                        => AddressHeader,
+        'cc'                        => AddressHeader,
+        'bcc'                       => AddressHeader,
+        'from'                      => AddressHeader,
+        'reply-to'                  => AddressHeader,
+        'resent-to'                 => AddressHeader,
+        'resent-cc'                 => AddressHeader,
+        'resent-bcc'                => AddressHeader,
+        'resent-from'               => AddressHeader,
+        'resent-reply-to'           => AddressHeader,
+        'sender'                    => SingleAddressHeader,
+        'resent-sender'             => SingleAddressHeader,
+        'return-path'               => ReturnPathHeader,
+        'message-id'                => MessageIdHeader,
+        'resent-message-id'         => MessageIdHeader,
+        'in-reply-to'               => ReferencesHeader,
+        'received'                  => ReceivedHeader,
+        'references'                => ReferencesHeader,
+        'keywords'                  => KeywordsHeader,
+        'encrypted'                 => EncryptedHeader,
+        'mime-version'              => MimeVersionHeader,
+        'content-type'              => ContentTypeHeader,
+        'content-transfer-encoding' => ContentTransferEncodingHeader,
+        'content-disposition'       => ContentDispositionHeader,
+       # 'content-id'                => MessageIdHeader,
+        'subject'                   => UnstructuredHeader,
+        'comments'                  => UnstructuredHeader,
+        'content-description'       => UnstructuredHeader
+      }
+  
+  end
+
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.2
+specification_version: 1
+name: InlineAttachment
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+date: 2007-06-01 00:00:00 +10:00
+summary: "A package created from a Rails patch (ticket #2179) that adds embedded images into ActionMailer."
+require_paths: 
+- lib
+email: edmond.leung@handle.it
+homepage: 
+rubyforge_project: 
+description: 
+autorequire: inline_attachment
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Edmond Leung
+files: 
+- lib/inline_attachment.rb
+- lib/tmail_content_id.rb
+- README
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+