Text::Xslate::TTerse の undocumented な動作

content.tt

Out of WRAPPER
[%- WRAPPER 'wrapper.tt' WITH arg1 = var, arg2 = 'literal' -%]
arg2: [% arg2 %]
[%- END -%]

render.pl

use strict;
use warnings;
use Text::Xslate;

my $tx = Text::Xslate->new(syntax => 'TTerse', cache => 0);
print $tx->render('content.tt', { var => 42 });

wrapper.tt

arg1: [% arg1 %]
content: [% content %]

render.pl の実行結果は:

Xslate: Useless use of text 'Out of WRAPPER' at render.pl line 6.
arg1: 42
content: arg2: literal

ここから 3 つの文書化されていない挙動がうかがえる。

1. WRAPPER ステートメントの外側の記述 (Out of WRAPPER) は無視される。
   • ドキュメント には WRAPPER ステートメントの外側に関する記述はない。
2. WRAPPER ステートメントの引数 (arg1) に変数 (var) を渡せる。
   • ドキュメントには “The argument of WRAPPER, however, must be string literals,” とある。
3. WRAPPER ステートメントの内容において、引数 (arg2) を変数のように扱える。

いずれの挙動も、今後互換性を壊す変更はしないつもりです。この挙動をテストするコードをpull-requestでいただけると、意図せず壊すこともなくなります。

具体的には、1はドキュメント化されてないだけで想定どおりの挙動、2はドキュメントの間違い、3は意図しない挙動でたまたま動いているだけですがいまの振る舞いを変更すべきでない、とそれぞれステータスは違うのですが、互換性を壊す変更をするつもりがないという点では一致しています。

回答ありがとうございます。