Swoosh.TestAssertions (Swoosh v1.3.3) View Source

This module contains a set of assertions functions that you can import in your test cases.

It is meant to be used with the Swoosh.Adapters.Test module.

Link to this section Summary

Functions

Asserts email was not sent.

Asserts any email was sent.

Asserts email was sent.

Asserts no emails were sent.

Asserts no emails were sent.

Asserts email with attributes was not sent.

Sets Swoosh test adapter to global mode.

Link to this section Functions

Link to this function

assert_email_not_sent(email)

View Source

Specs

assert_email_not_sent(Swoosh.Email.t()) :: false | no_return()

Asserts email was not sent.

Performs exact matching of the email struct.

Specs

assert_email_sent() :: tuple() | no_return()

Asserts any email was sent.

Link to this function

assert_email_sent(email)

View Source

Specs

assert_email_sent(
  Swoosh.Email.t()
  | Keyword.t()
  | (Swoosh.Email.t() -> boolean())
) :: :ok | tuple() | no_return()

Asserts email was sent.

You can pass a keyword list to match on specific params or an anonymous function that returns a boolean.

Examples

iex> alias Swoosh.Email
iex> import Swoosh.TestAssertions

iex> email = Email.new(subject: "Hello, Avengers!")
iex> Swoosh.Adapters.Test.deliver(email, [])

# assert a specific email was sent
iex> assert_email_sent email

# assert an email with specific field(s) was sent
iex> assert_email_sent subject: "Hello, Avengers!"

# assert an email that satisfies a condition
iex> assert_email_sent fn email -> length(email.to) == 2 end

Specs

assert_no_email_sent() :: false | no_return()

Asserts no emails were sent.

Link to this macro

refute_email_sent()

View Source (macro)

Asserts no emails were sent.

Link to this macro

refute_email_sent(attributes)

View Source (macro)

Asserts email with attributes was not sent.

Performs pattern matching using the given pattern, equivalent to pattern = email.

When a list of attributes is given, they will be converted to a pattern.

It converts list fields (:to, :cc, :bcc) to a single element list if a single value is given (to: "email@example.com" => to: ["email@example.com"]).

After conversion, performs pattern matching using a map of email attributes, similar to %{attributes...} = email.

Link to this function

set_swoosh_global(context \\ %{})

View Source

Sets Swoosh test adapter to global mode.

In global mode, emails are consumed by the current test process, doesn't matter which process sent it.

An ExUnit case where tests use Swoosh in global mode cannot be async: true.

Examples

defmodule MyTest do
  use ExUnit.Case, async: false

  import Swoosh.Email
  import Swoosh.TestAssertions

  setup :set_swoosh_global

  test "it sends email" do
    # ...
    assert_email_sent(subject: "Hi Avengers!")
  end
end