More than 3 years have passed since last update.

ActionMailboxでRSpecのテストを書く

Last updated at 2021-06-08Posted at 2021-06-08

この記事の内容

メール受信周りの機能を実装中、RSpecでActionMailboxのテストを書くことになりました。

RailsガイドやパーフェクトRuby on RailsにはMiniTestの事例しか載っておらず、日本語の資料も少なかったので手順をメモしておきます。

ただし、ActionMailboxの実像そのものは他に良い記事がたくさんあるので、本記事ではあくまでもRSpecによるテスト記載について取り扱っています。

前提

使用したRailsとRSpecのバージョンは下記の通りです。

Rails 6.0.0
RSpec 5.0.1

また、テスト対象のMailBox内ではこのようにprocessメソッドを使ってメール送信処理を実装しています。

examples_mailbox.rb

class ExamplesMailbox < ApplicationMailbox
  before_processing :set_organization

  def process
   # ...
  end
end

準備

rspec-railsのバージョンをRails６系対応にする

ActionMailboxがRails6の機能なので、RSpecもRails６に対応したものにする必要があります（←ここに気づかなくて結構ハマった）。

RSpecのGithubのReadmeによるとRails6系にはRSpec5系が必要なようなので、RSpecをアップデート合わせます。

bundle update rspec

依存するGemのアップデートが必要だと出たら、それもアップデートしましょう。

RSpecで`ActionMailbox::TestHelper`を使えるようにする

Rails（Mini Test）の機能である、ActionMailbox::TestHelperをRSpecでも使いたいので、spec/rails_helper.rbに以下のように記載します。

spec/rails_helper.rb

require 'action_mailbox/test_helper'

RSpec.configure do |config|
  config.include ActionMailbox::TestHelper, type: :mailbox
end

これで、　type: :mailboxのテストの際にActionMailbox::TestHelperのメソッドが使えるようになります。

実装

実際に書いたコードは概ね下記の通りです。

spec/mailboxes/examples_mailbox_spec.rb

require 'rails_helper'

RSpec.describe ExamplesMailbox, type: :mailbox do

  it "@your-domain-name.jpあてのメールを受信できる" do
    expect(ExamplesMailbox)
      .to receive_inbound_email(to: "sample@your-domain-name.jp")
  end

  context 'メールが送信された時' do
    let!(:mail) {
      Mail.new(
        from: 'replies@example.com',
        to: 'sample@your-domain-name.jp',
        subject: "メールのタイトル"
      )
    }

    it 'logが一件生成される' do
      expect{ process(mail) }.to change(Log, :count).by(1)
    end

    # 以下略 ...
  end
end