Skip to content

Latest commit

 

History

History
162 lines (108 loc) · 4.46 KB

Chapter1.md

File metadata and controls

162 lines (108 loc) · 4.46 KB

1 简介

ExUnit是Elixir自带的单元测试框架。

ExUnit很容易使用,下面是一个最简单的例子:

ExUnit.start

defmodule MyTest do
  use ExUnit.Case

  test "the truth" do
    assert true
  end
end

总的来说,我们仅仅需要调用ExUnit.start,用ExUnit.Case定义一个测试实例,以及具体的测试。大部分的测试都作为Mix项目的一部分:

mix test

不然的话,假设你把这个文件存成一个文件assertion_test.exs,我们可以直接运行:

bin/elixir assertion_test.exs

在这一章,我们将讨论ExUnit中最常用的特性和如何进一步定制它。

1.1 开始ExUnit

ExUnit通常以ExUnit.start开头。这个函数接受几个选项,这个文档里有更详细的内容。现在,我们只点出几个最常用的:

  • :formatter - 当你运行测试的时候,所有的IO都是由formatter完成的。开发者能定义它们自己的formatter, 用这个配置能让ExUnit知道去使用定制化的formatter。

  • :max_cases - 我们很快就将看到,ExUnit能让你非常容易地并行运行测试。这可以加快你的测试进度,而且没有副作用。这个选项运行你配置ExUnit最多能同时运行的测试的个数。

1.2 定义一个测例

一旦ExUnit开始了,我们能定义我们自己的测例。这是由我们的模块中的ExUnit.Case完成的:

use ExUnit.Case

ExUnit.Case提供了几个函数,让我们来探查一番。

1.2.1 宏test

ExUnit.Case运行之中所有名字以test开始,并且接受单个参数的的函数:

def test_the_truth(_) do
  assert true
end

作为一种定义上面那样的测例的简便方式,ExUnit.Case提供了一个宏test,可以写成这样:

test "the truth" do
  assert true
end

这种结构可读性更高。宏test接受二进制或原子作为名字。

1.2.2 断言

另一个由ExUnit.Case提供的简便方式,是通过ExUnit.Assertions来自动引入一堆断言宏和函数。

在大部分的测试中,你只需要用到的是断言宏是assertrefute

assert 1 + 1 == 2
refute 1 + 3 == 3

如果测试失败了,ExUnit会自动分解这些表达式,试图提供尽可能详细的信息。例如,这个失败的断言:

assert 1 + 1 == 3

以这种形式:

Expected 2 to be equal to (==) 3

然而,在一些特殊的例子中,一些另外的断言能让测试变得更容易。一个最好的例子是宏assert_raise

assert_raise ArithmeticError, "bad argument in arithmetic expression", fn ->
  1 + "test"
end

所以别忘了查看ExUnix.Assertions的文档中的其他例子。

1.2.3 回调函数

ExUnit.Case定义了四种回调函数:setupteardownsetup_allteardown_all

defmodule CallbacksTest do
  use ExUnit.Case, async: true

  setup do
    IO.puts "This is a setup callback"
    :ok
  end

  test "the truth" do
    assert true
  end
end

在上面的例子中,回调setup将会在每次测试前运行。如果定义了回调setup_all,它将在所有的测试之前运行一次。

一个回调必须返回:ok{ :ok, data }。当返回的是后者的时候,data参数必须是一个包含测试元数据的关键字列表。这个元数据可以被其他回调函数或者测试访问到。

defmodule CallbacksTest do
  use ExUnit.Case, async: true

  setup do
    IO.puts "This is a setup callback"
    { :ok, from_setup: :hello }
  end

  test "the truth", meta do
    assert meta[:from_setup] == :hello
  end

  teardown meta do
    assert meta[:from_setup] == :hello
    :ok
  end
end

元数据用于需要手动地将状态传递个测试的时候。

1.2.4 异步

最后,``也运行测例并行运行。你只需要把:async选项的值设为`true`:

use ExUnit.Case, async: true

这将会把这个测试同其他同样是异步的测试,并行运行。其他的测试仍将以顺序的方式运行。

2 干吧

ExUnit仍然是一个为完工的项目。我们鼓励你访问我们的issue tracker,提交你希望在ExUnit中看到的新特性,