Skip to content
This repository has been archived by the owner on Oct 8, 2024. It is now read-only.

ActionMailerMatchers provides rspec matchers to test Rails' common ActionMailer functionality.

License

Notifications You must be signed in to change notification settings

trilogy-group/contently-action_mailer_matchers

Repository files navigation

ActionMailerMatchers

ActionMailerMatchers provides RSpec matchers to test common ActionMailer functionality.

Installation

Add this line to your application's Gemfile:

group :test do
  gem 'action_mailer_matchers', '~> 1.0'
end

And then execute:

$ bundle install

Or install it yourself as:

$ gem install action_mailer_matchers

Include ActionMailerMatchers in your RSpec config by requiring it and including in your configuration block.

require "action_mailer_matchers"

...

RSpec.configure do |config|
  config.include ActionMailerMatchers
end

Usage

ActionMailer allows you to send emails in your Rails application, ActionMailerMatchers provides you with RSpec one-liners that help you to test this functionality.

It is typical to test that an email has been delivered by doing the following:

expect { some_action.execute }
 .to change { ActionMailer::Base.deliveries.count }.by(1)

However, this does not specify what email was sent and to where. ActionMailerMatchers solves this problem by providing the have_received_email matcher, which ensures that the passed email address or user (which must respond .email) was the email's "to" address. You may also use the optional subject and body arguments to check that content matches the email you were expecting to send.

expect(some_user).to have_received_email(subject: "My great subject")
expect("address@email.com").to have_received_email(body: "Wonderful email body")

You can also test that someone has not received an email.

expect(some_user).not_to have_received_email

Emails sent to users using bcc or cc can be tested using:

expect("cc@email.com").to have_received_cc_email(body: "Wonderful email body")
expect("bcc@email.com").to have_received_bcc_email(body: "Wonderful email body")

Contributing

  1. Fork it ( https://github.com/contently/action_mailer_matchers/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

About

ActionMailerMatchers provides rspec matchers to test Rails' common ActionMailer functionality.

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages