Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
61 lines (44 sloc) 1.98 KB
layout title categories published meta
Testing Rails Action Mailbox with RSpec
– blog
description index
Rails 6 ships with Action Mailbox, here is how I added tests for RSpec

Rails 6 ships with some pretty nice new features, the main one I'm pretty excited about is Action Mailbox, however writing RSpec tests for it requires a little bit of extra setup.

Add the support helper

First create a file in spec/support/mailbox.rb, inside it add:

# spec/support/mailbox.rb
require 'action_mailbox/test_helper'

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

This will include the ActionMailbox::TestHelper module, this adds methods like receive_inbound_email_from_source for use in your tests.

A sample RSpec Test

I've been using type: :mailbox and putting them in the spec/mailboxes/ folder, a sample looks like:

# spec/mailboxes/generic_emails_mailbox_spec.rb
require 'rails_helper'

RSpec.describe GenericEmailsMailbox, type: :mailbox do
  subject do
      from: '',
      to: '',
      subject: 'Sample Subject',
      body: "I'm a sample body"

  it do
    expect { subject }.to change(SomeModel, :count).by(1)

Fixing "NotImplementedError"

If you hit an error that looks like:

   Use a queueing backend to enqueue jobs in the future.

This means you're using Active Job in inline mode in your tests, which doesn't play nicely with with Active Mailbox. I fixed this by setting config.active_job.queue_adapter in my test environment to be :test.

# config/environments/test.rb
# Run Active Job in test mode.
config.active_job.queue_adapter = :test
You can’t perform that action at this time.