README.md

ExUnitEx

ExUnitEx provides extra assertions for testing processes side effects when invoking functions that start or stop several processes. These new assertions are assert_processes_started, assert_processes_stopped, and assert_processes_survived macroses for using in ExUnit tests.

The assertion macros will take in two arguments - the function that starts or stops the processes and a list of expected process side effects. The expected process side effects will be in the form of a keyword list, where each key represents a process and the value is a list of expected side effects for that process. When assertion succeeds, it returns the result of passed function.

  defmodule ExUnitEx.AssertionsTest do
    use ExUnit.Case, async: true
    import ExUnitEx.Assertions

    test "assert_processes_started success" do
      assert :processes_started ==
               assert_processes_started(
                 fn -> :processes_started end,
                 registry: %{
                   test_registry_one: :agent_foo,
                   test_registry_two: [:agent_bar, :agent_baz]
                 },
                 names: [:foo, :bar, :baz]
               )
    end
  end

Installation

If available in Hex, the package can be installed by adding ex_unit_ex to your list of dependencies in mix.exs:

def deps do
  [
    {:ex_unit_ex, "~> 0.1.0"}
  ]
end

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/ex_unit_ex.