aklaiber-mail 0.1.2

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Alexander Klaiber
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,66 @@
+Mail Lib
+
+An mail parsing lib.
+
+== Features
+
+* clean API
+* fast mail parsing
+
+== Installation
+
+gem sources -a http://gems.github.com
+
+sudo gem install aklaiber-mail
+
+== Usage
+
+Create new Mail
+
+    mail = Mail::Mail.new
+    mail.header.to = "test_to@test.de"
+    mail.header.from = "test_from@test.de"
+    mail.header.subject = "Test Mail"
+    mail.header.content_transfer_encoding = "quoted-printable"
+    mail.header.content_type = {charset => "UTF-8"}
+    mail.add_part("text/plain", "Hallo World !!!")
+
+Create new Mail with Text and HTML part
+
+    mail = Mail::Mail.new
+    mail.header.to = "test_to@test.de"
+    mail.header.from = "test_from@test.de"
+    mail.header.subject = "Test Mail"
+    mail.header.content_transfer_encoding = "quoted-printable"
+    mail.header.content_type(:charset) = "UTF-8"
+    mail.add_part("text/plain", "Hallo World !!!")
+    mail.add_part("text/html", "<strong>Hallo World !!!</strong>")
+
+Create new Mail Attachment
+
+    mail = Mail::Mail.new
+    mail.header.to = "test_to@test.de"
+    mail.header.from = "test_from@test.de"
+    mail.header.subject = "Test Mail"
+    mail.header.content_transfer_encoding = "quoted-printable"
+    mail.header.content_type(:charset) = "UTF-8"
+    mail.add_part("text/plain", "Hallo World !!!")
+    mail.add_part("image/jpeg", File.read("path/to/image"))
+ 
+Load an existing Mail
+
+      mail = Mail::Mail.new(File.read("path/to/mail"))
+
+      puts mail.header.to  => ["test_to@test.de"]
+    
+Get attachments from a Mail
+
+    mail = Mail::Mail.new(File.read("path/to/mail"))
+
+    if mail.header.attachments?
+        mail.attachments do |attachment|
+            puts attachment.header.content_type(:main)   =>   "image/tiff"
+            puts attachment.header.content_disposition(:filename)  =>  "fax.tif"
+            puts attachment.size  =>  408850
+        end
+    end

data/Rakefile

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/testtask'
+require File.join(File.expand_path(File.dirname(__FILE__)),'lib','mail')
+
+spec = Gem::Specification.new do |s|
+  s.name = 'mail'
+  s.version = Mail::VERSION
+  s.has_rdoc = true
+  s.extra_rdoc_files = ['README', 'LICENSE']
+  s.summary = 'Mail Parsing lib'
+  s.description = s.summary
+  s.author = 'Alexander Klaiber'
+  s.email = 'aklaiber@mybrief.de'
+  s.files = %w(LICENSE README Rakefile) + Dir.glob("{bin,lib,spec,config}/**/*")
+  s.require_path = "lib"
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+  p.need_tar = true
+  p.need_zip = true
+end
+
+Rake::RDocTask.new do |rdoc|
+  files =['README', 'LICENSE', 'lib/**/*.rb']
+  rdoc.rdoc_files.add(files)
+  rdoc.main = "README" 
+  rdoc.title = "mail Docs"
+  rdoc.rdoc_dir = 'doc/rdoc'
+  rdoc.options << '--line-numbers'
+end
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/**/*.rb']
+end
+
+desc "Create .gemspec file (useful for github)"
+task :gemspec do
+  filename = "#{spec.name}.gemspec"
+  File.open(filename, "w") do |f|
+    f.puts spec.to_ruby
+  end
+end
+
+desc "Install the gem locally"
+task :install => [:package] do
+  sh %{sudo gem install pkg/couchrest-#{CouchRest::VERSION}}
+end
+
+

data/config/config.yml

@@ -0,0 +1,11 @@
+header_params_allowd: 
+    - return_path
+    - date
+    - from
+    - to
+    - reply_to
+    - message_id
+    - subject
+    - content_type
+    - content_transfer_encoding
+    - content_disposition

data/lib/mail.rb

@@ -0,0 +1,138 @@
+require "#{File.dirname(__FILE__)}/mail/utils"
+require "#{File.dirname(__FILE__)}/mail/header"
+require "#{File.dirname(__FILE__)}/mail/header_param"
+require "#{File.dirname(__FILE__)}/mail/part"
+require "#{File.dirname(__FILE__)}/mail/attachment"
+require 'iconv'
+require 'yaml'
+
+module Mail
+
+  VERSION = '0.1.2' unless self.const_defined?("VERSION")
+
+  class Mail
+    attr_reader :header, :parts
+
+    include Utils
+
+    def initialize(str = nil)
+      @content_typs = Array.new
+      @header = Header.new
+      @parts = Array.new
+      if str
+        str = encode_utf8(str)
+        set_header(str)
+        set_parts(str)
+      end
+    end
+
+    def add_part(content_type, content)
+      if content_type.eql?('text/plain') || content_type.eql?('text/html')
+        @parts.push(Part.new(:content_type => content_type, :content => content))
+      else
+        @parts.push(Attachment.new(:content_type => content_type, :content => Base64.encode64(content)))
+      end
+      @content_typs.push(content_type)
+      set_content_type
+    end
+
+    def part(type)
+      parts.each do |part|
+        if part.header.content_type(:main).eql?(type)
+          return part
+        end
+      end
+      return nil
+    end
+
+    def text_parts
+      parts.each do |part|
+        if part.header.content_type(:main).eql?('text/plain') || part.header.content_type(:main).eql?('text/html')
+          yield part
+        end
+      end
+    end
+
+    def attachments
+      parts.each do |part|        
+        if !part.header.content_type(:main).eql?('text/plain') && !part.header.content_type(:main).eql?('text/html')
+          yield part
+        end
+      end
+    end
+
+    def to_s
+      mail = @header.to_s
+      mail << "\n\n"
+      @parts.each do |part|
+        if @header.content_type(:boundary)
+          mail << "--#{@header.content_type(:boundary)}\n"
+          mail << part.header.content_type.to_s
+          mail << "\n\n"
+        end
+        mail << part.to_s
+        mail << "\n\n" if @header.content_type(:boundary)
+      end
+      mail << "--#{@header.content_type(:boundary)}--" if @header.content_type(:boundary)
+      return mail
+    end
+
+    def to_json
+      parts_buffer = Array.new
+      parts.each do |part|
+        parts_buffer.push(part.to_h)
+      end
+      {:header => @header.to_h, :parts => parts_buffer}.to_json
+    end
+
+    private
+
+    def set_content_type
+      if @content_typs.size == 1
+        @header.content_type = @content_typs.first
+      elsif @content_typs.include?('text/plain') && @content_typs.include?('text/html')
+        @header.content_type = {:main => "multipart/alternative", :boundary => "#{Time.now.to_i}"}
+      elsif @content_typs.size == 2
+        @header.content_type = {:main => "multipart/mixed", :boundary => "#{Time.now.to_i}"}
+      end
+    end
+
+    def encode_utf8(str)
+      str = Iconv.conv('utf-8', 'ISO-8859-1', str) unless str.isutf8
+      return str
+    end
+
+    def set_header(str)
+      @header = Header.new(str)
+    end
+
+    def set_parts(str)
+      @body = split(str, :body)
+      unless @body.nil?
+        if @header.multipart?
+          buffer = String.new
+          part_found = false
+          @body.each do |line|
+            if line.strip.eql?("--#{@header.content_type(:boundary)}") || line.strip.eql?("--#{@header.content_type(:boundary)}--")
+              part_found = true
+              unless buffer.empty?
+                part = Part.new(buffer)
+                if part.header.content_type(:main).eql?('text/plain') || part.header.content_type(:main).eql?('text/html')
+                  @parts.push(part)
+                else
+                  @parts.push(Attachment.new(buffer))
+                end
+                buffer = String.new
+              end
+            elsif part_found
+              buffer << line
+            end
+          end
+        else
+          @parts.push(Part.new(@body))
+        end
+      end
+    end
+
+  end
+end

data/lib/mail/attachment.rb

@@ -0,0 +1,14 @@
+require "base64"
+
+module Mail
+  class Attachment < Part
+    def content
+      Base64.decode64(@body) unless @body.empty?
+    end
+
+    def size
+      content.size
+    end
+
+  end
+end

data/lib/mail/header.rb

@@ -0,0 +1,106 @@
+require 'rubygems'
+require 'json'
+
+module Mail
+  class Header
+    def initialize(options = nil)
+      @params = Array.new
+      if options.kind_of?(String)
+        options.each_line do |line|
+          param = HeaderParam.new(line)
+          unless param.empty?
+            @params.push(param)
+          end
+          break if line.strip.empty?
+        end
+      elsif options.kind_of?(Hash)
+        add_param(:content_type, options[:content_type])
+      end
+    end
+
+    def params(name)
+      @params.each do |param|
+        return param if param.name.eql?(name)
+      end
+      return nil
+    end
+
+    def add_param(name, value)
+      header_param = params(name)
+      if header_param
+        header_param.param = value
+      else
+        header_param = HeaderParam.new
+        header_param.name = name
+        if value.kind_of?(Hash)
+          header_param.param = value
+        else
+          header_param.param = {:main => value}
+        end
+        @params.push(header_param)
+      end
+    end
+    
+    def to_s
+      buffer = String.new
+      @params.each do |param|
+        buffer << param.to_s << "\n"
+      end
+      return buffer
+    end
+
+    def to_h
+      header_buffer = Hash.new
+      @params.each do |param|
+        header_buffer[param.name] = param.to_h
+      end
+      return header_buffer
+    end
+
+    def to_json
+      @params.to_json
+    end
+
+    def multipart?
+      self.content_type(:main) && self.content_type(:main).include?("multipart")
+    end
+    
+    def attachments?
+      if self.multipart?
+        return self.content_type(:main).eql?("multipart/mixed")
+      end
+      return false
+    end
+
+    def method_missing(name, *args, &block)
+      if name.to_s.include?("=")
+        param_name = name.to_s.delete("=").to_sym
+        if param_name
+          add_param(param_name, args.at(0))
+        end
+      else
+        param = params(name)
+        return param.param(args.at(0)) if param
+      end
+    end
+
+    private
+
+    def format_key(key)
+      if key.to_s.include?("_")
+        buffer = String.new
+        key.to_s.split("_").each do |part|
+          if buffer.empty?
+            buffer << part.capitalize
+          else
+            buffer << "-#{part.capitalize}"
+          end
+        end
+        return buffer
+      else
+        return key.to_s.capitalize
+      end
+    end
+
+  end
+end

data/lib/mail/header_param.rb

@@ -0,0 +1,93 @@
+module Mail
+  class HeaderParam
+    attr_accessor :name
+
+    def initialize(options = nil)
+      File.open("#{File.dirname(__FILE__)}/../../config/config.yml") { |config_file| @config = YAML.load(config_file) }
+      @params = Hash.new
+      if options
+        set_params(options)
+      end
+    end
+
+    def param=(options)
+      if options.kind_of?(Hash)
+        options.each { |key, value| @params[key] = value }
+      elsif options.kind_of?(String)
+        if options.include?(";")
+          options.split(";").each do |part|
+            if part.include?("=")
+              set_sub_params(part.strip)
+            else
+              @params[:main] = part
+            end
+          end
+        else
+          @params[:main] = options
+        end
+      end
+    end
+
+    def param(name = nil)
+      if name
+        return @params[name]
+      else
+        if @params.kind_of?(Hash)
+          if @params.size.eql?(1)
+            buffer = "#{@params[:main]}"
+          else
+            buffer = "#{@params[:main]}; "
+          end
+          @params.each do |key, value|
+            unless key.eql?(:main)
+              buffer << "#{key}=\"#{value}\"; "
+            end
+          end
+          return buffer.strip
+        end
+      end
+    end
+
+    def to_s
+      "#{@name.to_s.strip.capitalize.gsub("_","-")}: #{param}"
+    end
+
+    def to_h
+      if @params.size.eql?(1)
+        return @params[:main]
+      else
+        return @params
+      end
+    end
+
+    def empty?
+      @name.to_s.empty?
+    end
+
+    private
+
+    def param_allowd?(name)
+      @config['header_params_allowd'].include?(name.to_s)
+    end
+
+    def set_params(line)
+      line.scan(/([A-Za-z\-]*):(.*)$/) do |part|
+        if !part.at(0).empty? && !part.at(1).empty?
+          name = part.at(0).strip.downcase.gsub("-","_").to_sym
+          if param_allowd?(name)
+            self.name = name
+            self.param = part.at(1).strip
+          end
+        end
+      end
+    end
+
+    def set_sub_params(line)
+      line.scan(/([A-Za-z\-]*)=(.*)$/) do |part|
+        if !part.at(0).empty? && !part.at(1).empty?
+          @params[part.at(0).strip.downcase.gsub("-","_").to_sym] = part.at(1).gsub('"','').strip
+        end
+      end
+    end
+  end
+end

data/lib/mail/part.rb

@@ -0,0 +1,50 @@
+module Mail
+  class Part
+    attr_reader :header, :body
+    
+    include Utils
+
+    def initialize(options = nil)
+      if options.kind_of?(String)
+        @header_empty = false
+        @header = Header.new
+        @body = String.new
+        if options
+          set_header(options)
+          set_body(options)
+        end
+      elsif options.kind_of?(Hash)
+        @header = Header.new(:content_type => options[:content_type])
+        @body = options[:content]
+      end
+    end
+
+    def to_s
+      @body
+    end
+
+    def to_h
+      {:header => @header.to_h, :body => @body}
+    end
+
+    private
+
+    def set_header(str)
+      @header = Header.new(str)
+      unless @header.content_type
+        # default content type
+        @header.content_type = "text/plain"
+        @header_empty = true
+      end
+    end
+
+    def set_body(str)
+      if @header_empty
+        @body = str
+      else
+        @body = split(str, :body)
+      end
+    end
+    
+  end
+end

data/lib/mail/utils.rb

@@ -0,0 +1,24 @@
+module Mail
+  module Utils
+  
+    def split(str, option)
+      buffer = String.new
+      case option
+      when :header
+        header_found = true
+        str.each_line do |line|
+          buffer << line if header_found
+          header_found = false if header_found && line.strip.empty?
+        end
+      when :body
+        body_found = false
+        str.each_line do |line|
+          buffer << line if body_found
+          body_found = true if !body_found && line.strip.empty?
+        end
+      end
+      return buffer
+    end
+
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: aklaiber-mail
+version: !ruby/object:Gem::Version 
+  version: 0.1.2
+platform: ruby
+authors: 
+- Alexander Klaiber
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-08-06 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Mail Parsing lib
+email: aklaiber@mybrief.de
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- LICENSE
+files: 
+- LICENSE
+- README
+- Rakefile
+- lib/mail.rb
+- lib/mail
+- lib/mail/utils.rb
+- lib/mail/attachment.rb
+- lib/mail/header.rb
+- lib/mail/header_param.rb
+- lib/mail/part.rb
+- config/config.yml
+has_rdoc: false
+homepage: 
+licenses: 
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Mail Parsing lib
+test_files: []
+