ハナミ 3.0 のリリース！モジュール化された Ruby フレームワークへの進化

ハナミは当初から、明確でモジュール化され、拡張性を備えたシステムという方針で開発されてきました。本日、その方針に沿った ハナミ 3.0 が正式に発表されます！今回のリリースでは、フレームワークを以下の 三大新機能 とパフォーマンスの劇的な向上で大幅に進化させました。

🚀 メインの新機能と強化点

• メーラー（メール送信機能）：以前失くしていた機能が戻ってきました。
• 国際化（i18n）：アプリケーションの世界展開が容易になりました。
• Minitest テストフレームワークへの対応：RSpec と Minitest の両方をサポートします。

これらに加えて、デフォルト設定での高速化やログの明確化など、開発体験全体の向上を図っています。

📧 一等市民待遇のメーラー機能

統合されたメーラー機能が標準搭載され、アクション、ビュー、操作（operations）と調和した形で利用できるようになりました。

メーラークラスの基本構造

メーラークラスは、メール送信に必要なすべての要素を記述します。

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 ホストの環境変数設定だけで利用可能です。
• テスト環境：メールはメモリ上に蓄積され、確認・検証が可能です。
• 高度なカスタマイズ：独自の配信メソッドを記述可能で、配信オプションのチェーン（連鎖）化をサポートしています。

ハナミ メーラーは低レベル処理を担当する名作 mail gem を基盤としています。

🌍 インターナショナル化（i18n）機能内蔵

アプリケーションの世界展開が今よりずっと簡単になりました。「i18n」gem が直接組み込まれ、翻訳バックエンドの設定やヘルパーが即座に利用可能です。

翻訳データの管理

翻訳データは

config/i18n/

config/i18n/en.yml

en:
  posts:
    index:
      title: "Latest posts"
    create:
      created: "Your post is live!"
  greetings:
    welcome: "Welcome, %{name}!"

翻訳ヘルパーの利用例

• ビュー内：

  <h1><%= t(".title") %></h1>
  

• アクション内：

  def handle(request, response)
    response.flash[:notice] = t(".created")
    # ...
  end
  

• 独自コンポーネント内（

  Deps["i18n"]

  を介して取得）：

  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"

✅ Minitest との連携

ハナミは従来の RSpec セットアップを維持しつつ、新しい Minitest サポートを追加しました。アプリケーション生成時にテストフレームワークを選定可能です。

クイックスタート：Minitest 採用

$ hanami new my_app --test=minitest

• RSpec はデフォルトですが、必要であれば Minitest を採用できます。
• 同等の完全なセットアップ環境が即座に提供されます。

🚄 デフォルト設定で大幅に高速化

ハナミ 3.0 は導入直後から恩恵を受けるレベルの劇的な速度向上を達成しました。

パフォーマンスの目覚ましい改善

• スループット向上：HTTP を介した同一リクエストの実行速度が約 3 倍 に向上。
• メモリ使用量低減：テスト用アプリケーションでのメモリ使用量は微々たるものとなり、リクエストあたりの割当（allocation）数は約 14 倍 減少。
• タイルラテンシー縮小：p99 が 89ms から 4ms に急落。

なぜ这么快？

• コンポーネントのメモ化：コンテナ内の各コンポーネントは一度解決すれば再利用され、再構築がなくなります。
• アクション設定のスナップショット化：

  Hanami::Action

  が各アクションの設定を事前に取り込むため、リクエストごとの再計算が不要に。
  • 最小限のアクションでは割当数が 88 → 17 に減少（約 3.7 倍 高速化）。
• ビュー描画の最適化：

  Hanami::View

  が設定スナップショット処理を受け、余計な装飾処理が不要に。
  • 最小限の描画では割当数が 100 → 42 に減少（約 2.9 倍 高速化）。

これらすべての機能は無料で利用可能です！アップグレードだけでコード変更なしで高速化を実現できます。

📝 より明確で有用なログ

開発から本番環境まで、ログ機能を見直しました。

• 開発環境：デフォルトでカラー化されたログが表示され、SQL ステートメントも統一フォーマットに整形されます。

  rouge

  gem をバンドルすれば構文ハイライトも可能。
• SQL ログの抑制：本番環境での出力を静かにするため、SQL ステートメントのログレベルが

  :info

  から

  :debug

  へ変更されます（

  config.db.log_level

  で調整可能）。
• 環境変数設定：アプリケーションクラス内の設定よりも優先される

  HANAMI_LOG_LEVEL

  環境変数でログレベルを簡便に設定可能。

ハナミは内部構造においてロギングのインタフェースを不変化し、以下の機能を標準で保証します：

• 構造化ロギング：キーワード引数を通じて標準メソッドからアクセス。
• タグ付きロギング：

  #tagged

  ブロックを通じてログ付けが可能。

📦 よりスムーズなアセットウォッチ

「hanami assets watch」 は作業ペースに追従するよう進化しました。

• 新規・削除されたエントリーポイントや、静的アセット（画像、フォントなど）の変更をリアルタイムで検出。
• 監視プロセスの再起動が必要なくなるとおり、開発フローが妨げられる心配がありません。

また、あらゆるアセットバンドラーがハナミへのクリーンなプラグイン方法を規定する仕様を制定しました。当社のバンドラー（esbuild 系）を基盤としつつ、バンドラーロックインを防ぎ、ユーザー自らの好きなバンドラーの導入を歓迎しています。

🔄 ハナミ アクションへボディパーサー機能の統合

リクエストボディのパース処理が Middleware から取り出され、ハナミ アクション内に移転しました。

• フォーマット駆動型：アクションは受け入れるフォーマットに合わせて正確にパースを行ないます。
• 標準パーサー搭載：Multipart フォームボディと JSON パーサーが標準で利用可能。
• カスタムパーサー登録：必要であれば独自のパーサーを登録できます。

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

🎨 装飾されなかったエクスポジションによるシンプル化されたビュー

現在、ビューのエクスポジション（exposure）はデフォルトで装飾されません。テンプレートは要求通り受け取り、余計な作業を避けます。

• 明示的な装飾が必要な場合：新しい

  .decorate

  メソッドを使用します。
• 従来の動作に戻したい場合：

  config.decorate_exposures = true

  を設定します。

🧹 よりクリーンな基盤

メジャーバージョンアップで基盤を整理整頓しました。

Gem 名の統一と廃止

• hanami-controller

  →

  hanami-action

  に改名（クラス名と一致）。
  • 依存関係設定時は

    hanami-action

    または

    hanami/action

    を使用してください。

• hanami-validations

  が廃止。ハナミ アクションが直接

  dry-validation

  を呼び出すため、不要な中間 gem を省きました。

Ruby バージョン必須化

ハナミ 3.0 では Ruby 3.3 またはそれ以降の使用を必須としています。 これにより動く部品が減り、gem の名前は明確になり、アプローチが容易になりました。

✨ さらに多くの機能！

• ジェネレーター強化：
  • 新しい「hanami generate provider」と「hanami generate mailer」を追加。
  • 全てのジェネレーターに

    --force

    オプション（既存ファイル上書き）を付与。

  • hanami new

    にアプリ名空間を別途設定する

    --name

    オプション追加。

  • hanami new

    で

    gem.coop

    から gem をインストール可能に。
• テンプレートエンジンの可視化：
  • エンジン用のテンプレート作成時に

    --template-engine

    オプション対応（erb, haml, slim）。
  • 生成されたアプリケーションは Puma 7.1 を要求し、アプリプリローディング用テンプレート削除。
• ルーターの明確化：
  • ルーター内に明示的なリダイレクトヘルパー（

    permanent_redirect

    ,

    temporary_redirect

    ）を追加。通常のリダイレクトには明示的な

    code:

    引数が必要に。
• 設定検索の効率化：複数のストア間で設定検索を連鎖させるための

  Hanami::Settings::CompositeStore

  を追加。
• スライスの返却変更：

  Hanami::Slice.with_slices

  がすべてのスライス（ネストを含む）を返すようになった。
• ビュー情報のエクスポート：現在描画中のテンプレート名を

  template_name

  および

  current_template_name

  としてエクスポート（相対 i18n キー検索対応）。
• エラーハンドリング改善：ルートが存在しない場合、スライスを Rack アプリとして呼び出すための便利なエラーを抛出するように改良。
• ハナカイの新しいウェルカム画面：美しいビジュアルを実装（感謝 マックス！）。

📢 是非お試しください！

ハナミ 3.0 の新しいアプリケーションは数コマンドですぐに始められます。

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

あなたの活用状況について聞きたいです！フォーラムやチャットで声をかけてください。私たちはコミュニティを非常にフレンドリーに保ち、常にハナミの旅路にお手伝いすることに喜んでおります。

2.3 からのアップグレード

すでに 2.3 を使用中の方は、3.0 アップグレードノート をご確認ください。

👏 コントリビューターへのご感謝！

今回のリリースに貢献してくださった皆様：

• Aaron Allen, Adam Lassek, Carolyn Cole, Edouard, Jane Sandberg
• Joshua Young, Konstantin Haase, Kyle Plump, Matthew Stanton
• Max Wheeler, Paweł Świątkowski, Philip Arndt, Ramón Valles
• Sean Collins, Tim Riley, Wout, Yi Sangwon

ビジネススポンサーへ：

• 🥇 Sidekiq：プラチナスポンサー
• 🥈 Brandon Weaver：ゴールドスポンサー
• 🥉 Honeybadger, FastRuby.io, AppSignal, SerpApi：シルバー・スポンサー

GitHub Sponsors および Open Collective を通じた個人の方々の支援も大いに感謝申し上げます。

本日、ハナミは満開を迎えていますが、庭園は決して完成するものではありません。その実現のためには、皆様の支援が不可欠です。ぜひスポンサーの仲間になってください。