Merge pull request #36 from AmaiKinono/add/chapter12

翻译了第十二章

Author: aaranxu

src/SUMMARY.md

@@ -83,6 +83,11 @@
     - [库](crates/lib.md)
     - [`extern crate`](crates/link.md)
 
+- [cargo](cargo.md)
+    - [依赖](cargo/deps.md)
+    - [惯例](cargo/conventions.md)
+    - [测试](cargo/test.md)
+
 - [属性](attribute.md)
     - [死代码 `dead_code`](attribute/unused.md)
     - [`crate`](attribute/crate.md)

src/cargo.md

@@ -0,0 +1,11 @@
+# Cargo
+
+`cargo` 是官方的 Rust 包管理工具，它包含大量有用的特性，能够帮助你提高代码质量
+与生产力！包括：
+
+- 依赖管理，以及和 [crates.io](https://crates.io) (Rust 包的官方登记处）的集成
+- 可检测到单元测试
+- 可检测到性能测试
+
+本章将会快速地讲一些基础内容，你可以在[这里](http://doc.crates.io/index.html)找到
+完整文档。

src/cargo/conventions.md

@@ -0,0 +1,33 @@
+# 惯例
+
+在上一节中，我们看到过这样的目录树：
+
+```txt
+foo
+├── Cargo.toml
+└── src
+    └── main.rs
+```
+
+假设咱们想让一个工程生成两个可执行文件，怎么办呢？
+
+`cargo` 是支持这样做的。默认的可执行文件是从 `main.rs` 生成的，不过你可以在
+ `bin/` 目录下添加其他的可执行文件来源：
+
+```txt
+foo
+├── Cargo.toml
+└── src
+    ├── main.rs
+    └── bin
+        └── my_other_bin.rs
+```
+
+为了让 `cargo` 编译和运行 `my_other_bin.rs`，我们需要使用 `cargo` 的
+ `--bin my_other_bin` 选项，其中 `my_other_bin` 是要处理的可执行文件名。
+
+除去额外的可执行文件，`cargo` 还支持性能评估（benchmark）、测试（test）和
+示例程序（example）。完整的功能介绍
+请看[这里](http://doc.crates.io/book/guide/project-layout.html)。
+
+在下一节，咱们会详细了解测试。

src/cargo/deps.md

@@ -0,0 +1,79 @@
+# 依赖
+
+大多数程序都要依赖一些库。如果你手工管理过依赖，你一定知道那是一件多么痛苦的
+事情。幸运的是，`cargo` 是 Rust 生态系统的标配！`cargo` 能够管理一个工程的依赖。
+
+使用以下命令可以新建工程：
+
+```sh
+# 目标是二进制文件
+cargo new --bin foo
+
+# 或者是库
+cargo new foo
+```
+
+在本章接下来的部分，我会假设我们在编写可执行的应用，而不是库，不过它们所有的概念
+都是相同的。
+
+在执行上述命令后，你应该会看到：
+
+```txt
+foo
+├── Cargo.toml
+└── src
+    └── main.rs
+```
+
+`main.rs` 是你的新工程的根源文件（root source file），这里没什么新奇的。`Cargo.toml`
+ 是该工程（`foo`）的 `cargo` 配置文件。如果你打开看看，会看到类似这样的内容：
+
+```toml
+[package]
+name = "foo"
+version = "0.1.0"
+authors = ["mark"]
+
+[dependencies]
+```
+
+你可以在[这里](http://doc.crates.io/manifest.html)找到所有可用的配置选项。
+
+`package` 下面的 `name` 字段决定了工程的名字。如果你在 `crates.io` 上发布
+ `crate`（详见后文），就会使用这个名字。这也是编译产生的二进制文件的名字。
+
+`version` 字段是 crate 的版本号，遵循 [Semantic Versioning](http://semver.org/).
+
+`authors` 字段是发布 crate 时所用的作者列表。
+
+`dependencies` 部分用来添加工程的依赖。
+
+比如说，我想让我的程序拥有一个好看的字符界面（CLI），那我可以在
+ [crates.io](https://crates.io) 上找到不少这种库。[clap](https://crates.io/crates/clap)
+ 是比较流行的一个。在本书写作时，`clap` 最近的版本是 `2.27.1`。要给工程加上这个
+依赖，只需在 `Cargo.toml` 的 `dependencies` 下面加上 `clap = "2.27.1"`。当然，还
+需要在 `main.rs` 中写上 `extern crate clap`，这和以前一样。这样就完成了！接下来
+你可以在程序中使用 `clap` 了。
+
+`cargo` 也支持其他的依赖来源。下面是一些例子，你可以
+在[这里](http://doc.crates.io/specifying-dependencies.html)找到更多。
+
+
+```toml
+[package]
+name = "foo"
+version = "0.1.0"
+authors = ["mark"]
+
+[dependencies]
+clap = "2.27.1" # 来自 crates.io
+rand = { git = "https://github.com/rust-lang-nursery/rand" } # 来自在线仓库
+bar = { path = "../bar" } # 来自本地文件系统的一个路径
+```
+
+要构建工程，可以在工程的任何路径（包括子路径！）运行 `cargo build`。也可以运行
+ `cargo run` 来构建 + 运行。注意这些命令会解决所有依赖问题，下载 crate（如果
+需要的话），然后构建它们和你的 `crate`（注意它只会构建那些还没有构建的东西，和
+ `make` 一样）。
+ 
+好了，这节就学到这里！

src/cargo/test.md

@@ -0,0 +1,64 @@
+# 测试
+
+众所周知，任何软件都需要测试！Rust 对单元测试和集成测试提供了完整的支持（请看 TRPL
+ 中的[这一章](https://doc.rust-lang.org/book/second-edition/ch11-00-testing.html)）。
+
+从上面链接的章节中，我们看到了如何编写单元测试和继承测试。我们可以很条理地把单元
+测试放到它们要测试的模块目录，把集成测试放到单独的 `tests/` 文件夹。
+
+```txt
+foo
+├── Cargo.toml
+├── src
+│   └── main.rs
+└── tests
+    ├── my_test.rs
+    └── my_other_test.rs
+```
+
+这里 `tests` 文件夹中的每个文件都是独立的集成测试。
+
+`cargo` 提供了一种运行所有测试的简单方式！
+
+```sh
+cargo test
+```
+
+你会看到类似这样的输出：
+
+```txt
+$ cargo test
+   Compiling blah v0.1.0 (file:///nobackup/blah)
+    Finished dev [unoptimized + debuginfo] target(s) in 0.89 secs
+     Running target/debug/deps/blah-d3b32b97275ec472
+
+running 3 tests
+test test_bar ... ok
+test test_baz ... ok
+test test_foo_bar ... ok
+test test_foo ... ok
+
+test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
+```
+
+你也可以运行那些名字匹配某一模式的测试：
+
+```sh
+cargo test test_foo
+```
+
+```txt
+$ cargo test test_foo
+   Compiling blah v0.1.0 (file:///nobackup/blah)
+    Finished dev [unoptimized + debuginfo] target(s) in 0.35 secs
+     Running target/debug/deps/blah-d3b32b97275ec472
+
+running 2 tests
+test test_foo ... ok
+test test_foo_bar ... ok
+
+test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured; 2 filtered out
+```
+
+注意一点：cargo 可能会并行地运行多个测试，所以确保它们不会彼此竞争。比如，它们
+都往同一个文件里输出内容，那么你应该修改它们，让结果写到不同的文件中。