katafrakt

katafrakt

Using Hammox as a spy?

Suppose I have a code like this:

defmodule Spy do
  @analytics Application.compile_env!(:spy, :analytics)

  def create_article(params) do
    case insert_article(params) do
      {:ok, article} ->
        @analytics.record(:article_created, article)
        if params.published, do: @analytics.record(:article_published, article)
      
      {:error, error} -> {:error, error}
    end
  end

  defp insert_article(params) do
    id = :rand.uniform(1000)
    {:ok, Map.put(params, :id, id)}
  end
end

A typical tests for it would look like this:

defmodule SpyTest do
  use ExUnit.Case
  import Hammox

  defmock(AnalyticsMock, for: Analytics)

  test "old approach: not published" do
    expect(AnalyticsMock, :record, fn :article_created, payload ->
      assert payload.title == "Test"
      :ok
    end)

    Spy.create_article(%{title: "Test", published: false})
  end

  test "old approach: published" do
    expect(AnalyticsMock, :record, fn :article_created, payload ->
      assert payload.title == "Test"
      :ok
    end)

    expect(AnalyticsMock, :record, fn :article_published, payload ->
      assert payload.title == "Test"
      :ok
    end)

    Spy.create_article(%{title: "Test", published: true})
  end
end

While this of course works, it provides a couple disadvantages in my opinion:

  • You don’t follow “arrange-act-assert”, as you actually assert at the beginning
  • In case of testing for publish, you have to add both expectations in a single test case, otherwise you’d get an error.

As a result, I’ve been thinking about bending Hammox to my will a bit and force it to act more like a spy, where I record the interactions somehow and assert about them in the end. Of course, it should ideally work with async tests.

I came up with something like this:

defmodule SpyTest do
  use ExUnit.Case
  import Hammox

  defmock(AnalyticsMock, for: Analytics)

  defmodule AnalyticsStub do
    @behaviour Analytics
    def record(event, payload) do
      send(self(), {:analytics, event, payload})
    end
  end

  describe "new approach" do
    setup do
      stub_with(AnalyticsMock, AnalyticsStub)
      :ok
    end

    test "not published" do
      Spy.create_article(%{title: "Test", published: false})
      assert_received({:analytics, :article_created, payload})
      assert payload.id > 0
    end

    test "published - record creation" do
      Spy.create_article(%{title: "Test", published: true})
      assert_received({:analytics, :article_created, _})
    end

    test "published - record publish" do
      Spy.create_article(%{title: "Test", published: true})
      assert_received({:analytics, :article_published, _})
    end
  end
end

To me it reads much better and I wonder: is someone using an approach like this already? Or maybe there’s a different tool for that? If not, could it be a terrible idea for some reason I don’t yet see?

It might need some setup to ensure the process inbox is empty before running the test, but it is doable and aside from that?

Most Liked

schneebyte

schneebyte

That sounds like trace based testing - Testing System/Unit Behaviour Using Traces/Logs/Signals

The example might be easier to test if its decoupled and the create_article just publishes an event {:article_created, article} that your analytics stuff (or your tests) can subscribe to.

Where Next?

Popular in Questions Top

chokchit
** (DBConnection.ConnectionError) connection not available and request was dropped from queue after 2733ms. You can configure how long re...
New
siddhant3030
Hi, I have to write a raw query for one of my project. But till now I have used ecto queries and don’t have much experience writing raw ...
New
earth10
Hi, I’m just starting to build a side-project with Elixir and Phoenix and doing some basic test with Elixir alone. What strikes me is th...
New
joeerl
Hello again - after a longish gap I’ve decided I really must dig into Elixir and see what’s been happening here - so I have a few questio...
New
jononomo
I am trying to figure out how Mix knows whether the environment is test, dev, or prod – where is this set? Thanks.
New
belgoros
I’m not a pro in using Regex and can’t figure out why the following behaviour happens, especially if we take into account the difference ...
New
nobody
How to bind a phoenix app to a specific ip address? could not find anything about that, nowhere, unfortunately, but for me this is quite...
New
Lily
In templates/appointment/index.html.eex: <%= for appointment <- @appointments do %> <tr> <td><%= appoi...
New
rms.mrcs
Hi, I need to transform a list of numbers into a map where the keys are the indexes and the values are the original values of the list. ...
New
PeterCarter
There are pre-rolled solutions for other frameworks that do work. However, Phoenix does not seem to have these. Have people had good expe...
New

Other popular topics Top

aadeshere1
I have a another noob question about loop. Since elixir is immutable, while loop is not directly possible. total = 10 while total != 0 ...
New
mcarvalho
What is the difference between System.get_env and Application.get_env? For example, what are best practices to use one versus another.
New
chrismccord
Phoenix 1.4.0 released Phoenix 1.4 is out! This release ships with exciting new features, most notably with HTTP2 support, improved deve...
688 30877 112
New
johnnyicon
Hi all, I’ve just started learning Elixir and Phoenix Framework, so please pardon my n00bness at this stage. I’m trying to use Postgres...
New
jerry
Good day to you all. I have been struggling to get a query involving like and ilike to work. Can anyone assist me on this, please? pro...
New
jay1
Why is it that the mnesia database isn’t the most preferred database for use in Elixir/Phoenix?
New
nobody
Hi! In PHP: $_SERVER[‘SERVER_ADDR’] - in Elixir? Searched the docs for ip address and the web, no good results. Thanks!
New
jason.o
In the code below, if the create action is not set to accept “extra_key” as an input, it errors out with a message shown above. Is there ...
New
svb
Hi! Currently I want to submit a form by pressing the Enter key. However, since my input field is of type “textarea” this is just adds a...
New
lanycrost
Hi everyone! I need implement if…else if…else condition from my elixir code, and anymore of this control flow structures not work proper...
New

We're in Beta

About us Mission Statement