使用模块注解作为方法属性

Question

所以这是一个有趣的问题，我查看了 elixir 中模块属性的文档，即底部的http://elixir-lang.org/getting-started/module-attributes.html，它提到它们可以用作 ExUnit 中的方法注释。

不幸的是，基本上没有关于如何实现这一点的信息，并且查看 ExUnit 代码让我迷失了方向。似乎我需要确定最接近该属性的方法才能说它们以某种方式关联（尽管可能是错误的）。

知道我可以去哪里了解这个吗？

Answer 1

它是这样工作的。看ExUnit.Case的源码。

首先，查看__using__ 宏，因为在测试用例中使用它时会首先调用它。特别注意here

    Enum.each [:ex_unit_tests, :tag, :describetag, :moduletag, :ex_unit_registered],
      &Module.register_attribute(__MODULE__, &1, accumulate: true)

这会注册@tag 和一堆更多的累积属性。阅读Module.register_attribute/3 的文档，您会发现这意味着无论何时调用属性，该值都会附加到先前属性的列表中。

然后注意test/3宏，特别是here

quote bind_quoted: [var: var, contents: contents, message: message] do
  name = ExUnit.Case.register_test(__ENV__, :test, message, [])
  def unquote(name)(unquote(var)), do: unquote(contents)
end

注意对ExUnit.Case.register_test/4 的调用。看了一下，特意here

tag = Module.delete_attribute(mod, :tag)

它获取到这里的标签，然后删除它们。通过拥有标签和测试名称，它会调用 (here)

test = %ExUnit.Test{name: name, case: mod, tags: tags}
Module.put_attribute(mod, :ex_unit_tests, test)

将测试与标签一起保存在另一个属性中。

最后，请注意这里

  @doc false
  defmacro __before_compile__(_) do
    quote do
      def __ex_unit__(:case) do
        %ExUnit.TestCase{name: __MODULE__, tests: @ex_unit_tests}
      end
    end
  end

在ExUnit.Runner.run_case/3中调用函数__ex_unit__/1来获取每个case里面的测试信息。

你明白了吗？使用累积属性，在宏内部调用一个函数，该函数始终获取属性的当前值并清除它，然后对该值做任何你想做的事情，因为你知道它总是在调用宏时。

我希望它足够清楚，如果您需要更多解释，请发表评论。

附言。我刚刚阅读了源代码以找出答案。很高兴知道它是如何工作的。