ファイル存在チェックの強化

[kmuto]

#1726 のEPUB coverimage対応と、PDFMakerの外部ファイル取り込み部のチェック強化です。

• EPUBMaker: coverimage指定時に実ファイルがないときにバックトレースではなくエラーメッセージで終了させる(ApplicationErrorを明示raiseするようにしました)。
• PDFMaker: coverimage指定時に実ファイルがないときにコンパイル前に即エラーするようにしました。
• PDFMaker: titlefile, creditfile, profileなどで外部ファイルをインポートするよう設定しているときにファイルの存在チェックをするようにしました(pdfmaker.rb#make_custom_page 内)。

実ファイルが絡むのでテストを作りづらい…。

[takahashim]

Suggested change

	rescue StandardError => e
	rescue ApplicationError => e

ReVIEW::ConfigError等を拾うのであれば ApplicationError でできます（何でもStandardErrorで握りつぶしてしまうのは良くなさそうなので）

[kmuto]

ERBのbindでエラーが出たときにSyntaxError, ZeroDivisionErrorなど予想がつかない生の例外がきてしまうんですよね。ApplicationErrorで拾えなくて困っています。

[kmuto]

StandardErrorにしていた理由としては、
たとえばlayouts/config-local.tex.erbを以下のように用意したとして

<%= 1/0 %>

ApplicationErrorのみの捕捉だと

Traceback (most recent call last):
	17: from /home/kmuto/review/bin/review-pdfmaker:14:in `<main>'
	16: from /home/kmuto/review/lib/review/pdfmaker.rb:93:in `execute'
	15: from /home/kmuto/review/lib/review/pdfmaker.rb:147:in `execute'
	14: from /home/kmuto/review/lib/review/pdfmaker.rb:287:in `generate_pdf'
	13: from /home/kmuto/review/lib/review/pdfmaker.rb:194:in `build_pdf'
	12: from /home/kmuto/review/lib/review/pdfmaker.rb:498:in `template_content'
	11: from /home/kmuto/review/lib/review/template.rb:15:in `generate'
	10: from /home/kmuto/review/lib/review/template.rb:30:in `result'
	 9: from /usr/lib/ruby/2.5.0/erb.rb:876:in `result'
	 8: from /usr/lib/ruby/2.5.0/erb.rb:876:in `eval'
	 7: from (erb):2:in `template_content'
	 6: from /home/kmuto/review/lib/review/pdfmaker.rb:478:in `latex_config'
	 5: from /home/kmuto/review/lib/review/template.rb:15:in `generate'
	 4: from /home/kmuto/review/lib/review/template.rb:30:in `result'
	 3: from /usr/lib/ruby/2.5.0/erb.rb:876:in `result'
	 2: from /usr/lib/ruby/2.5.0/erb.rb:876:in `eval'
	 1: from (erb):1:in `latex_config'
(erb):1:in `/': divided by 0 (ZeroDivisionError)

と生の例外がきてバックトレースが出てしまいます。バックトレースを出さずに妥当なエラーメッセージだけを表示したいとなると全捕捉するしかなさそうで困っているのでした。

例は極端ですが、String期待のつもりがnilでエラーを起こすみたいなパターンはそれなりにありそうです。

[takahashim]

うーん、テンプレートまで手を入れている場合、むしろバックトレース等含めてエラー出してくれた方がテンプレート編集のデバッグがやりやすくないですか…？（どこまで手を入れるかにもよりますが）

*.re を編集してる程度では出したくない、というのはあります。

[kmuto]

上記のトレースだと7より上のものが無意味なのが気にいらないんですよねぇ…。まぁlayouts.tex.erbやconfig-local.erbを持ってる時点で覚悟せよとすべきか。ただconfig.erbレベルでももしかしたらconfig.ymlによってはERBエラー起こせるかも。

[takahashim]

そうですね、config.yml の設定でバックトレースが出るのもうれしくない（役に立たない）ので、config関連の値チェックを適宜追加するのは良いかなと思います。

[takahashim]

*.reや*.ymlではバックトレースや内部のエラーメッセージは出さないけど、*.rbとか*.erbは別扱い、というところで区別するのがいいですかねえ。

[kmuto]

今のTemplateからだとApplicationErrorをスローするものがないのでrescue ApplicationErrorはだめそうでした。
とはいえRe:VIEWとしてエラーとしては把握しているよということを示さずにクラッシュするというのは気持ちが悪いので、full_message のほうを使ってみました。

rake pdf
 ...
 ERROR   template or configuration error: Traceback (most recent call last):
	17: from /home/kmuto/review/bin/review-pdfmaker:14:in `<main>'
	16: from /home/kmuto/review/lib/review/pdfmaker.rb:93:in `execute'
	15: from /home/kmuto/review/lib/review/pdfmaker.rb:147:in `execute'
	14: from /home/kmuto/review/lib/review/pdfmaker.rb:287:in `generate_pdf'
	13: from /home/kmuto/review/lib/review/pdfmaker.rb:194:in `build_pdf'
	12: from /home/kmuto/review/lib/review/pdfmaker.rb:496:in `template_content'
	11: from /home/kmuto/review/lib/review/template.rb:15:in `generate'
	10: from /home/kmuto/review/lib/review/template.rb:30:in `result'
	 9: from /usr/lib/ruby/2.5.0/erb.rb:876:in `result'
	 8: from /usr/lib/ruby/2.5.0/erb.rb:876:in `eval'
	 7: from (erb):2:in `template_content'
	 6: from /home/kmuto/review/lib/review/pdfmaker.rb:478:in `latex_config'
	 5: from /home/kmuto/review/lib/review/template.rb:15:in `generate'
	 4: from /home/kmuto/review/lib/review/template.rb:30:in `result'
	 3: from /usr/lib/ruby/2.5.0/erb.rb:876:in `result'
	 2: from /usr/lib/ruby/2.5.0/erb.rb:876:in `eval'
	 1: from (erb):1:in `latex_config'
(erb):1:in `/': divided by 0 (ZeroDivisionError)

これだといかがでしょう。

[takahashim]

なるほどです、このあたりが落とし所でしょうか。