HN 日本語サマリー

← 一覧へ戻る
Web開発

Hanami 3.0: 満開

Hanami 3.0: In Full Bloom (hanakai.org)

75 pointsby PuercoPop24 コメント

要約

Hanami 3.0がリリースされ、Rubyフレームワークとしての成熟を迎えました。このバージョンでは、メール機能、国際化(i18n)、Minitestのサポートが主要な新機能として追加されています。また、デフォルトでのパフォーマンスが大幅に向上し、ログ機能が改善され、アセット監視やボディパーシングもよりスムーズになっています。

全文翻訳

Hanami 3.0: 満開

当初から、私たちはHanamiを明確でモジュール化され、成長するように構築された、異なる種類のRubyフレームワークにすることを目指してきました。今日、それは満開を迎えます。Hanami 3.0 を皆様と共有できることを嬉しく思います!

このリリースでは、メーラー、国際化、Minitest という3つの大きな新機能でフレームワークが完成しました。さらに、アプリはデフォルトで高速化され、ログからアセットに至るまで、開発者体験がよりシャープになりました。

ファーストクラスのメーラー

長らく失われていたgemが復活しました!Hanamiアプリには、アクション、ビュー、オペレーションの隣に自然に収まる統合メーラーが付属するようになりました。

メーラークラスは、メールを配信するために必要なすべてを記述します。

module Bookshelf
  module Mailers
    class Welcome < Bookshelf::Mailer
      from "welcome@bookshelf.test"
      to { |user:| user.email }
      subject { |user:| "Welcome to Bookshelf, #{user.name}!" }

      expose :user
    end
  end
end

スタンドアロンオブジェクトとして、メーラーはDepsミックスイン経由で注入可能で、必要な場所でアクセスできます。.deliverを呼び出すと、メーラーは入力を使用してヘッダーを準備し、メール本文テンプレートをレンダリングします。これはビューレイヤーの完全な拡張機能として機能します。

メーラーは複数の配信方法をサポートしています。SMTP配信はすぐに利用できます。SMTPホストのいくつかの環境変数を設定すれば準備完了です。テストでは、メールはメモリに蓄積され、検査できるようになります。

さらに高度な機能が必要な場合は、独自の配信方法を作成することもできます。これらに対するクリーンなインターフェースに加えて、Hanami Mailerは、メーラー全体に配信オプションをスレッド化するためのフックを提供しており、新しい配信方法がメール配信プロバイダーが提供する特別な機能を最大限に活用できるようにします。

他のすべてのgemと同様に、Hanami Mailerはスタンドアロンでの使用も考慮して設計されています。詳細については、包括的なREADMEをご覧ください。

Hanami Mailerは、すべての低レベルのメール処理を処理するために、古くからあるmail gemに依存しています。長年のご尽力に感謝いたします。mailメンテナーの皆様、ありがとうございました!

標準搭載の国際化

アプリを世界に展開することがより簡単になりました。i18nがHanamiに組み込まれました。i18n gemをバンドルすると、Hanamiはアプリと各スライスに自己完結型の翻訳バックエンドを設定し、アクションやビュー全体でtranslateとlocalizeヘルパーがすぐに使用できるようになります。

翻訳は、アプリまたはスライスのconfig/i18n/に保存されます。

# config/i18n/en.yml
en:
  posts:
    index:
      title: "Latest posts"
    create:
      created: "Your post is live!"
  greetings:
    welcome: "Welcome, %{name}!"

そこから、i18nヘルパーは期待されるすべての場所で利用できます!ビューのように:

<%# app/templates/posts/index.html.erb %>
<h1><%= t(".title") %></h1>

アクションのように:

# app/actions/posts/create.rb
def handle(request, response)
  response.flash[:notice] = t(".created")
  # ...
end

そして、それ以外の場所では、"i18n"コンポーネントはDepsミックスインからわずか1つ離れたところにあります。

class Greeter
  include Deps["i18n"]

  def call(name)
    i18n.t("greetings.welcome", name:)
  end
end

ローカライゼーションも提供しています。localizeは現在のロケールに合わせて日付と時刻をフォーマットし、英語の適切なデフォルト値が付属しています。

localize(Date.new(2026, 5, 22))
# => "Fri, 22 May 2026"

localize(Time.new(2026, 5, 22, 9, 5), format: :short)
# => "22 May 9:05 am"

Hanamiのすべての側面と同様に、i18nは最小限の設定でそのまま動作するように設計されていますが、カスタムが必要な場合は多くの設定があります。完全な情報はi18nガイドをご覧ください。

internationalizationという単語はi18n gemなしでは綴れません。このgemがこの新機能のすべての重い処理を行います。したがって、i18nメンテナーの皆様に、オーストラリア英語で「cheers, mates」と感謝を伝えたいと思います。世界中のRubyistの皆様のお役に立てて嬉しいです!

Minitest搭載

Hanamiは常にすぐに使えるRSpecセットアップを提供してきました。ブランドニューのMinitestサポートのおかげで、残りの半分の皆様を幸せにできることをついに嬉しく思います!

アプリを生成する際に、テストフレームワークを選択してください。

$ hanami new my_app --test=minitest

RSpecは引き続きデフォルトですが、Minitestを選択すると、自分で構築する必要なく、同等の完全なセットアップが得られるようになります。

Minitestの開発に貢献してくださったRyan Davis氏とすべての貢献者の皆様に、心より感謝申し上げます。MinitestはRuby自体に付属しており、今後もHanamiの一部として提供できることを嬉しく思います。

デフォルトで高速化

Hanami 3.0は大幅に高速化されており、最初からそのメリットを享受できます。テストアプリでは、同じリクエストがHTTP経由で約3.7倍高速に実行され、メモリ使用量はごくわずかです。

Hanamiはデフォルトでコンポーネントをメモ化するようになりました。これは、アプリのコンテナ内の各コンポーネントが一度だけ解決され、その後再利用されることを意味します。毎回新しく構築されるわけではありません。

これは実際に体感できる変更です。9つのコンポーネントのグラフを解決しビューをレンダリングするアクションを持つアプリを測定し、2.3と3.0で同じリクエストを測定しました。3.0では、リクエストあたりの割り当てが14分の1になり、HTTP経由のスループットは約3.7倍(インプロセスで測定した場合は約9倍、サーバーがボトルネックにならない場合)になりました。テールレイテンシも低下しました。p99は、リクエストあたりの割り当ての乱雑さとGCポーズがなくなったことで、20msから4msに減少しました。

フレームワークの最も頻繁に使用される部分のパフォーマンス改善にも注力しました。

  • Hanami Actionは、リクエストごとに再計算するのではなく、アクションの設定を事前にスナップショットし、リクエストあたりの割り当てを大幅に削減します。最小限のアクションは88の割り当てから14に減少し、84%削減され、単独では約4.5倍高速に実行されます。
  • Hanami Viewも同様の設定スナップショット処理を受け、デフォルトでエクスポージャーを装飾しなくなりました。最小限のレンダリングは88の割り当てから39に減少し、約2.9倍高速に実行されます。

これらすべての最良の部分は何でしょうか?無料のランチです!3.0にアップグレードすれば、コードを変更することなく、アプリはより少ないメモリで、より高速に実行されます。

3.0のパフォーマンス作業の多くを主導してくれたSean Collins氏に特別な感謝を。以前よりも3.7倍多く愛しています!

より明確で有用なログ

3.0では、日常の開発と本番の両方でログに愛情を注ぎました。

開発環境では、ログはデフォルトで色付けされるようになりました。SQLステートメントはリクエストログに合わせてフォーマットされ、rouge gemがバンドルされている場合はシンタックスハイライトもされます。

[画像: Hanami logs]

SQLステートメントは、本番ログをより静かにするために、:infoレベルではなく:debugレベルでログ記録されるようになり、config.db.log_levelで調整できます。

また、環境変数HANAMI_LOG_LEVELからログレベルを便利に設定できます。これはアプリクラスの設定よりも優先されます。

内部的には、Hanamiはロガーの一貫したインターフェースを保証するようになりました(サードパーティの置き換えを設定した場合でも)。そのため、常に以下を信頼できます。

  • 構造化ロギング:標準のログメソッドに渡されるキーワード引数経由。
  • タグ付きロギング:#taggedブロック経由。

詳細については、改訂されたロガーガイドをご覧ください。

よりスムーズなアセット監視

hanami assets watchは、より多くの作業に追随できるようになりました。新しく追加または削除されたエントリーポイントを検出し、画像やフォントなどの静的アセットの変更に反応します。以前のバージョンでは、これらのそれぞれでウォッチャーを再起動する必要がありました。今では追随するだけなので、フローを維持できます!

また、どの資産バンドラーでもHanamiにきれいにプラグインできる仕様を公開しました。私たち自身のバンドラーはesbuildに基づいていますが、ロックインされていると感じてほしくありません!お気に入りのバンドラーをHanamiに持ち込んでいただけると嬉しいです。

Hanami Actionへのボディ解析機能の追加

Hanamiのリクエストボディ解析機能はミドルウェアからHanami Actionに移り、現在はformats設定によって駆動されています。アクションは受け入れるフォーマットを正確に解析し、コンテンツネゴシエーションの他の部分と並行して設定できます。

マルチパートフォームボディとJSONのパーサーはすぐに利用できます。さらに別のものが必要な場合は、独自のものを登録できます。

formats.register(:custom, "application/custom", parser: ->(body, env) { ... })

フォーマットとメディアタイプガイドで詳細をご覧ください。

装飾されていないエクスポージャーによるシンプルなビュー

ビューエクスポージャーはデフォルトで装飾されなくなりました。テンプレートは、装飾を求めない限り、装飾なしで、公開されたものを正確に受け取ります。これはより予測可能なデフォルトであり、装飾が厳密に必要ない場合に余分な作業を回避します。

装飾したい場合は、新しい.decorateメソッドがコード内でそれらのエクスポージャーを際立たせます。config.decorate_exposures = trueを使用して、ビュー全体で以前の動作を元に戻すこともできます。

よりクリーンな基盤

メジャーバージョンアップは、家を整理する機会です。

  • hanami-controllerはhanami-actionになりました。gemの名前がついに長年使用してきたクラスと一致しました。hanami-actionまたはhanami/actionとしてrequireしてください。
  • hanami-validationsは廃止されました。Hanami Actionは、アクションのパラメータとコントラクトのために直接dry-validationを参照するようになり、間のgemが1つ減りました。

Hanami 3.0はRuby 3.3以降が必要です。

これにより、可動部分が減り、使用するgemの名前が明確になり、全体としてより親しみやすいHanamiになりました。

その他多数!

3.0では、他にも多くの小さな改良が加えられました。

  • 新しいhanami generate providerおよびhanami generate mailerジェネレーター。
  • すべてのジェネレーターに--forceオプションが追加され、既存のファイルを上書きするのではなく、停止せずに処理できるようになりました。
  • hanami newの--nameオプションにより、アプリの名前空間をディレクトリパスとは別に設定できます:hanami new my_bookshelf --name=bookshelf。
  • hanami newがgemをgem.coopのnamespaceからインストールするための--gem-source=gem.coop。
  • 生成されたアプリはPuma 7.1を必要とし、config/puma.rbからアプリの事前ロードのボイラープレートを削除しました。
  • hanami newおよびhanami generateの--template-engineオプションは、指定されたエンジン(erb、haml、またはslim)のテンプレートを作成します。アプリクラスのconfig.default_template_engineでプロジェクト全体のデフォルトを設定します。
  • ルーターでの明示的なリダイレクトヘルパー:permanent_redirect(301)およびtemporary_redirect(302)。プレーンなredirectは、明確にするために明示的なcode:引数を必要とするようになりました。
  • Hanami::Settings::CompositeStoreにより、複数のストアにわたる設定ルックアップをチェーンできます。
  • Hanami::Slice.with_slicesは、スライスとそのすべてのネストされたスライスを一緒に返します。
  • Hanami Viewは、現在レンダリングされているテンプレート名をHanami::View::Scope#template_nameおよびHanami::View::Context#current_template_nameとして公開します(これは相対i18nキーのルックアップをサポートします)。
  • ルートがないRackアプリとして呼び出されたスライスに対して、役立つエラーを発生させます。
  • 様々な修正:ルーターへのマルチパートアップロード、配列変数を使用したURL生成、generate actionでの重複ルートなど。
  • 美しい新しいウェルカムスクリーン。Hanakaiのビジュアルにマッチしています。(Max氏に感謝!)

[画像: Welcome screen in light mode]

[画像: Welcome screen in dark mode]

試してみる

新しいHanami 3.0アプリは、数コマンドで利用できます。

$ gem install hanami
$ hanami new my_app
$ cd my_app
$ bin/hanami dev
$ open http://localhost:2300

皆様の体験談をお聞かせください!フォーラムまたはチャットでぜひお声がけください。私たちのコミュニティは非常にフレンドリーで、皆様のHanamiの旅をいつでも喜んでお手伝いします。

2.3からのアップグレード

すでに2.3をご利用ですか?3.0アップグレードノートで、すべての手順を説明しています。

貢献者の皆様へ感謝!

このリリースに貢献してくださったすべての方々に感謝いたします。

このリリースはHanamiにとってさらに大きな一歩であり、スポンサーの皆様のサポートなしには成し遂げられませんでした。心より感謝申し上げます!

ビジネススポンサーの皆様、ありがとうございます。

そして、GitHub SponsorsおよびOpen Collectiveを通じてHanakaiを支援してくださったすべての個人の方々に感謝いたします。皆様の励ましは私たちにとってかけがえのないものです!

Hanamiは今日満開ですが、庭は決して完成することはなく、私たちはさらに多くのものを育てたいと考えています。皆様のサポートがそれを可能にします。ぜひスポンサーになってください。