仕様の詳細

文字コードの扱いについて

入力

基本的には、パーサへの入力は RFC に沿って正しいエンコードがなされているものと想定しています。ですが現実にはそうでないメールも多いので、ある程度の規格外メールは許容しています。たとえば以下のようなヘッダは TMail のサポート対象です。 (ただし $KCODE が適切にセットされていなければいけません)

To: 日本語 <aamine@loveruby.net>
Content-Disposition: attached; filename=日本語.doc

また $KCODE=EUC/SJIS の場合は以下のようなヘッダもパースします。('日本語' は生の iso-2022-jp)

To: 日本語 <aamine@loveruby.net>
To: "日本語" <aamine@loveruby.net>
To: Minero Aoki <aamine@loveruby.net> (日本語)
Content-Disposition: attached; filename=日本語.doc
Content-Disposition: attached; filename="日本語.doc"

クオートやコメント内に EUC や SJIS、UTF8 を生で入れているヘッダはあまりに邪悪すぎるのでサポートしません。

いわゆる半角文字および機種依存文字はとりあえず考慮していません。が、近くない将来ならば多少はなんとかできるかもしれません。

日本語以外のエンコーディングには、M17N Ruby が安定版としてリリースされるまでは対応しません。

デコード出力

TMail の大部分のメソッドは特に断りがない限りデコードした文字列を返します。文字列の中に日本語文字列が存在する場合は、 $KCODE に従いエンコードを変換して返します。ただしサポートするのは $KCODE=EUC/SJIS の場合のみで、それ以外 (つまり NONE か UTF8) のときはエンコーディングは一切変換されません。 Ruby 1.6 以降では $KCODE=NONE がデフォルトなので注意してください。

エンコード出力

encoded メソッドを代表としたエンコード出力メソッドはすべて RFC 的に正しいエンコードを行います (と思います)。出力側でサポートする文字エンコーディングは iso-2022-jp、MIME エンコーディングは Base64/B のみです。これは将来に渡って変えません。

ヘッダにはコメントを含められます。たとえば以下のうち括弧でくくられた部分がコメントです。

To: aamine@loveruby.net (This is comment.)

TMail のパーサはコメントをパースしてヘッダオブジェクトの comments に格納しますが、再文字列化するときはすべて捨てるようになっています。なぜかというと、メールヘッダのコメントは本当にどこにでも置けるようになっているので、パースした後からではコメントがどの場所にあったのか判断できないからです。たとえば以下のようなヘッダはよく見かけます。

Received: from mail.loveruby.net (mail.loveruby.net [192.168.1.1])
        by doraemon.edit.ne.jp (8.12.1/8.12.0) with ESMTP id g0CGj4bo035
        for <aamine@mx.edit.ne.jp>; Sun, 13 Jan 2002 01:45:05 +0900 (JST)

こういう場合、各コメントをどの要素に所属させるかは人間でなければ判断できません。ある程度ヒューリスティックにやることは可能ですが、いったん外れたら完璧に失敗してしまうでしょう。元のヘッダを再生できるように見せかけておいて時々失敗するというのはあまりに有害ですから、それよりは潔く全部捨てる、というのがいまのところの結論です。どうせコメントはコメントであって本質には関係ないのですから、もうコメントに頼るのはやめましょう。

特に、アドレスフィールドにおいて本名をコメントに入れたりするのは最低です。ちゃんと文法的に名前を格納する場所があるのに、わざわざコメントを使う理由は全くありません。そういうヘッダ設定をしている人はすぐにメーラか設定かどちらかを変えましょう。

もっとも、大抵の場合にはこれで問題ないのですが、メールの内容をフィルタリングするような場合は致命傷になりえます。たとえば ML ドライバでは Subject を加工したりしたいでしょうから、次のようなコードを書きたくなります。

mail = TMail::Mail.load(filename)
mail.subject = "[my-list:#{number}] " + mail.subject
mail.write_back

しかしこれではコメントが失われてしまいます。消えてもいいコメントもありますが、Received: のコメントなどは非常に重要です。

これを避けるには、ひとつの TMail::Mail オブジェクトは常に情報取得か出力のどちらかだけに限定して使うことです。将来はもう少しいい方法を考えます。