jpmobile 5.0.0 → 5.0.1

data/test/rails/overrides/spec/requests/trans_sid_spec.rb

@@ -2,14 +2,14 @@ require 'rails_helper'
 
 def get_with_session(controller, action, user_agent)
   open_session do |sess|
-    sess.get "/#{controller}/#{action}", params: {}, env: {"HTTP_USER_AGENT" => user_agent}
+    sess.get "/#{controller}/#{action}", params: {}, env: { 'HTTP_USER_AGENT' => user_agent }
   end
 end
 
 def describe_mobile_with_ua(user_agent, charset, &block)
   describe("trans_sid :mobile が指定されているコントローラに #{user_agent} からアクセスしたとき") do
     before(:each) do
-      @controller = "trans_sid_mobile"
+      @controller = 'trans_sid_mobile'
       @user_agent = user_agent
       @charset    = charset
     end
@@ -18,186 +18,186 @@ def describe_mobile_with_ua(user_agent, charset, &block)
   end
 end
 
-describe "trans_sid functional", type: :request do
+describe 'trans_sid functional', type: :request do
   before(:each) do
-    @user ||= User.create(name: "hoge")
+    @user ||= User.create(name: 'hoge')
   end
 
-  shared_examples_for "trans_sid が起動しないとき" do
-    it "で link_to の自動書き換えが行われない" do
-      res = get_with_session(@controller, "link", @user_agent)
+  shared_examples_for 'trans_sid が起動しないとき' do
+    it 'で link_to の自動書き換えが行われない' do
+      res = get_with_session(@controller, 'link', @user_agent)
 
-      expect(res.response.body).to match(/<a href=\"\/.+?\/link\">linkto<\/a>/)
+      expect(res.response.body).to match(%r{<a href=\"/.+?/link\">linkto</a>})
     end
-    it "で form の自動書き換えが行われない" do
-      res = get_with_session(@controller, "form", @user_agent)
+    it 'で form の自動書き換えが行われない' do
+      res = get_with_session(@controller, 'form', @user_agent)
 
-      expect(res.response.body).to match(/<form.*action=\"\/.+?\/form\".*accept-charset="#{@charset}"/)
+      expect(res.response.body).to match(%r{<form.*action=\"/.+?/form\".*accept-charset="#{@charset}"})
     end
-    it "で redirect の自動書き換えが行われない" do
-      res = get_with_session(@controller, "redirect", @user_agent)
+    it 'で redirect の自動書き換えが行われない' do
+      res = get_with_session(@controller, 'redirect', @user_agent)
 
-      expect(res.response.header['Location']).to match(/\/$/)
+      expect(res.response.header['Location']).to match(%r{/$})
     end
   end
 
-  shared_examples_for "trans_sid が起動するとき" do
-    it "で link_to の自動書き換えが行われる" do
-      res = get_with_session(@controller, "link", @user_agent)
+  shared_examples_for 'trans_sid が起動するとき' do
+    it 'で link_to の自動書き換えが行われる' do
+      res = get_with_session(@controller, 'link', @user_agent)
 
-      expect(res.response.body).to match(/<a href=\"\/.+?\/link\?_session_id=[a-zA-Z0-9]{32}\">linkto<\/a>/)
+      expect(res.response.body).to match(%r{<a href=\"/.+?/link\?_session_id=[a-zA-Z0-9]{32}\">linkto</a>})
     end
-    it "で form内にhiddenが差し込まれる" do
-      res = get_with_session(@controller, "form", @user_agent)
+    it 'で form内にhiddenが差し込まれる' do
+      res = get_with_session(@controller, 'form', @user_agent)
       expect(res.response.body).to match(/<input type=\"hidden\" name=\".+\" value=\"[a-zA-Z0-9]{32}\"/)
     end
-    it "で form の自動書き換えが行われる" do
-      res = get_with_session(@controller, "form", @user_agent)
+    it 'で form の自動書き換えが行われる' do
+      res = get_with_session(@controller, 'form', @user_agent)
 
-      expect(res.response.body).to match(/<form.*action=\"\/.+?\/form\?_session_id=[a-zA-Z0-9]{32}\".*accept-charset="#{@charset}"/)
+      expect(res.response.body).to match(%r{<form.*action=\"/.+?/form\?_session_id=[a-zA-Z0-9]{32}\".*accept-charset="#{@charset}"})
     end
-    it "で redirect の自動書き換えが行われる" do
-      res = get_with_session(@controller, "redirect", @user_agent)
+    it 'で redirect の自動書き換えが行われる' do
+      res = get_with_session(@controller, 'redirect', @user_agent)
 
       expect(res.response.header['Location']).to match(/\?_session_id=[a-zA-Z0-9]{32}$/)
     end
 
     # resource paths
-    it "で @user の link_to の自動書き換えが行われる" do
-      res = get_with_session(@controller, "link_path", @user_agent)
+    it 'で @user の link_to の自動書き換えが行われる' do
+      res = get_with_session(@controller, 'link_path', @user_agent)
 
-      expect(res.response.body).to match(/<a href=\"\/users\/1\?_session_id=[a-zA-Z0-9]{32}\">linkto<\/a>/)
+      expect(res.response.body).to match(%r{<a href=\"/users/1\?_session_id=[a-zA-Z0-9]{32}\">linkto</a>})
     end
-    it "で @user の form の自動書き換えが行われる" do
-      res = get_with_session(@controller, "form_path", @user_agent)
+    it 'で @user の form の自動書き換えが行われる' do
+      res = get_with_session(@controller, 'form_path', @user_agent)
 
-      expect(res.response.body).to match(/<form.*action=\"\/users\/1\?_session_id=[a-zA-Z0-9]{32}\".*accept-charset="#{@charset}"/)
+      expect(res.response.body).to match(%r{<form.*action=\"/users/1\?_session_id=[a-zA-Z0-9]{32}\".*accept-charset="#{@charset}"})
     end
-    it "で @path の redirect の自動書き換えが行われる" do
-      res = get_with_session(@controller, "redirect_path", @user_agent)
+    it 'で @path の redirect の自動書き換えが行われる' do
+      res = get_with_session(@controller, 'redirect_path', @user_agent)
 
       expect(res.response.header['Location']).to match(/\?_session_id=[a-zA-Z0-9]{32}$/)
     end
 
     # resource path with prefix
-    it "で [:admin, @user] の link_to の自動書き換えが行われる" do
-      res = get_with_session(@controller, "link_path_admin", @user_agent)
+    it 'で [:admin, @user] の link_to の自動書き換えが行われる' do
+      res = get_with_session(@controller, 'link_path_admin', @user_agent)
 
-      expect(res.response.body).to match(/<a href=\"\/admin\/users\/1\?_session_id=[a-zA-Z0-9]{32}\">linkto<\/a>/)
+      expect(res.response.body).to match(%r{<a href=\"/admin/users/1\?_session_id=[a-zA-Z0-9]{32}\">linkto</a>})
     end
-    it "で [:admin, @user] の form の自動書き換えが行われる" do
-      res = get_with_session(@controller, "form_path_admin", @user_agent)
+    it 'で [:admin, @user] の form の自動書き換えが行われる' do
+      res = get_with_session(@controller, 'form_path_admin', @user_agent)
 
-      expect(res.response.body).to match(/<form.*action=\"\/admin\/users\/1\?_session_id=[a-zA-Z0-9]{32}\".* accept-charset="#{@charset}"/)
+      expect(res.response.body).to match(%r{<form.*action=\"/admin/users/1\?_session_id=[a-zA-Z0-9]{32}\".* accept-charset="#{@charset}"})
     end
-    it "で [:admin, @path] の redirect の自動書き換えが行われる" do
-      res = get_with_session(@controller, "redirect_path_admin", @user_agent)
+    it 'で [:admin, @path] の redirect の自動書き換えが行われる' do
+      res = get_with_session(@controller, 'redirect_path_admin', @user_agent)
 
       expect(res.response.header['Location']).to match(/\?_session_id=[a-zA-Z0-9]{32}$/)
     end
   end
 
-  describe TransSidBaseController, "という trans_sid が有効になっていないコントローラ" do
+  describe TransSidBaseController, 'という trans_sid が有効になっていないコントローラ' do
     before(:each) do
-      @controller = "trans_sid_base"
-      @user_agent = "Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)"
-      @charset    = "UTF-8"
+      @controller = 'trans_sid_base'
+      @user_agent = 'Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)'
+      @charset    = 'UTF-8'
     end
 
-    it "の trans_sid_mode は nil" do
-      get "/#{@controller}/link", params: {}, env: {"HTTP_USER_AGENT" => @user_agent}
+    it 'の trans_sid_mode は nil' do
+      get "/#{@controller}/link", params: {}, env: { 'HTTP_USER_AGENT' => @user_agent }
 
       expect(controller.trans_sid_mode).to be_nil
     end
-    it_should_behave_like "trans_sid が起動しないとき"
+    it_should_behave_like 'trans_sid が起動しないとき'
   end
 
-  describe TransSidNoneController, "という trans_sid :none が指定されているコントローラ" do
+  describe TransSidNoneController, 'という trans_sid :none が指定されているコントローラ' do
     before(:each) do
-      @controller = "trans_sid_none"
-      @user_agent = "Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)"
-      @charset    = "UTF-8"
+      @controller = 'trans_sid_none'
+      @user_agent = 'Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)'
+      @charset    = 'UTF-8'
     end
 
-    it "の trans_sid_mode は :none" do
-      get "/#{@controller}/link", params: {}, env: {"HTTP_USER_AGENT" => @user_agent}
+    it 'の trans_sid_mode は :none' do
+      get "/#{@controller}/link", params: {}, env: { 'HTTP_USER_AGENT' => @user_agent }
 
       expect(controller.trans_sid_mode).to eq(:none)
     end
-    it_should_behave_like "trans_sid が起動しないとき"
+    it_should_behave_like 'trans_sid が起動しないとき'
   end
 
-  describe TransSidAlwaysController, "という trans_sid :always が指定されているコントローラ" do
+  describe TransSidAlwaysController, 'という trans_sid :always が指定されているコントローラ' do
     before(:each) do
-      @controller = "trans_sid_always"
-      @user_agent = "Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)"
-      @charset    = "UTF-8"
+      @controller = 'trans_sid_always'
+      @user_agent = 'Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)'
+      @charset    = 'UTF-8'
     end
 
-    it "の trans_sid_mode は :always" do
-      get "/#{@controller}/link", params: {}, env: {"HTTP_USER_AGENT" => @user_agent}
+    it 'の trans_sid_mode は :always' do
+      get "/#{@controller}/link", params: {}, env: { 'HTTP_USER_AGENT' => @user_agent }
 
       expect(controller.trans_sid_mode).to eq(:always)
     end
-    it_should_behave_like "trans_sid が起動するとき"
+    it_should_behave_like 'trans_sid が起動するとき'
   end
 
-  describe TransSidMetalController, "という ActionController::Metal のコントローラ" do
+  describe TransSidMetalController, 'という ActionController::Metal のコントローラ' do
     before(:each) do
-      @controller = "trans_sid_metal"
-      @user_agent = "Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)"
-      @charset    = "UTF-8"
+      @controller = 'trans_sid_metal'
+      @user_agent = 'Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)'
+      @charset    = 'UTF-8'
     end
 
-    it "で redirect_to がエラーにならない" do
-      res = get_with_session(@controller, "redirect", @user_agent)
+    it 'で redirect_to がエラーにならない' do
+      res = get_with_session(@controller, 'redirect', @user_agent)
 
       expect(res.response).to be_redirect
     end
   end
 
-  describe TransSidMobileController, "という trans_sid :mobile が指定されているコントローラ" do
+  describe TransSidMobileController, 'という trans_sid :mobile が指定されているコントローラ' do
     before(:each) do
-      @controller = "trans_sid_mobile"
-      @user_agent = "Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)"
-      @charset    = "UTF-8"
+      @controller = 'trans_sid_mobile'
+      @user_agent = 'Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)'
+      @charset    = 'UTF-8'
     end
 
-    it "の trans_sid_mode は :mobile" do
-      get "/#{@controller}/link", params: {}, env: {"HTTP_USER_AGENT" => @user_agent}
+    it 'の trans_sid_mode は :mobile' do
+      get "/#{@controller}/link", params: {}, env: { 'HTTP_USER_AGENT' => @user_agent }
 
       expect(controller.trans_sid_mode).to eq(:mobile)
     end
   end
 
-  describe TransSidAlwaysAndSessionOffController, "という trans_sid :always が指定されていて session がロードされていないとき" do
+  describe TransSidAlwaysAndSessionOffController, 'という trans_sid :always が指定されていて session がロードされていないとき' do
     before(:each) do
-      @controller = "trans_sid_always_and_session_off"
-      @user_agent = "Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)"
-      @charset    = "UTF-8"
+      @controller = 'trans_sid_always_and_session_off'
+      @user_agent = 'Mozilla/5.0 (Windows; U; Windows NT 5.1; ja; rv:1.9.2.3) Gecko/20100401 Firefox/3.6.3 ( .NET CLR 3.5.30729)'
+      @charset    = 'UTF-8'
     end
 
-    it "の trans_sid_mode は :always" do
-      res = get_with_session(@controller, "link", @user_agent)
+    it 'の trans_sid_mode は :always' do
+      res = get_with_session(@controller, 'link', @user_agent)
 
       expect(res.controller.trans_sid_mode).to eq(:always)
     end
-    it_should_behave_like "trans_sid が起動しないとき"
+    it_should_behave_like 'trans_sid が起動しないとき'
   end
 
-  describe_mobile_with_ua "DoCoMo/2.0 SH902i(c100;TB;W24H12)", "Shift_JIS" do
-    it_should_behave_like "trans_sid が起動するとき"
+  describe_mobile_with_ua 'DoCoMo/2.0 SH902i(c100;TB;W24H12)', 'Shift_JIS' do
+    it_should_behave_like 'trans_sid が起動するとき'
   end
 
-  describe_mobile_with_ua "KDDI-CA32 UP.Browser/6.2.0.7.3.129 (GUI) MMP/2.0", "Shift_JIS" do
-    it_should_behave_like "trans_sid が起動しないとき"
+  describe_mobile_with_ua 'KDDI-CA32 UP.Browser/6.2.0.7.3.129 (GUI) MMP/2.0', 'Shift_JIS' do
+    it_should_behave_like 'trans_sid が起動しないとき'
   end
 
-  describe_mobile_with_ua "SoftBank/1.0/910T/TJ001/SN000000000000000 Browser/NetFront/3.3 Profile/MIDP-2.0 Configuration/CLDC-1.1", "UTF-8" do
-    it_should_behave_like "trans_sid が起動しないとき"
+  describe_mobile_with_ua 'SoftBank/1.0/910T/TJ001/SN000000000000000 Browser/NetFront/3.3 Profile/MIDP-2.0 Configuration/CLDC-1.1', 'UTF-8' do
+    it_should_behave_like 'trans_sid が起動しないとき'
   end
 
-  describe_mobile_with_ua "Vodafone/1.0/V903T/TJ001 Browser/VF-Browser/1.0 Profile/MIDP-2.0 Configuration/CLDC-1.1 Ext-J-Profile/JSCL-1.2.2 Ext-V-Profile/VSCL-2.0.0", "UTF-8" do
-    it_should_behave_like "trans_sid が起動しないとき"
+  describe_mobile_with_ua 'Vodafone/1.0/V903T/TJ001 Browser/VF-Browser/1.0 Profile/MIDP-2.0 Configuration/CLDC-1.1 Ext-J-Profile/JSCL-1.2.2 Ext-V-Profile/VSCL-2.0.0', 'UTF-8' do
+    it_should_behave_like 'trans_sid が起動しないとき'
   end
 end

data/test/sinatra/test/filter_test.rb

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 require 'guestbook'
 require 'rack/test'
 require 'test/unit'
@@ -16,25 +15,25 @@ class SinatraOnJpmobile < Test::Unit::TestCase
   end
 
   def test_not_convert_pc_get
-    get '/', {:g => Jpmobile::Util.sjis("万葉")}, {}
-    assert_equal last_response.body, "万葉"
+    get '/', { g: Jpmobile::Util.sjis('万葉') }, {}
+    assert_equal last_response.body, '万葉'
   end
 
   def test_not_convert_pc_post
-    post '/', {:p => Jpmobile::Util.utf8("けーたい")}, {}
-    assert_equal last_response.body, "けーたい"
+    post '/', { p: Jpmobile::Util.utf8('けーたい') }, {}
+    assert_equal last_response.body, 'けーたい'
   end
 
   def test_docomo_get_convert_to_utf8
-    get '/', {:g => utf8_to_sjis("万葉")}, {"HTTP_USER_AGENT" => "DoCoMo/2.0 SH902i(c100;TB;W24H12)"}
-    assert_equal last_app.assigns(:g), "万葉"
-    assert_equal last_response.body, utf8_to_sjis("万葉")
+    get '/', { g: utf8_to_sjis('万葉') }, { 'HTTP_USER_AGENT' => 'DoCoMo/2.0 SH902i(c100;TB;W24H12)' }
+    assert_equal last_app.assigns(:g), '万葉'
+    assert_equal last_response.body, utf8_to_sjis('万葉')
   end
 
   def test_docomo_post_convert_to_utf8
-    post '/', {:p => utf8_to_sjis("けーたい")}, {"HTTP_USER_AGENT" => "DoCoMo/2.0 SH902i(c100;TB;W24H12)"}
-    assert_equal last_app.assigns(:p), "けーたい"
-    assert_equal last_response.body, utf8_to_sjis("けーたい")
+    post '/', { p: utf8_to_sjis('けーたい') }, { 'HTTP_USER_AGENT' => 'DoCoMo/2.0 SH902i(c100;TB;W24H12)' }
+    assert_equal last_app.assigns(:p), 'けーたい'
+    assert_equal last_response.body, utf8_to_sjis('けーたい')
   end
 
   # def test_view_selector_pc

data/tools/e4u_conv.rb

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 require 'nokogiri'
 require 'scanf'
 require 'pp'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jpmobile
 version: !ruby/object:Gem::Version
-  version: 5.0.0
+  version: 5.0.1
 platform: ruby
 authors:
 - Shin-ichiro OGAWA
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-07-01 00:00:00.000000000 Z
+date: 2019-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -29,30 +29,30 @@ dependencies:
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.5.0.beta4
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.5.0.beta4
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.5.0.beta4
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.5.0.beta4
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec-its
   requirement: !ruby/object:Gem::Requirement
@@ -160,12 +160,14 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - CONTRIBUTING.md
 - Gemfile
+- Gemfile.lock
 - MIT-LICENSE
-- README
-- README.rdoc
+- README.md
 - Rakefile
+- circle.yml
 - init.rb
 - jpmobile.gemspec
 - lib/jpmobile.rb
@@ -279,6 +281,7 @@ files:
 - spec/unit/variants_spec.rb
 - test/rails/.gitignore
 - test/rails/overrides/.rspec
+- test/rails/overrides/Gemfile
 - test/rails/overrides/Gemfile.jpmobile
 - test/rails/overrides/app/controllers/admin/top_controller.rb
 - test/rails/overrides/app/controllers/application_controller.rb
@@ -433,10 +436,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.4
+rubygems_version: 2.6.14.1
 signing_key: 
 specification_version: 4
-summary: A Rails plugin for mobile devices in Japan
+summary: Rails plugin for mobile devices in Japan
 test_files:
 - spec/rack/jpmobile/android_spec.rb
 - spec/rack/jpmobile/au_spec.rb
@@ -494,6 +497,7 @@ test_files:
 - spec/unit/variants_spec.rb
 - test/rails/.gitignore
 - test/rails/overrides/.rspec
+- test/rails/overrides/Gemfile
 - test/rails/overrides/Gemfile.jpmobile
 - test/rails/overrides/app/controllers/admin/top_controller.rb
 - test/rails/overrides/app/controllers/application_controller.rb

data/README.rdoc

@@ -1,308 +0,0 @@
-= jpmobile: A Rails plugin for Japanese mobile-phones
-
-== jpmobileとは
-携帯電話特有の機能を Rails 4.0 や Rack middleware で利用するためのプラグイン。
-以下の機能を備える。
-
-* 携帯電話のキャリア判別
-* 端末位置情報の取得
-  * {GeoKit}[http://geokit.rubyforge.org] との連携
-* 端末製造番号、契約者番号等の取得
-* IPアドレスの検証(キャリアが公開しているIPアドレス帯域からのアクセスか判定)
-  * IPアドレスの検証には {jpmobile-ipaddresses}[http://github.com/jpmobile/jpmobile-ipaddresses] が必要です。
-* ディスプレイ情報(画面サイズ、ブラウザ画面サイズ、カラー・白黒、色数)の取得
-  * ディスプレイ情報の取得には {jpmobile-terminfo}[http://github.com/jpmobile/jpmobile-terminfo] が必要です。
-* 文字コード変換機能／絵文字のキャリア間相互変換
-* メールの送信
-  * 絵文字と漢字コードの変換
-* メールの受信(experimental)
-  * 絵文字と漢字コードの変換
-
-また Rails 4.0 に以下の機能を追加する
-* ビューへの自動振分け
-* 位置情報取得などのリンクヘルパーの追加
-* セッションIDをフォーム／リンクに付与(Trans SID)
-
-他のバージョンの Rails については {Versions : Jpmobile vs Rails}[https://github.com/jpmobile/jpmobile/wiki/Version-:-Jpmobile-vs-Rails] を参照。
-
-== インストール
-=== Rails pluginとしてインストールする場合
-  % rails plugin install git://github.com/jpmobile/jpmobile.git
-==== IPアドレス検証が必要な場合
-  % rails plugin install git://github.com/jpmobile/jpmobile-ipaddresses.git
-==== ディスプレイ情報を取得する必要がある場合
-  % rails plugin install git://github.com/jpmobile/jpmobile-terminfo.git
-
-=== gemでインストールする場合
-  % gem install jpmobile
-==== IPアドレス検証が必要な場合
-  % gem install jpmobile-ipaddresses
-==== ディスプレイ情報を取得する必要がある場合
-  % gem install jpmobile-terminfo
-
-== 使用例
-
-=== 携帯電話の識別
-環境変数 env['rack.jpmobile'] にキャリアクラスのインスタンスが格納されています。また Rack::Request#mobile としても取得可能です。
-
-==== キャリアの識別
-
-  case request.mobile
-  when Jpmobile::Mobile::Docomo
-    # for DoCoMo
-  when Jpmobile::Mobile::Au
-    # for au
-  when Jpmobile::Mobile::Softbank
-    # for SoftBank
-  when Jpmobile::Mobile::Willcom
-    # for Willcom
-  when Jpmobile::Mobile::Emobile
-    # for EMOBILE
-  else
-    # for PC
-  end
-
-あるいは
-  if request.mobile.is_a?(Jpmobile::Mobile::Docomo)
-    # for DoCoMo
-  end
-
-==== ビューの中で一部を切替える例
-  <% if request.mobile? %>
-    携帯電話からのアクセスです。
-  <% else %>
-    携帯電話からのアクセスではありません。
-  <% end %>
-
-  <% if request.smart_phone? %>
-    スマートフォンからのアクセスです。
-  <% else %>
-    スマートフォンからのアクセスではありません。
-  <% end %>
-
-  <% if request.tablet? %>
-    タブレットからのアクセスです。
-  <% else %>
-    タブレットからのアクセスではありません。
-  <% end %>
-
-
-==== 別に用意した携帯電話用コントローラへリダイレクトする例
-  class PcController < ApplicationController
-    before_action :redirect_if_mobile
-
-    def index
-    end
-
-    private
-    def redirect_if_mobile
-      if request.mobile?
-        pa = params.dup
-        pa[:controller] = "/mobile"
-        redirect_to pa
-      elsif request.smart_phone?
-        pa = params.dup
-        pa[:controller] = "/smart_phone"
-        redirect_to pa
-      end
-    end
-  end
-
-  class MobileController < ApplicationController
-  end
-
-=== 位置情報の取得
-Rack::Request#mobile.position に位置情報が格納されます。
-
-  @latitude   = request.mobile.position.lat
-  @longuitude = request.mobile.position.lon
-
-==== {GeoKit}[http://geokit.rubyforge.org] との連携
-
-vendor/plugins/geokit以下にGeoKitがインストールされていると、Jpmobile::PositionにGeoKit::Mappableがincludeされる。したがって、
-
-  request.mobile.position.distance_to('札幌駅')
-
-とすることで、端末と「札幌駅」との距離を求めることができる。詳細は http://geokit.rubyforge.org/api/index.html 参照。
-
-=== 端末情報の取得
-
-端末側から通知されている場合、request.mobile.ident で
-契約に固有の識別子もしくは端末の製造番号を取得できる。
-両方存在する場合は契約に固有のIDが優先される。
-
-* 契約に固有のID (request.mobile.ident_subscriber)
-  * au: EZ番号(サブスクライバ番号)
-  * DoCoMo: FOMAカード製造番号
-  * EMOBILE: EMnet対応端末から通知されるユニークなユーザID
-* 端末製造番号 (request.mobile.ident_device)
-  * DoCoMo: 端末製造番号(FOMA, MOVA)
-  * SoftBank: 製造番号
-
-=== IPの検証
-キャリアが公開しているIPアドレス帯域からのアクセスか判定する。
-  request.mobile.valid_ip?
-ただし {jpmobile-ipaddresses}[http://github.com/jpmobile/jpmobile-ipaddresses] がインストールされていないか、スマートフォンの場合は必ずfalseとなる。
-
-=== 端末の画面サイズ
-request.mobile.display で Jpmobile::Display クラスのインスタンスが返る。
-  画面幅 <%= request.mobile.display.width %>
-  画面高さ <%= request.mobile.display.height %>
-ただし {jpmobile-terminfo}[http://github.com/jpmobile/jpmobile-terminfo] がインストールされていない場合はエラーとなるので注意が必要。
-
-=== 文字コード変換機能／絵文字のキャリア間相互変換
-
-jpmobileを読み込むとDoCoMo、Au、SoftBankの絵文字を透過的に扱うことができる。
-
-* Rails の場合は vendor/plugins に配置し、下記の設定を追加することで有効になる。
-    # Rack middleware を追加するメソッド
-    Rails.application.config.jpmobile.mobile_filter
-      or
-    Jpmobile.config.mobile_filter
-
-  * 下記の設定を追加することで、<form> タグの accept-charset が変更される。
-      # <form accept-charset="Shift_JIS" ...> などに変更する
-      Rails.application.config.jpmobile.form_accept_charset_conversion = true
-        or
-      Jpmobile.config.form_accept_charset_conversion = true
-
-  * Andriod/iPhone では Google 絵文字や Unicode 6.0 絵文字が使われています。下記の設定を追加すると、互換性をもたせるために3キャリアの絵文字に変換することができます。また表示の変換も可能です。
-      Rails.application.config.jpmobile.smart_phone_emoticon_compatibility = true
-        or
-      Jpmobile.config.smart_phone_emoticon_compatibility = true
-
-携帯電話上では特に問題とならない。PCブラウザでテストする際に問題となるためのオプション。
-
-* Sinatra の場合は下記のように指定する。
-    $LOAD_PATH << './lib/jpmobile/lib'
-    require 'jpmobile'
-    require 'jpmobile/rack'
-
-    use Jpmobile::Rack::MobileCarrier
-    use Jpmobile::Rack::ParamsFilter
-    use Jpmobile::Rack::Filter
-
-    get '/' do
-      erb :index
-    end
-
-Rails のみ半角・全角の自動変換フィルターが用意されている。用いるには
-  class MyController
-    hankaku_filter
-  end
-
-と指定する。またtextareaやhidden/text/passwordのinputタグで半角に変換したくない場合は :input => true を指定する。このときNokogiriが必要となるため、Gemfileに追記してインストールする必要がある。
-  class MyController
-    hankaku_filter :input => true
-  end
-
-Jpmobile内では、各キャリアの絵文字はUnicode私的領域上にマッピングされ、管理される。
-このとき、DoCoMo、Auは公式サイト記載のマッピングが使用される。
-ただしSoftBankはAuとの重複を避けるため、公式のマッピングに0x1000加算しU+F001以降に割り当てる。
-テンプレート内ではUTF-8でエンコードするか、数値文字参照の&#xHHHH;形式で指定する。
-
-絵文字は送出時に内蔵の変換表に基づいて変換され、携帯電話のエンコーディングにあわせて送出される。
-携帯電話から受信した絵文字は上記マッピングに基づいてUTF-8でparamsに渡される。
-
-* DoCoMo、Auとの通信時にはShift_JIS、SoftBankとの通信時にはUTF-8が使用される。
-* :hankaku=>true指定時は、カタカナは半角カナに変換されて送出される。携帯電話から送られた半角カナは全角カナに変換される。
-* 絵文字はキャリアにあわせて変換されて送出される。
-* 携帯電話からの絵文字はUnicode私的領域にマップされ、UTF-8でparamsに格納される。
-
-=== ビューの自動振り分け
-ビューの自動振り分けを行うには、以下の設定が必要です。
-
-  class ApplicationController < ActionController::Base
-    include Jpmobile::ViewSelector
-  end
-
-DoCoMo携帯電話からアクセスすると、
-* index_mobile_docomo.html.erb
-* index_mobile.html.erb
-* index.html.erb
-の順でテンプレートを検索し、最初に見付かったテンプレートが利用される。
-Auの場合は、index_mobile_au.html.erb、Softbankの場合はindex_mobile_softbank.html.erbが最初に検索される。
-
-またiPhoneからアクセスすると、
-* index_smart_phone_iphone.html.erb
-* index_smart_phone.html.erb
-* index.html.erb
-の順でテンプレートを検索する。
-Androidの場合はindex_smart_phone_android.html.erb、Windows Phoneの場合はindex_smart_phone_windows_phone.html.erbが最初に検索される。
-
-自動振り分けを無効化するには、アクションにおいて以下のように設定する
-
-  def index
-    disable_mobile_view!
-  end
-
-=== 位置情報の取得用リンクの生成
-
-以下のようなコードで、端末に位置情報を要求するリンクを出力する。
-  <%= get_position_link_to("位置情報を取得する", :action=>:gps) %>
-
-=== セッションIDの付与(Trans SID)
-==== Cookie非対応携帯だけに付与する
-  class MyController
-    trans_sid
-  end
-
-==== PCにも付与する
-  class MyController
-    trans_sid :always
-  end
-
-trans_sid 機能を使う場合には、cookie session store を使用することができず、
-active_record_storeのgemパッケージが必要です。
-また Rails 4.0 では Cookie が使える場合にはそちらが優先されてしまうため、:always を指定した場合に問題になる場合があります。
-trans_sid を使用する際には、例えば config/initializers/session_store.rb で
-  Rails.application.config.session_store :active_record_store
-  Rails.application.config.session_options = {:cookie_only => false}
-として active_record_store を使用するように設定し、:cookie_only => false として Cookie を優先しないように設定します。
-このとき ApplicationController において protect_from_forgery の :secret を指定するか、
-あるいは protect_from_forgery を解除する必要があるでしょう。
-
-また、
-  link_to "hoge", "/controller/action/id"
-のようにリンク先を直接指定するとセッションIDは付加されません。
-  link_to "hoge", :controller => "controller", :action => "action", :id => "id"
-のように指定する必要があります。
-
-=== メールの送受信
-メールにて絵文字や漢字コードの変換、ビューの自動振り分けを行なうには Jpmobile::Mailer::Base を使う。
-
-  class MobileMailer < Jpmobile::Mailer::Base
-    default :from => "info@jpmobile-rails.org"
-
-    def registration(to)
-      mail(:to => to)
-    end
-
-    def receive(email)
-      email
-    end
-  end
-
-* デフォルトで ISO-2022-JP エンコードで送信
-* docomo/SoftBank には Shift_JIS で送信
-* au は ISO-2022-JP エンコードで送信
-* ビューやレイアウトの自動振り分け
-  * docomo であれば app/views/mobile_mailer/registration_mobile_docomo.html.erb など
-* 受信に関しては、docomo/SoftBank でテストできていないため、実験版とします。
-  * テストして問題あれば随時報告してください。
-* オプションに :decorated => true を追加すると、各キャリアのデコメに適したフォーマットで送信します。
-  * ただし docomo/SoftBank でテスト出来ていないため、実験版とします。
-
-== jpmobileの開発方法
-
-jpmobileの開発に関しては {こちら}[https://github.com/jpmobile/jpmobile/blob/master/CONTRIBUTING.md] へ
-
-== リンク
-
-* http://jpmobile-rails.org
-
-== 作者
-
-Copyright 2006-2012 (c) Yoji Shidara, under MIT License.
-
-Shin-ichiro OGAWA <rust.stnard@gmail.com>, Yoji Shidara <dara@shidara.net>