[rails/rails] ActionViewのバグレポートテンプレートにテンプレートファイルレンダリング例を追加

Context

ActionViewに関するバグレポートでは、ビューテンプレートのレンダリング問題を再現可能なコードとして提示することが困難な場合が多い。現状のバグレポートテンプレートには、インラインレンダリングの例しか含まれておらず、実際のテンプレートファイルを使用したテストケースの書き方が示されていなかった。この結果、不明瞭で再現不可能なIssueが多く作成され、トリアージと解決の効率が低下していた。

このPRでは、ActionViewのバグレポートテンプレートに、実際のテンプレートファイルを使用したレンダリング例を追加することで、より具体的で再現可能なバグレポートを促進する。

Technical Detail

テンポラリビューパスの管理

テストのsetupとteardownでテンポラリディレクトリを管理する仕組みが追加された：

setup do
  @view_path = Pathname.new(Dir.mktmpdir)
  ActionController::Base.prepend_view_path @view_path
end

teardown do
  @view_path.rmtree
end

Dir.mktmpdirで作成した一時ディレクトリをActionController::Base.prepend_view_pathでビューパスの先頭に追加し、テスト終了時に削除する。これにより、テスト用のテンプレートファイルを実際のファイルシステム上に配置してレンダリングをテストできる。

テンプレートファイル作成ヘルパー

新たにview_fileプライベートメソッドが追加され、テスト用のビューファイルを動的に作成できるようになった：

private
  def view_file(filename, contents)
    pathname = @view_path.join(filename)
    pathname.dirname.mkpath
    pathname.write(contents)
  end

このヘルパーは、指定されたファイル名（パス含む）のディレクトリを自動的に作成し、テンプレートの内容を書き込む。

テンプレートファイルレンダリングのテスト例

実践的なテストケースとして、パーシャルレンダリングを含む例が追加された：

def test_action_view_render_template
  view_file "posts/index.html.erb", <<~ERB
    <h1>Posts</h1>

    <% posts.each do |post| %>
      <%= render partial: "posts/post", locals: { post: post } %>
    <% end %>
  ERB

  view_file "posts/_post.html.erb", <<~ERB
    <p><%= upcase(post) %></p>
  ERB

  render template: "posts/index", locals: { posts: ["hello world"] }

  assert_equal "HELLO WORLD", rendered.html.at("p").text
end

この例では、以下の要素を含む実践的なテストパターンを示している：

メインテンプレート（posts/index.html.erb）とパーシャル（posts/_post.html.erb）の使用
render template:によるテンプレートファイルのレンダリング
localsを使った変数の受け渡し
ヘルパーメソッド（upcase）の使用
rendered.htmlによるレンダリング結果の検証

既存テストの改名

既存のtest_stuffメソッドはtest_action_view_render_inlineに改名され、インラインレンダリングのテストであることが明確化された。これにより、テンプレートファイルレンダリングとインラインレンダリングの2つのアプローチが明確に区別される。

Impact

この変更により、ActionViewのバグレポートに以下の改善がもたらされる：

再現性の向上: 実際のファイル構造を持つテストケースを簡単に作成できる
複雑なケースへの対応: パーシャルレンダリングやネストしたテンプレートなど、より現実的なシナリオのテストが可能
メンテナンスの効率化: 明確で実行可能なバグレポートにより、Issue解決までの時間を短縮

バグレポートテンプレートの充実は、OSSプロジェクトにおけるコミュニティとのコミュニケーション品質を向上させる重要な取り組みである。