elixir官方教程Mix与OTP(一) Mix入门

#Mix入门

1. 咱们的第一个项目
2. 编辑项目
3. 执行测试
4. 环境
5. 探索

在本教程中,咱们将学习如何构建一个完整的Elixir应用,包括监督树,配置,测试等等.

这个应用的功能是分布式键值仓库.咱们将把键值对安排到桶中,并将桶分布到多个节点.咱们也会构建一个简单的客户端,让咱们可以与其中任何一个节点链接并发送以下请求:

CREATE shopping
OK

PUT shopping milk 1
OK

PUT shopping eggs 3
OK

GET shopping milk
1
OK

DELETE shopping eggs
OK

为了构建咱们的键值应用,咱们会用到三个主要工具:

• OTP(开放通讯平台)是Erlang装载的一系列库.Erlang开发者使用OTP来构建健壮的,容错的应用.本章咱们将探索Elixir融合了多少来自OTP的内容,包括监督树,事件管理等等;

• Mix 是Elixir装载的一个构建工具,提供了建立,编译,测试应用,管理依赖等等;

• ExUnit 是Elixir装载的一个基本单元测试框架;

本章,咱们将使用Mix建立第一个项目,并探索OTP,Mix和ExUnit的不一样特性.

注意:本教程要求Elixir版本v1.2.0或以上.你能够用elixir -v来检查版本,若有须要可按入门教程的第一章中的步骤安装最新的版本.

如对本教程有任何疑问或改进意见,请经过咱们的邮件列表或问题跟踪来告诉咱们.你的意见对于帮助咱们确保这份教程可用且最新十分重要!

#咱们的第一个项目

当你安装Elixir时,除了获得了elixir,elixirc和iex这些可执行文件外,还获得了一个可执行的Elixir脚本mix.

让咱们经过从命令行中调用mix new来建立咱们的第一个项目.咱们会将项目名当作参数传递(本例中是kv),并告诉Mix咱们的主模块是全大写的KV,而不是默认的Kv:

$ mix new kv --module KV

Mix会建立一个叫kv的目录,其中有以下文件:

* creating README.md
* creating .gitignore
* creating mix.exs
* creating config
* creating config/config.exs
* creating lib
* creating lib/kv.ex
* creating test
* creating test/test_helper.exs
* creating test/kv_test.exs

让咱们简单查看一下这些文件.

注意: Mix是一个Elixir可执行文件.这意味着想要运行mix,你的PATH中须要有Elixir的可执行文件.若是没有,你能够将脚本看成参数传递给elixir来运行它:

$ bin/elixir bin/mix new kv --module KV

注意你也能够在PATH中用Elixir加上-S选项来执行任何脚本:

$ bin/elixir -S mix new kv --module KV

当使用-S时,elixir会找到脚本并执行它,不管是否存在与你的PATH中.

#编辑项目

在咱们的新项目目录(kv)中生成了一个叫mix.exs的文件,它的主要做用是配置咱们的项目.让咱们来看看(注释已删除):

defmodule KV.Mixfile do
  use Mix.Project

  def project do
    [app: :kv,
     version: "0.1.0",
     elixir: "~> 1.3",
     build_embedded: Mix.env == :prod,
     start_permanent: Mix.env == :prod,
     deps: deps()]
  end

  def application do
    [applications: [:logger]]
  end

  defp deps do
    []
  end
end

咱们的mix.exs定义了两个公共函数:project,它会返回诸如项目名称和版本等项目配置,以及application,它用于生成应用文件.

这里还有一个叫作deps的私有函数,它被project函数调用,定义了咱们的项目的依赖.将deps做为一个独立的函数不是必需的,但这样作能够有助于保持项目配置的整洁.

Mix也生成了一个文件lib/kv.ex,其中有一个简单的模块定义:

defmodule KV do
end

这个结构体足够编译咱们的项目:

$ cd kv
$ mix compile

将输出:Compiling 1 file (.ex) Generated kv app

lib/kv.ex已被编译,生成了一个名为kv.app的应用,而且全部的协议都如入门教程中描述的那样被巩固了.全部的编译成品都如mix.exs中定义的那样被存放在了_build目录中.

编译完成后,你就能够在项目内开启一个iex会话,经过运行:

$ iex -S mix

#运行测试

Mix也为运行咱们的项目测试而生成了合适的结构.一般,Mix项目以方便起见会在lib目录中的test目录下为每一个文件生成一个<filename>_test.exs文件.因此,咱们可以找到一个test/kv_test.exs文件对应着咱们的lib/kv.ex文件.这一点上作的很少:

defmodule KVTest do
  use ExUnit.Case
  doctest KV

  test "the truth" do
    assert 1 + 1 == 2
  end
end

这有几件事要特别注意的:

1. 测试文件是一个Elixir脚本文件(.exs).便捷之处在于咱们不须要在运行测试以前编译它们;

2. 咱们定义了一个名为KVTest的模块,使用ExUnit.Case来注入测试API,并使用test/2宏定义了一个简单的测试;

Mix也生成了一个叫test/test_helper.exs的文件,它的做用是启动测试框架:

ExUnit.start()

这个文件会在每次咱们运行测试以前被Mix自动调用.咱们可使用mix test运行测试:

Compiled lib/kv.ex
Generated kv app
[...]
.

Finished in 0.04 seconds (0.04s on load, 0.00s on tests)
1 test, 0 failures

Randomized with seed 540224

注意,经过运行mix test,Mix再一次编译了源文件并生成应用.这是因为Mix支持多重环境,咱们将在下一部分探索它.

并且,你能够看到ExUnit为每一个成功的测试打印了一个点,而且自动进行了乱序测试.试试让测试失败会发生什么.

将test/kv_test.exs中的断言改为:

assert 1 + 1 == 3

再次运行mix test(注意此次没有进行编译):

1) test the truth (KVTest)
   test/kv_test.exs:5
   Assertion with == failed
   code: 1 + 1 == 3
   lhs:  2
   rhs:  3
   stacktrace:
     test/kv_test.exs:6

Finished in 0.05 seconds (0.05s on load, 0.00s on tests)
1 test, 1 failure

对于每一个失败,ExUnit都打印了一个详细的报告,包括测试名称与测试案例,失败的代码和==符号左手边(lhs)与右手边(rhs)的值.

在失败的第二行,测试名以后,是测试定义的位置.若是你复制了第二行(包括文件名与行号)并将其添加到mix test以后,Mix将会只载入和运行这一测试:

$ mix test test/kv_test.exs:5

这个短语在咱们构建项目时很是有用,它让咱们可以快速地重复某一特定测试.

最后,堆栈跟踪指向了失败自己,提供了与测试相关的信息,以及源文件中失败生成的位置.

#环境

Mix支持"环境"的概念.它们容许开发者为特定的情景自定义编译和其它选项.Mix默认接受三种环境:

• :dev--Mix任务(例如compile)按默认设置运行
• :test--由mix test使用
• :prod--在项目产品运行时用到的

环境设置只对当前项目生效.正如咱们将要看到的,任何你添加到项目中的依赖会默认运行在:prod环境.

你能够经过访问mix.exs文件中的Mix.env函数来自定义环境,它会以原子形式返回当前环境.这就是咱们在:bulid_embedded和:start_permanent选项中所使用的:

def project do
  [...,
   build_embedded: Mix.env == :prod,
   start_permanent: Mix.env == :prod,
   ...]
end

当你编译源代码时,Elixir将编译成果放到额_build目录中.然而,为了不没必要要的复制,Elixir会建立一个从_build到实际源代码文件的文件系统连接.当:build_embedded为真时,会中止这个行为,意在使全部运行应用所需的东西都放在_build中.

类似地,当:start_permanent选项为真时,你的应用将运行在永久模式,这意味着若是应用的监督树关闭了,Erlang虚拟机就会崩溃.注意咱们不但愿这个行为出如今dev和test环境中,由于保持Erlang虚拟机运行对于解决问题十分有用.

Mix默认处于:dev环境,只有test任务会默认在:test环境.能够经过MIX_ENV环境变量来修改环境:

$ MIX_ENV=prod mix compile

在Windows中:

> set "MIX_ENV=prod" && mix compile

#探索

Mix还有不少内容,咱们将在构建项目的过程当中继续探索它.在Mix文档中你能获得一个概述.

记住你总能经过调用帮助任务来列出全部可用任务:

$ mix help

你能够经过调用mix help TASK来得到有关特定任务的信息.

让咱们开始写代码吧!