withnic/power_assert_ex

Power Assert in Elixir. Shows evaluation results each expression.

Power Assert

Power Assert for Elixir.

Example test is here:

test "Enum.at should return the element at the given index" do
  array = [1, 2, 3, 4, 5, 6]; index = 2; two = 2
  assert array |> Enum.at(index) == two
end

And the result is like the following:

  1) test Enum.at should return the element at the given index (PowerAssertTest)

     array |> Enum.at(index) == two
     |             |  |         |
     |             3  2         2
     [1, 2, 3, 4, 5, 6]

Enjoy 💪 !

Dependencies

• ExUnit

Installation

# add dependencies in mix.exs
defp deps do
  [
    {:power_assert, "~> 0.0.8"}
  ]
end

# and fetch
$ mix deps.get

How to use

# replace `use ExUnit.Case` into `use PowerAssert` in your test code

## before
defmodule YourAwesomeTest do
  use ExUnit.Case  # <-- **HERE**
end

## after
defmodule YourAwesomeTest do
  use PowerAssert  # <-- **REPLACED**
end

when ExUnit.CaseTemplate

# insert `use PowerAssert` with `ExUnit.CaseTemplate.using/2` macro

## before
defmodule YourAwesomeTest do
  use ExUnit.CaseTemplate
end

## after
defmodule YourAwesomeTest do
  use ExUnit.CaseTemplate

  # add the following
  using do
    quote do
      use PowerAssert
    end
  end
end

useful command to replace use ExUnit.Case

$ git grep -l 'use ExUnit\.Case' | xargs sed -i.bak -e 's/use ExUnit\.Case/use PowerAssert/g'

How to use other framework depending on ExUnit such as ExSpec or ShouldI

ExSpec

Append use PowerAssert after use ExSpec:

defmodule ExSpecBasedTest do
  use ExSpec
  use PowerAssert   # <-- append

  describe "describe" do
    it "it" do
      assert something == "hoge"
    end
  end
end

See also: test/ex_spec/ex_spec_test.exs

ShouldI

Append use PowerAssert after use ShouldI:

defmodule ShouldTest do
  use ShouldI
  use PowerAssert   # <-- append

  should "inside should" do
    assert something == "hoge"
  end
end

See also: test/should/should_test.exs

API

assert(expression, message \\ nil)

Limitation

• NOT SUPPORTED
  • match expression ex: assert List.first(x = [false])
  • fn expression ex: assert fn(x) -> x == 1 end.(2)
  • :: expression ex: << x :: bitstring >>
    • this means string interpolations also unsupported ex: "#{x} hoge"
  • sigil expression ex: ~w(hoge fuga)
  • quote arguments ex: assert quote(@opts, do: :hoge)
  • case expression
  • get_and_update_in/2, put_in/2, update_in/2, for/1
  • <<>> expression includes attributes <<@x, "y">>; <<x :: binary, "y">>
  • __MODULE__.Foo
  • many macros maybe caught error...

Resources

• Testing with Power Assert in Elixir projects
• Power Assert Inside in Elixir

License

Distributed under the Apache 2 License.

Check LICENSE files for more information.