Ruby3.3/3.4でhamlit・haml:replace_erbsが動かない問題の解決法

はじめに

Ruby 3.3以降にアップデートした際、hamlit gemのインストールエラーや haml:replace_erbs タスクの実行エラーに直面したため、その際に行った対処方法を備忘録としてまとめます。
間違えていましたら、コメントをいただけますと幸いです。

環境

macOS（arm64-darwin）
Ruby 3.4.2 → 3.3.5
Rails 8
rbenv 使用

問題1: hamlit gemのインストールエラー

エラー内容

bundle install

実行時に以下のエラーが発生

Gem::Ext::BuildError: ERROR: Failed to build gem native extension.
error: 'stdckdint.h' file not found with <angled> include; use "quotes" instead
   48 | # include <stdckdint.h>
      |           ^~~~~~~~~~~~~
3 warnings and 1 error generated.
make: *** [hamlit.o] Error 1

原因

Ruby3.4系の内部ヘッダ仕様変更にhamlit3.0.3が対応していないため。stdckdint.h の参照方法が変更されたが、hamlitがまだ追従できていない。

解決方法

Rubyバージョンをダウングレードをしました

# Ruby 3.3.5をインストール
rbenv install 3.3.5

# プロジェクトだけ3.3.5を使用
cd ~/my_blog_app
rbenv local 3.3.5

# バージョン確認
ruby -v
# => ruby 3.3.5 (2024-09-24 revision ...) [arm64-darwin]

# Gemを再インストール
bundle install

これでhamlitのビルドエラーが出なくなりました。

問題2: haml:replace_erbs タスクエラー

エラー内容

bundle exec rake haml:replace_erbs

実行時のエラー：

Looking for ERB files to convert to Haml...
rake aborted!
NoMethodError: undefined method `exists?' for module FileTest (NoMethodError)

        unless FileTest.exists?(haml_path)
                       ^^^^^^^^
Did you mean?  exist?

原因

Ruby 3.2: FileTest.exists? が非推奨化
Ruby 3.3: 完全に削除
古いhaml-railsのタスク内でまだ FileTest.exists? を使用

解決方法

方法1: 互換パッチを追加

Rakefile の先頭に以下を追記

# Add your own tasks in files placed in lib/tasks ending in .rake,
# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.

# Ruby 3.3 以降で削除された FileTest.exists? を復活させる互換パッチ
module FileTest
  class << self
    alias_method :exists?, :exist?
  end
end

require_relative "config/application"

Rails.application.load_tasks

方法2: gemアップデート

# haml-rails が Gemfile にない場合は追加
echo "gem 'haml-rails'" >> Gemfile

bundle update haml haml-rails

※新しいバージョンがRuby3.3に対応している場合のみ有効らしい。

方法3: 直接変換コマンドを使用

# 1ファイルずつ変換
bundle exec html2haml app/views/articles/show.html.erb app/views/articles/show.html.haml

実行結果

パッチ適用後、正常に動作しました。

bundle exec rake haml:replace_erbs
Looking for ERB files to convert to Haml...
Converting: app/views/articles/show.html.erb -> app/views/articles/show.html.haml
Converting: app/views/layouts/application.html.erb -> app/views/layouts/application.html.haml
Done!

その他の対処法

hamlit を使わない場合

Gemfileから削除

# gem 'hamlit'  # コメントアウト

標準のhamlやerbを使用する。

Ruby3.4を使い続けたい場合

GitHubの開発ブランチを直接指定する。

gem 'hamlit', github: 'k0kubun/hamlit', branch: 'master'

まとめ

hamlit: Ruby3.4は未対応なので3.3系を使用した。
haml:replace_erbs: FileTest.exists? 削除による問題は互換パッチを使用する。
安定性重視: プロダクション環境では実績のあるRuby3.3系が推奨みたい。

参考記事

初学者のため、間違えていたらすいません。