bamboo v0.4.0 Bamboo.Test
Helpers for testing email delivery
Use these helpers with Bamboo.TestAdapter to test email delivery. Typically you’ll want to unit test emails first. Then in integration tests use helpers from this module to test whether that email was delivered.
In your config
# Typically in config/test.exs
config :my_app, MyApp.Mailer,
adapter: Bamboo.TestAdapter
Unit test
You don’t need any special functions to unit test emails.
defmodule MyApp.EmailsTest do
use ExUnit.Case
test "welcome email" do
user = %User{name: "John", email: "person@example.com"}
email = MyApp.Email.welcome_email(user)
assert email.to == user
assert email.subject == "This is your welcome email"
assert email.html_body =~ "Welcome to the app"
end
end
Integration test
defmodule MyApp.Email do
import Bamboo.Email
def welcome_email(user) do
new_email(
from: "me@app.com",
to: user,
subject: "Welcome!",
text_body: "Welcome to the app",
html_body: "<strong>Welcome to the app</strong>"
)
end
end
defmodule MyApp.EmailDeliveryTest do
use ExUnit.Case
use Bamboo.Test
test "sends welcome email" do
user = %User{...}
email = MyApp.Email.welcome_email(user)
email |> MyApp.Mailer.deliver_now
# Works with deliver_now and deliver_later
assert_delivered_email MyAppEmail.welcome_email(user)
end
end
Summary
Functions
Checks whether an email was delivered
Checks that no emails were sent
Ensures a particular email was not sent
Macros
Imports Bamboo.Test and Bamboo.Formatter.format_email_address/2
Functions
Checks whether an email was delivered.
Must be used with the Bamboo.TestAdapter or this will never pass. If a Bamboo.Email struct is passed in, it will check that all fields are matching.
You can also pass a keyword list and it will check just the fields you pass in.
Examples
email = Bamboo.Email.new_email(subject: "something")
email |> MyApp.Mailer.deliver
assert_delivered_email(email) # Will pass
unsent_email = Bamboo.Email.new_email(subject: "something else")
assert_delivered_email(unsent_email) # Will fail