PerlとRubyの最低バージョン

Sisimai 5からPerl版は 5.26.0以上が、Ruby版は 2.4.0以上が必要になりました。 インストールやアップグレードを実行する前にシステムのPerlや Rubyのバージョンを必ず確認してください。

% perl -v

This is perl 5, version 32, subversion 0 (v5.32.0) built for darwin-2level

Copyright 1987-2020, Larry Wall
                

% ruby -v
ruby 3.3.0 (2023-12-25 revision 5124f9ac75) [x86_64-darwin21]
                

make()メソッドの廃止とrise()メソッドの新設

Sisimai 5.0.0でSisimaiクラスのmake() メソッドが廃止になりました。make()メソッドは実行時に警告が出ますが Sisimai 5.1.0までは使用可能です。

Sisimai 5.0.0で新しく実装されたrise()メソッドを使ってください。

% perl -MSisimai -lE 'print Sisimai->make(shift)' ./test.eml
 ***warning: Sisimai->make will be removed at v5.1.0. Use Sisimai->rise instead
% perl -MSisimai -lE 'my $p = Sisimai->rise(shift)' ./test.eml
                

% ruby -rsisimai -e 'print Sisimai.make($*.shift)' ./test.eml
 ***warning: Sisimai.make will be removed at v5.1.0. Use Sisimai.rise instead
% ruby -rsisimai -e 'p = Sisimai.rise($*.shift)' ./test.eml
                

"softbounce"の廃止と"hardbounce"の新設

Sisimai 5.0.0でSisimai::Dataクラスのsoftbounce() メソッドと解析結果の"softbounce"が廃止になりました。 softbounce()メソッドは実行時に警告が出ますがSisimai 5.1.0 までは使用可能です。

Sisimai 5.0.0で新しく実装されたhardbounce()メソッドならびに 解析結果の"hardbounce"を使ってください。

% perl -MSisimai -lE 'print Sisimai->rise(shift)->[0]->softbounce;' ./test.eml
 ***warning: Sisimai::Fact->softbounce will be removed at v5.1.0.
            Use Sisimai::Fact->hardbounce instead
                

% ruby -rsisimai -e 'print Sisimai.rise($*.shift)[0].softbounce' ./test.eml
 ***warning: Sisimai::Fact.softbounce will be removed at v5.1.0.
            Use Sisimai::Fact.hardbounce instead
                

Sisimai::Dataクラスの廃止

解析結果のデータ構造を保持するSisimai::DataクラスはSisimai 5.0.0でSisimai::Factに変りました。PerlやRubyで解析結果のオブジェクト のクラス名を参照している場合はご注意下さい。

% perl -MSisimai -lE 'print ref Sisimai->rise(shift)' ./test.eml
Sisimai::Fact
                

% ruby -rsisimai -e 'print Sisimai.rise($*.shift)[0].class' ./test.eml; echo
Sisimai::Fact
                

"vacation"を解析しない

Sisimai 5.0.0からバウンス理由が"vacation" となるバウンスメールをデフォルトで解析しなくなりました。必要な場合は以下のように vacationオプションをSisimaiクラスのrise()メソッド 第二引数に指定してください。

#! /usr/bin/env perl
use Sisimai;
my $f = './set-of-emails/maildir/bsd/rfc3834-01.eml';
my $v = Sisimai->rise($f, 'vacation' => 1);
for my $e ( @$v ) {
    print $e->action;           # ""
    print $e->deliverystatus;   # ""
    print $e->reason;           # "vacation"
    print $e->diagnosticcode;   # "I am currently away returning to the office on May 5th."
    print $e->hardbounce;       # 0
}
                

#! /usr/bin/env ruby
require 'sisimai'
f = './set-of-emails/maildir/bsd/rfc3834-01.eml'
v = Sisimai.rise(f, vacation: true)
v.each do |e|
  puts e.action         # ""
  puts e.deliverystatus # ""
  puts e.reason         # "vacation"
  puts e.diagnosticcode # "I am currently away returning to the office on May 5th."
  puts e.hardbounce     # false
end
                

コールバック機能の引数

Sisimai 5.0.0でSisimaiクラスのrise()メソッド (旧make()メソッド)に渡すコールバック用の引数は、hookから c___に変りました。

同時に、引数に入れるデータは2個の要素をもつ配列リファレンスまたはArray オブジェクトに変っています。 詳細はコールバック機能を確認してください。