mail-iso-2022-jp 1.0.0

data/Gemfile

@@ -0,0 +1,9 @@
+source :rubygems
+
+gem "mail", ">= 2.2.5"
+
+group :test do
+  gem "rake"
+  gem "bundler"
+  gem "actionmailer", "~> 3.1.0"
+end

data/README.md

@@ -0,0 +1,109 @@
+A patch that provides 'mail' gem with iso-2022-jp conversion capability.
+========================================================================
+
+Overview
+--------
+
+* (en)
+
+	`mail-iso-2022-jp` is a patch for [mikel/mail](https://github.com/mikel/mail).
+	With this patch, you can easily send mails with `ISO-2022-JP` enconding (so-called "JIS-CODE").
+
+* (ja)
+
+    `mail-iso-2022-jp` は、[mikel/mail](https://github.com/mikel/mail) に対するパッチです。
+    これを利用すると `ISO-2022-JP`（いわゆる「JISコード」）でのメール送信が容易になります。
+
+
+Feature
+-------
+
+* (en)
+
+    If you set the `charset` header to `ISO-2022-JP`, the values of `From`, `To`, and `Subject` headers
+    and the text of body will be automatically converted to `ISO-2022-JP` by `NKF` module.
+    
+    When the `charset` header has other values, this patch has no effect.
+
+* (ja)
+
+    chasetヘッダの値が `ISO-2022-JP` である場合、送信者(From)、宛先(To)、件名(Subject)の各ヘッダの値および
+    本文(Body)が`NKF`モジュールによって自動的に `ISO-2022-JP` に変換されます。
+    
+    charsetヘッダの値が `ISO-2022-JP` でない場合、このパッチは何の効果もありません。
+
+
+Environments
+------------
+
+### Requirements ###
+
+* `ruby` 1.8.7 or higher
+* `mail` 2.2.5 or higher
+
+
+Getting Start
+-------------
+
+### Install as a gem ###
+
+Add to your Gemfile:
+
+    gem 'mail-iso-2022-jp'
+
+or run this command:
+
+    gem install mail-iso-2022-jp
+
+### Install as a Rails plugin ###
+
+	$ cd RAILS_ROOT
+	$ rails plugin install http://github.com/kuroda/mail-iso-2022-jp.git
+
+### Example ###
+
+    mail = Mail.new(:charset => 'ISO-2022-JP') do
+      from    '山田太郎 <taro@example.com>'
+      to      '佐藤花子 <hanako@example.com>'
+      subject '日本語件名'
+      body    '日本語本文'
+    end
+
+	mail['from'].encoded
+	  => "From: =?ISO-2022-JP?B?GyRCOzNFREJATzobKEI=?= <taro@example.com>\r\n"
+	mail['to'].encoded
+	  => "To: =?ISO-2022-JP?B?GyRCOjRGIzJWO1IbKEI=?= <hanako@example.com>\r\n"
+	mail.subject
+	 => "=?ISO-2022-JP?B?GyRCRnxLXDhsN29MPhsoQg==?="
+	NKF.nkf('-mw', mail.subject)
+	 => "日本語件名"
+	mail.body.encoded
+	 => "\e$BF|K\\8lK\\J8\e(B"
+	NKF.nkf('-w', mail.body.encoded)
+	 => "日本語本文"
+
+### Example for ActionMailer ###
+
+	class UserMailer < ActionMailer::Base
+	  default :from => "山田太郎 <bar@example.com>", :charset => 'ISO-2022-JP'
+	  def notice
+	    mail(:to => '佐藤花子 <foo@example.com>', :subject => '日本語件名') do |format|
+	      format.text { render :inline => '日本語本文' }
+	    end
+	  end
+	end
+
+
+
+License
+-------
+
+(en) "mail-iso-2022-jp" released under the MIT license (MIT-LICENSE.txt)
+
+(ja) "mail-iso-2022-jp" は MITライセンスで配布しています。 (MIT-LICENSE.txt)
+
+
+Special thanks
+--------------
+
+[Kohei Matsushita](https://github.com/ma2shita) -- Initial creator of this patch.

data/Rakefile

@@ -0,0 +1,23 @@
+require 'rake'
+require 'rake/testtask'
+require 'rdoc/task'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the mail_ja plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the mail_ja plugin.'
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'MailJa'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/mail-iso-2022-jp.rb

@@ -0,0 +1 @@
+require 'mail-iso-2022-jp/patches'

data/lib/mail-iso-2022-jp/patches.rb

@@ -0,0 +1,49 @@
+module Mail
+  class Message
+    def process_body_raw_with_iso_2022_jp_encoding
+      if @charset.to_s.downcase == 'iso-2022-jp'
+        @body_raw = NKF.nkf('-j', @body_raw)
+      end
+      process_body_raw_without_iso_2022_jp_encoding
+    end
+    alias_method :process_body_raw_without_iso_2022_jp_encoding, :process_body_raw
+    alias_method :process_body_raw, :process_body_raw_with_iso_2022_jp_encoding
+  end
+  
+  module FieldWithIso2022JpEncoding
+    def self.included(base)
+      base.send :alias_method, :initialize_without_iso_2022_jp_encoding, :initialize
+      base.send :alias_method, :initialize, :initialize_with_iso_2022_jp_encoding
+      base.send :alias_method, :do_decode_without_iso_2022_jp_encoding, :do_decode
+      base.send :alias_method, :do_decode, :do_decode_with_iso_2022_jp_encoding
+    end
+    
+    def initialize_with_iso_2022_jp_encoding(value = nil, charset = 'utf-8')
+      if charset.to_s.downcase == 'iso-2022-jp'
+        value = NKF.nkf('--cp932 -M', NKF.nkf('--cp932 -j', value)).gsub("\n", '').strip
+      end
+      initialize_without_iso_2022_jp_encoding(value, charset)
+    end
+    
+    private
+    def do_decode_with_iso_2022_jp_encoding
+      if charset.to_s.downcase == 'iso-2022-jp'
+        value
+      else
+        do_decode_without_iso_2022_jp_encoding
+      end
+    end
+  end
+
+  class SubjectField < UnstructuredField
+    include FieldWithIso2022JpEncoding
+  end
+
+  class FromField < StructuredField
+    include FieldWithIso2022JpEncoding
+  end
+
+  class ToField < StructuredField
+    include FieldWithIso2022JpEncoding
+  end
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification 
+name: mail-iso-2022-jp
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Kohei MATSUHITA
+- Tsutomu KURODA
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-11-19 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mail
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 13
+        segments: 
+        - 2
+        - 2
+        - 5
+        version: 2.2.5
+  type: :runtime
+  version_requirements: *id001
+description: A patch that provides 'mail' gem with iso-2022-jp conversion capability.
+email: hermes@oiax.jp
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.md
+- Gemfile
+- Rakefile
+- lib/mail-iso-2022-jp.rb
+- lib/mail-iso-2022-jp/patches.rb
+homepage: http://github.com/kuroda/mail_ja
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: A patch that provides 'mail' gem with iso-2022-jp conversion capability.
+test_files: []
+