sisimai 5.0.0-java → 5.0.3-java

data/README-JA.md

@@ -1,8 +1,8 @@
 ![](https://libsisimai.org/static/images/logo/sisimai-x01.png)
 [![License](https://img.shields.io/badge/license-BSD%202--Clause-orange.svg)](https://github.com/sisimai/rb-sisimai/blob/master/LICENSE)
-[![Coverage Status](https://img.shields.io/coveralls/sisimai/rb-sisimai.svg)](https://coveralls.io/r/sisimai/rb-sisimai)
-[![Ruby](https://img.shields.io/badge/ruby-v2.4.0--v2.7.0-red.svg)](https://www.ruby-lang.org/)
+[![Ruby](https://img.shields.io/badge/ruby-v2.4.0--v3.3.0-red.svg)](https://www.ruby-lang.org/)
 [![Gem Version](https://badge.fury.io/rb/sisimai.svg)](https://badge.fury.io/rb/sisimai)
+[![codecov](https://codecov.io/github/sisimai/rb-sisimai/graph/badge.svg?token=YGkyluNWiZ)](https://codecov.io/github/sisimai/rb-sisimai)
 
 > [!IMPORTANT]
 > **2024年2月2日の時点でこのリポジトリのデフォルトブランチは[5-stable](https://github.com/sisimai/rb-sisimai/tree/5-stable)
@@ -14,15 +14,13 @@
 > Sisimai 5はRuby 2.4以上が必要です。インストール/アップグレードを実行する前に`ruby -v`コマンドで
 > システムに入っているRubyのバージョンを確認してください。
 
-> [!CAUTION]
-> 2024年2月2日の時点で[Sisimai 5](https://github.com/sisimai/rb-sisimai/releases/tag/v5.0.0)は
-> [RubyGems.org](https://rubygems.org/gems/sisimai)にアップロードしていません。数ヶ月以内には
-> アップロードをする予定ですが、それまではこのリポジトリではから`git clone`してください。
-
+> [!NOTE]
+> SisimaiはPerlモジュールまたはRuby Gemですが、PHPやPython、GoやRustなどJSONを読める言語であれば
+> どのような環境においても解析結果を得ることでバウンスの発生状況を捉えるのにとても有用です。
 
 - [**README(English)**](README.md)
 - [シシマイ? | What is Sisimai](#what-is-sisimai)
-    - [主な特徴的機能 | Key features](#key-features)
+    - [主な特徴的機能 | The key features](#the-key-features-of-sisimai)
     - [コマンドラインでのデモ | Command line demo](#command-line-demo)
 - [シシマイを使う準備 | Setting Up Sisimai](#setting-up-sisimai)
     - [動作環境 | System requirements](#system-requirements)
@@ -35,12 +33,14 @@
     - [コールバック機能 | Callback feature](#callback-feature)
     - [ワンライナー | One-Liner](#one-liner)
     - [出力例 | Output example](#output-example)
-- [シシマイの仕様 | Sisimai Specification](#sisimai-specification)
-    - [Ruby版とPerl版の違い | Differences between Ruby version and Perl version](#differences-between-ruby-version-and-perl-version)
-    - [その他の仕様詳細 | Other specification of Sisimai](#other-specification-of-sisimai)
+- [Sisimai 4とSisimai 5の違い](#differences-between-sisimai-4-and-sisimai-5)
+    - [機能など](#features)
+    - [解析メソッド](#decoding-methods)
+    - [MTA/ESPモジュール](#mtaesp-module-names)
+    - [バウンス理由](#bounce-reasons)
 - [Contributing](#contributing)
     - [バグ報告 | Bug report](#bug-report)
-    - [解析できないメール | Emails could not be parsed](#emails-could-not-be-parsed)
+    - [解析できないメール | Emails could not be decoded](#emails-could-not-be-decoded)
 - [その他の情報 | Other Information](#other-information)
     - [関連サイト | Related sites](#related-sites)
     - [参考情報| See also](#see-also)
@@ -50,24 +50,47 @@
 
 What is Sisimai
 ===================================================================================================
-Sisimai(シシマイ)はRFC5322準拠のエラーメールを解析し、解析結果をデータ構造に変換するインターフェイス
-を提供するRubyライブラリです。[github.com/sisimai/p5-sisimai](https://github.com/sisimai/p5-sisimai/)
-で公開しているPerl版シシマイから移植しました。
+Sisimai(シシマイ)は複雑で多種多様なバウンスメールを解析してバウンスした理由や宛先メールアドレスなど
+配信が失敗した結果を構造化データで出力するライブラリでJSONでの出力も可能です。Ruby版シシマイは
+[github.com/sisimai/p5-sisimai](https://github.com/sisimai/p5-sisimai/)で公開しているPerl版シシマイ
+から移植しました。
 
-![](https://libsisimai.org/static/images/figure/sisimai-overview-1.png)
+![](https://libsisimai.org/static/images/figure/sisimai-overview-2.png)
 
-Key features
+The key features of Sisimai
+---------------------------------------------------------------------------------------------------
+* __バウンスメールを構造化したデータに変換__
+  * 以下24項目の情報を含むデータ構造[^2]
+    * __基本的情報__: `timestamp`, `origin`
+    * __発信者情報__: `addresser`, `senderdomain`, 
+    * __受信者情報__: `recipient`, `destination`, `alias`
+    * __配信の情報__: `action`, `replycode`,`action`, `replycode`, `deliverystatus`
+    * __エラー情報__: `reason`, `diagnosticcode`, `diagnostictype`, `feedbacktype`, `hardbounce`
+    * __メール情報__: `subject`, `messageid`, `listid`,
+    * __その他情報__: `smtpagent`, `timezoneoffset`, `lhost`, `rhost`, `token`, `catch`
+  * __出力可能な形式__
+    * Ruby (Hash, Array)
+    * JSON 
+      * ([`oj`](https://rubygems.org/gems/oj)を使用(CRuby))
+      * ([`jrjackson`](https://rubygems.org/gems/jrjackson)を使用(JRuby))
+    * YAML ([`yaml`](https://rubygems.org/gems/yaml)が必要)
+  * __インストールも使用も簡単__
+    * `gem install`
+    * `git clone && make`
+  * __高い解析精度__
+    * [70種類のMTAs/MDAs/ESPs](https://libsisimai.org/en/engine/)に対応
+    * Feedback Loop(ARF)にも対応
+    * [34種類のバウンス理由](https://libsisimai.org/en/reason/)を検出
+
+[^2]: コールバック機能を使用すると`catch`アクセサの下に独自のデータを追加できます
+
+
+Command line demo
 ---------------------------------------------------------------------------------------------------
-* __エラーメールをデータ構造に変換__
-  * Rubyのデータ形式(HashとArray)とJSON(String)に対応
-* __インストールも使用も簡単__
-  * gem install
-  * git clone & make
-* __高い解析精度__
-  * 解析精度はbounceHammerの2倍
-  * 68種類のMTA/MDA/ESPに対応
-  * Feedback Loopにも対応
-  * 32種類のエラー理由を検出
+次の画像のように、Ruby版シシマイ(rb-sisimai)はコマンドラインから簡単にバウンスメールを解析すること
+ができます。
+![](https://libsisimai.org/static/images/demo/sisimai-5-cli-dump-r01.gif)
+
 
 Setting Up Sisimai
 ===================================================================================================
@@ -78,37 +101,53 @@ Sisimaiの動作環境についての詳細は[Sisimai | シシマイを使っ
 
 
 * [Ruby 2.4.0 or later](http://www.ruby-lang.org/)
-  * [__Oj | The fastest JSON parser and object serializer__](https://rubygems.org/gems/oj)
-* Also works on [JRuby 9.0.4.0 or later](http://jruby.org)
-  * [__JrJackson | A mostly native JRuby wrapper for the java jackson json processor jar__](https://rubygems.org/gems/jrjackson)
+  * [__oj | The fastest JSON parser and object serializer__](https://rubygems.org/gems/oj)
+* Also works on [JRuby 9.2 or later](http://jruby.org)
+  * [__jrjackson | A mostly native JRuby wrapper for the java jackson json processor jar__](https://rubygems.org/gems/jrjackson)
 
 Install
 ---------------------------------------------------------------------------------------------------
 ### From RubyGems.org
-
 ```shell
 $ sudo gem install sisimai
-Fetching: sisimai-4.25.5.gem (100%)
-Successfully installed sisimai-4.25.5
-Parsing documentation for sisimai-4.25.5
-Installing ri documentation for sisimai-4.25.5
+Fetching: sisimai-5.0.3.gem (100%)
+Successfully installed sisimai-5.0.3
+Parsing documentation for sisimai-5.0.3
+Installing ri documentation for sisimai-5.0.3
 Done installing documentation for sisimai after 6 seconds
 1 gem installed
 ```
 
 ### From GitHub
+> [!WARNING]
+> Sisimai 5はRuby 2.4以上が必要です。インストール/アップグレードを実行する前に`ruby -v`コマンドで
+> システムに入っているRubyのバージョンを確認してください。
 
 ```shell
+% ruby -v
+ruby 3.3.0 (2023-12-25 revision 5124f9ac75) [x86_64-darwin21]
+
 $ cd /usr/local/src
 $ git clone https://github.com/sisimai/rb-sisimai.git
+
 $ cd ./rb-sisimai
 $ sudo make depend install-from-local
-gem install bundle rake minitest coveralls
+gem install bundle rake minitest
 ...
-4 gems installed
-bundle exec rake install
-sisimai 4.25.5 built to pkg/sisimai-4.25.5.gem.
-sisimai (4.25.5) installed.
+3 gems installed
+if [ -d "/usr/local/jr" ]; then \
+		PATH="/usr/local/jr/bin:$PATH" /usr/local/jr/bin/gem install bundle rake minitest; \
+	fi
+...
+3 gems installed
+/opt/local/bin/rake install
+sisimai 5.0.3 built to pkg/sisimai-5.0.3.gem.
+sisimai (5.0.3) installed.
+if [ -d "/usr/local/jr" ]; then \
+		PATH="/usr/local/jr/bin:$PATH" /usr/local/jr/bin/rake install; \
+	fi
+sisimai 5.0.3 built to pkg/sisimai-5.0.3-java.gem.
+sisimai (5.0.3) installed.
 ```
 
 Usage
@@ -121,64 +160,65 @@ Basic usage
 ```ruby
 #! /usr/bin/env ruby
 require 'sisimai'
-v = Sisimai.rise('/path/to/mbox')       # or path to Maildir/
+v = Sisimai.rise('/path/to/mbox')       # またはMaildir/へのPATH
 
-# Beginning with v4.23.0, both rise() and dump() method of Sisimai class can read bounce messages
-# from variable instead of a path to mailbox
-f = File.open('/path/to/mbox', 'r');    # or path to Maildir/
+# v4.23.0からSisimaiクラスのrise()メソッドとdump()メソッドはPATH以外にもバウンスメール全体を文字列
+# として読めるようになりました
+f = File.open('/path/to/mbox', 'r');    # またはMaildir/へのPATH
 v = Sisimai.rise(f.read)
 
-# If you want to get bounce records which reason is "delivered", set "delivered" option to rise()
-# method like the following:
+# もし"delivered"(配信成功)となる解析結果も必要な場合は以下に示すとおりrise()メソッドに"delivered"
+# オプションを指定してください
 v = Sisimai.rise('/path/to/mbox', delivered: true)
 
-# Beginning with v5.0.0, sisimai does not return the reulst which "reason" is "vaction" by default.
-# If you want to get bounce records which reason is "vacation", set "vacation" option to rise()
-# method like the following:
+# v5.0.0からSisimaiはバウンス理由が"vacation"となる解析結果をデフォルトで返さなくなりました。もし
+# "vacation"となる解析結果も必要な場合は次のコードで示すようにrise()メソッドに"vacation"オプション
+# を指定してください。
 v = Sisimai.rise('/path/to/mbox', vacation: true);
 
 if v.is_a? Array
   v.each do |e|
-    puts e.class                # Sisimai::Data
+    puts e.class                # Sisimai::Fact
     puts e.recipient.class      # Sisimai::Address
     puts e.timestamp.class      # Sisimai::Time
 
-    puts e.addresser.address    # shironeko@example.org # From
-    puts e.recipient.address    # kijitora@example.jp   # To
-    puts e.recipient.host       # example.jp
-    puts e.deliverystatus       # 5.1.1
-    puts e.replycode            # 550
-    puts e.reason               # userunknown
-    puts e.origin               # /var/spool/bounce/Maildir/new/1740074341.eml
+    puts e.addresser.address    # "michitsuna@example.org" # From
+    puts e.recipient.address    # "kijitora@example.jp"    # To
+    puts e.recipient.host       # "example.jp"
+    puts e.deliverystatus       # "5.1.1"
+    puts e.replycode            # "550"
+    puts e.reason               # "userunknown"
+    puts e.origin               # "/var/spool/bounce/Maildir/new/1740074341.eml"
     puts e.hardbounce           # true
 
-    h = e.damn                  # Convert to HASH
-    j = e.dump('json')          # Convert to JSON string
-    puts e.dump('json')         # JSON formatted bounce data
+    h = e.damn                  # Hashに変換
+    j = e.dump('json')          # JSON(文字列)に変換
+    puts e.dump('json')         # JSON化したバウンスメールの解析結果を表示
   end
 end
 ```
 
 Convert to JSON
 ---------------------------------------------------------------------------------------------------
-下記のようにSisimaiの`dump()`メソッドをmboxかMaildirのPATHを引数にして実行すると解析結果が文字列(JSON)
-で返ってきます。
+下記のようにSisimaiの`dump()`メソッドをmboxかMaildirのPATHを引数にして実行すると解析結果が文字列
+(JSON)で返ってきます。
 
 ```ruby
-# Get JSON string from parsed mailbox or Maildir/
-puts Sisimai.dump('/path/to/mbox')  # or path to Maildir/
+# メールボックスまたはMaildir/から解析した結果をJSONにする
+puts Sisimai.dump('/path/to/mbox')  # またはMaildir/へのPATH
 
-# dump() method also accepts "delivered" option like the following code:
-puts Sisimai.dump('/path/to/mbox', delivered: true)
+# dump()メソッドは"delivered"オプションや"vacation"オプションも指定可能
+puts Sisimai.dump('/path/to/mbox', delivered: true, vacation: true)
 ```
 
 Callback feature
 ---------------------------------------------------------------------------------------------------
-`Sisimai.rise`と`Sisimai.dump`の`:c___`引数はコールバック機能で呼び出されるProcオブジェクトを保持する
-配列です。`:c___`の1番目の要素には`Sisimai::Message.parse`で呼び出されるProcオブジェクトでメールヘッダ
-と本文に対して行う処理を、2番目の要素には、解析対象のメールファイルに対して行う処理をそれぞれ入れます。
+`Sisimai.rise`と`Sisimai.dump`の`:c___`引数(`c`と`_`が三個/魚用の釣り針に見える)はコールバック機能
+で呼び出される`Proc`オブジェクトを保持する配列です。`:c___`の1番目の要素には`Sisimai::Message.sift`
+で呼び出される`Proc`オブジェクトでメールヘッダと本文に対して行う処理を、2番目の要素には、解析対象の
+メールファイルに対して行う処理をそれぞれ入れます。
 
-各Procオブジェクトで処理した結果は`Sisimai::Data.catch`を通して得られます。
+各Procオブジェクトで処理した結果は`Sisimai::Fact.catch`を通して得られます。
 
 ### [0] メールヘッダと本文に対して
 `:c___`に渡す配列の最初の要素に入れたProcオブジェクトは`Sisimai::Message->parse()`で呼び出されます。
@@ -187,8 +227,8 @@ Callback feature
 #! /usr/bin/env ruby
 require 'sisimai'
 code = lambda do |args|
-  head = args['headers']    # (*Hash)  Email headers
-  body = args['message']    # (String) Message body
+  head = args['headers']    # (*Hash)  メールヘッダー
+  body = args['message']    # (String) メールの本文
   adds = { 'x-mailer' => '', 'queue-id' => '' }
 
   if cv = body.match(/^X-Postfix-Queue-ID:\s*(.+)$/)
@@ -206,8 +246,8 @@ puts data[0].catch['queue-id']  # "43f4KX6WR7z1xcMG"
 ```
 
 ### 各メールのファイルに対して
-`Sisimai->rise()`と`Sisimai->dump()`の両メソッドに渡せる引数`c___`(配列リファレンス)の2番目に入れた
-コードリファレンスは解析したメールのファイルごとに呼び出されます。
+`Sisimai.rise`と`Sisimai.dump`の両メソッドに渡せる引数`:c___`(配列)の2番目に入れた`Proc`オブジェクト
+は解析したメールのファイルごとに呼び出されます。
 
 ```ruby
 path = '/path/to/maildir'
@@ -215,10 +255,10 @@ code = lambda do |args|
   kind = args['kind']   # (String) Sisimai::Mail.kind
   mail = args['mail']   # (String) Entire email message
   path = args['path']   # (String) Sisimai::Mail.path
-  sisi = args['sisi']   # (Array)  List of Sisimai::Data
+  fact = args['fact']   # (Array)  List of Sisimai::Fact
 
-  sisi.each do |e|
-    # Insert custom fields into the parsed results
+  fact.each do |e|
+    # "catch"アクセサの中に独自の情報を保存する
     e.catch ||= {}
     e.catch['size'] = mail.size
     e.catch['kind'] = kind.capitalize
@@ -229,18 +269,18 @@ code = lambda do |args|
     end
     e.catch['parsedat'] = Time.new.localtime.to_s
 
-    # Append X-Sisimai-Parsed: header and save into other path
-    a = sprintf("X-Sisimai-Parsed: %d", sisi.size)
+    # "X-Sisimai-Parsed:"ヘッダーを追加して別のPATHに元メールを保存する
+    a = sprintf("X-Sisimai-Parsed: %d", fact.size)
     p = sprintf("/path/to/another/directory/sisimai-%s.eml", e.token)
     v = mail.sub(/^(From:.+?)$/, '\1' + "\n" + a)
     f = File.open(p, 'w:UTF-8')
     f.write(v)
     f.close
 
-    # Remove the email file in Maildir/ after parsed
+    # 解析が終わったらMaildir/にあるファイルを削除する
     File.delete(path) if kind == 'maildir'
 
-    # Need to not return a value
+    # 特に何か値をReturnする必要はない
   end
 end
 
@@ -262,41 +302,113 @@ $ ruby -rsisimai -e 'puts Sisimai.dump($*.shift)' /path/to/mbox
 
 Output example
 ---------------------------------------------------------------------------------------------------
-![](https://libsisimai.org/static/images/demo/sisimai-dump-02.gif)
+![](https://libsisimai.org/static/images/demo/sisimai-5-cli-dump-r01.gif)
 
 ```json
-[{"catch":{"x-mailer":"","return-path":"neko@example.com"},"token":"7e81d3b9306fc7a7f3fb4c7b705189d6806d3d6b","lhost":"omls-1.kuins.neko.example.jp","rhost":"nekonyaan0022.apcprd01.prod.exchangelabs.com","alias":"","listid":"","reason":"userunknown","action":"failed","origin":"set-of-emails/maildir/bsd/lhost-office365-13.eml","subject":"にゃーん","messageid":"","replycode":"550","smtpagent":"Office365","hardbounce":true,"smtpcommand":"","destination":"neko.kyoto.example.jp","senderdomain":"example.com","feedbacktype":"","diagnosticcode":"Error Details Reported error: 550 5.1.10 RESOLVER.ADR.RecipientNotFound; Recipient not found by SMTP address lookup DSN generated by: NEKONYAAN0022.apcprd01.prod.exchangelabs.com","diagnostictype":"","deliverystatus":"5.1.10","timezoneoffset":"+0000","addresser":"neko@example.com","recipient":"kijitora-nyaan@neko.kyoto.example.jp","timestamp":1493508885}]
+[
+  {
+    "destination": "google.example.com",
+    "lhost": "gmail-smtp-in.l.google.com",
+    "hardbounce": 0,
+    "reason": "authfailure",
+    "catch": null,
+    "addresser": "michitsuna@example.jp",
+    "alias": "nekochan@example.co.jp",
+    "smtpagent": "Postfix",
+    "smtpcommand": "DATA",
+    "senderdomain": "example.jp",
+    "listid": "",
+    "action": "failed",
+    "feedbacktype": "",
+    "messageid": "hwK7pzjzJtz0RF9Y@relay3.example.com",
+    "origin": "./gmail-5.7.26.eml",
+    "recipient": "kijitora@google.example.com",
+    "rhost": "gmail-smtp-in.l.google.com",
+    "subject": "Nyaan",
+    "timezoneoffset": "+0900",
+    "replycode": 550,
+    "token": "84656774898baa90660be3e12fe0526e108d4473",
+    "diagnostictype": "SMTP",
+    "timestamp": 1650119685,
+    "diagnosticcode": "host gmail-smtp-in.l.google.com[64.233.187.27] said: This mail has been blocked because the sender is unauthenticated. Gmail requires all senders to authenticate with either SPF or DKIM. Authentication results: DKIM = did not pass SPF [relay3.example.com] with ip: [192.0.2.22] = did not pass For instructions on setting up authentication, go to https://support.google.com/mail/answer/81126#authentication c2-202200202020202020222222cat.127 - gsmtp (in reply to end of DATA command)",
+    "deliverystatus": "5.7.26"
+  }
+]
 ```
 
-Sisimai Specification
+Differences between Sisimai 4 and Sisimai 5
 ===================================================================================================
-Differences between Ruby version and Perl version
+[Sisimai 4.25.16p1](https://github.com/sisimai/rb-sisimai/releases/tag/v4.25.16p1)と
+[Sisimai 5](https://github.com/sisimai/rb-sisimai/releases/tag/v5.0.0)には下記のような違いがあります。
+それぞれの詳細は[Sisimai | 違いの一覧](https://libsisimai.org/ja/diff/)を参照してください。
+
+Features
+---------------------------------------------------------------------------------------------------
+Sisimai 5.0.0から**Ruby 2.4以上**が必要になります。
+
+| 機能                                                 | Sisimai 4          | Sisimai 5           |
+|------------------------------------------------------|--------------------|---------------------|
+| 動作環境(CRuby)                                      | 2.1 -              | **2.4** or later    |
+| 動作環境(JRuby)                                      | 9.0.4.0 - 9.1.17.0 | **9.2** or later    |
+| 元メールファイルを操作可能なコールバック機能         | なし               | あり[^3]            |
+| 解析エンジン(MTA/ESPモジュール)の数                  | 68                 | 70                  |
+| 検出可能なバウンス理由の数                           | 29                 | 34                  |
+| 依存Gem数(Ruby Standard Gemsを除く)                  | 1 Gem              | 1 Gem               |
+| ソースコードの行数                                   | 10,800 行          | 11,370 行           |
+| テストフレームワーク                                 | rspec              | minitest            |
+| テスト件数(spec/またはtest/ディレクトリ)             | 311,000 件         | 338,000 件          |
+| 1秒間に解析できるバウンスメール数[^4]                | 231 通             | 305 通              |
+| ライセンス                                           | 2条項BSD           | 2条項BSD            |
+| 開発会社による商用サポート                           | 提供中             | 提供中              |
+
+[^3]: `Sisimai.rise`メソッドで指定する`:c___`パラメーター第二引数で指定可能
+[^4]: macOS Monterey/1.6GHz Dual-Core Intel Core i5/16GB-RAM/Ruby 3.3.0
+
+Decoding Method
+---------------------------------------------------------------------------------------------------
+いくつかの解析メソッド名、クラス名、パラメーター名がSisimai 5で変更になっています。解析済みデータの
+各項目は[LIBSISIMAI.ORG/JA/DATA](https://libsisimai.org/ja/data/)を参照してください。
+
+| 解析用メソッド周辺の変更箇所                         | Sisimai 4          | Sisimai 5           |
+|------------------------------------------------------|--------------------|---------------------|
+| 解析メソッド名                                       | `Sisimai.make`     | `Sisimai.rise`      |
+| 出力メソッド名                                       | `Sisimai.dump`     | `Sisimai.dump`      |
+| 解析メソッドが返すオブジェクトのクラス               | `Sisimai::Data`    | `Sisimai::Fact`     |
+| コールバック用のパラメーター名                       | `hook`             | `c___`[^5]          |
+| ハードバウンスかソフトバウンスかを識別するメソッド名 | `softbounce`       | `hardbounce`        |
+| "vacation"をデフォルトで検出するかどうか             | 検出する           | 検出しない          |
+| Sisimai::Messageがオブジェクトを返すかどうか         | 返す               | 返さない            |
+| MIME解析用クラスの名前                               | `Sisimai::MIME`    | `Sisimai::RFC2045`  |
+| SMTPセッションの解析をするかどうか                   | しない             | する[^6]            |
+
+[^5]: `:c___`は漁港で使う釣り針に見える
+[^6]: `Sisimai::SMTP::Transcript.rise`メソッドによる
+
+MTA/ESP Module Names
 ---------------------------------------------------------------------------------------------------
-公開中のPerl版Sisimai(p5-sisimai)とRuby版Sisimai(rb-sisimai)は下記のような違いがあります。bounceHammer
-2.7.13p3とSisimai(シシマイ)の違いについては[Sisimai | 違いの一覧](https://libsisimai.org/ja/diff/)を
-ご覧ください。
-
-| 機能                                        | Ruby version   | Perl version  |
-|---------------------------------------------|----------------|---------------|
-| 動作環境                                    | Ruby 2.4 - 2.7 | Perl 5.10 -   |
-|                                             | JRuby 9.0.4.0- |               |
-| 解析精度の割合(2000通のメール)[1]           | 1.00           | 1.00          |
-| メール解析速度(1000通のメール)              | 2.22秒[2]      | 1.35秒        |
-| インストール方法                            | gem install    | cpanm, cpm    |
-| 依存モジュール数(コアモジュールを除く)      | 1モジュール    | 2モジュール   |
-| LOC:ソースコードの行数                      | 10300行        | 10500行       |
-| テスト件数(spec/,t/,xt/ディレクトリ)        | 453000件       | 311000件      |
-| ライセンス                                  | 二条項BSD      | 二条項BSD     |
-| 開発会社によるサポート契約                  | 提供中         | 提供中        |
-
-1. [./ANALYTICAL-PRECISION](https://github.com/sisimai/rb-sisimai/blob/master/ANALYTICAL-PRECISION)を参照
-2. Xeon E5-2640 2.5GHz x 2 cores | 5000 bogomips | 1GB RAM | Ruby 2.3.4p301
-
-Other spec of Sisimai
+Sisimai 5で3個のESPモジュール名(解析エンジン)が変更になりました。詳細はMTA/ESPモジュールの一覧/
+[LIBSISIMAI.ORG/JA/ENGINE](https://libsisimai.org/ja/engine/)を参照してください。
+
+| `Sisimai::Rhost::`                                   | Sisimai 4          | Sisimai 5           |
+|------------------------------------------------------|--------------------|---------------------|
+| Microsoft Exchange Online                            | `ExchangeOnline`   | `Microsoft`         |
+| Google Workspace                                     | `GoogleApps`       | `Google`            |
+| Tencent                                              | `TencentQQ`        | `Tencent`           |
+
+Bounce Reasons
 ---------------------------------------------------------------------------------------------------
-- [**解析モジュールの一覧**](https://libsisimai.org/ja/engine/)
-- [**バウンス理由の一覧**](https://libsisimai.org/ja/reason/)
-- [**Sisimai::Dataのデータ構造**](https://libsisimai.org/ja/data/)
+Sisimai 5では新たに5個のバウンス理由が増えました。検出可能なバウンス理由の一覧は
+[LIBSISIMAI.ORG/JA/REASON](https://libsisimai.org/en/reason/)を参照してください。
+
+| バウンスした理由                                     | Sisimai 4          | Sisimai 5           |
+|------------------------------------------------------|--------------------|---------------------|
+| ドメイン認証によるもの(SPF,DKIM,DMARC)               | `SecurityError`    | `AuthFailure`       |
+| 送信者のドメイン・IPアドレスの低いレピュテーション   | `Blocked`          | `BadReputation`     |
+| PTRレコードが未設定または無効なPTRレコード           | `Blocked`          | `RequirePTR`        |
+| RFCに準拠していないメール[^7]                        | `SecurityError`    | `NotCompliantRFC`   |
+| 単位時間の流量制限・送信速度が速すぎる               | `SecurityError`    | `Speeding`          |
+
+[^7]: RFC5322など
 
 Contributing
 ===================================================================================================
@@ -305,7 +417,7 @@ Bug report
 もしもSisimaiにバグを発見した場合は[Issues](https://github.com/sisimai/rb-sisimai/issues)にて連絡を
 いただけると助かります。
 
-Emails could not be parsed
+Emails could not be decoded
 ---------------------------------------------------------------------------------------------------
 Sisimaiで解析できないバウンスメールは
 [set-of-emails/to-be-debugged-because/sisimai-cannot-parse-yet](https://github.com/sisimai/set-of-emails/tree/master/to-be-debugged-because/sisimai-cannot-parse-yet)リポジトリに追加してPull-Requestを送ってください。
@@ -315,7 +427,7 @@ Other Information
 Related sites
 ---------------------------------------------------------------------------------------------------
 * __@libsisimai__ | [Sisimai on Twitter (@libsisimai)](https://twitter.com/libsisimai)
-* __libSISIMAI.ORG__ | [Sisimai | The successor to bounceHammer, Library to parse bounce mails](https://libsisimai.org/)
+* __LIBSISIMAI.ORG__ | [SISIMAI | MAIL ANALYZING INTERFACE | DECODING BOUNCES, BETTER AND FASTER.](https://libsisimai.org/)
 * __Sisimai Blog__ | [blog.libsisimai.org](http://blog.libsisimai.org/)
 * __Facebook Page__ | [facebook.com/libsisimai](https://www.facebook.com/libsisimai/)
 * __GitHub__ | [github.com/sisimai/rb-sisimai](https://github.com/sisimai/rb-sisimai)
@@ -338,7 +450,7 @@ Author
 
 Copyright
 ===================================================================================================
-Copyright (C) 2015-2023 azumakuniyuki, All Rights Reserved.
+Copyright (C) 2015-2024 azumakuniyuki, All Rights Reserved.
 
 License
 ===================================================================================================