@ -2,37 +2,33 @@
> [ch11-02-running-tests.md ](https://github.com/rust-lang/book/blob/master/second-edition/src/ch11-02-running-tests.md )
> [ch11-02-running-tests.md ](https://github.com/rust-lang/book/blob/master/second-edition/src/ch11-02-running-tests.md )
> < br >
> < br >
> commit 55b294f20fc846a13a9be623bf322d8b364cee77
> commit db08b34db5f1c78b4866b391c802344ec94ecc38
就像`cargo run`会编译代码并运行生成的二进制文件，`cargo test`在测试模式下编译代码并运行生成的测试二进制文件。这里有一些选项可以用来改变`cargo test`的默认行为。例如，`cargo test`生成的二进制文件的默认行为是并行的运行所有测试，并捕获测试运行过程中产生的输出避免他们被显示出来使得阅读测试结果相关的内容变得更容易。可以指定命令行参数来改变这些默认行为。
就像 `cargo run` 会编译代码并运行生成的二进制文件一样 ， 在测试模式下编译代码并运行生成的测试二进制文件。这里有一些选项可以用来改变 `cargo test` 的默认行为。例如，`cargo test` 生成的二进制文件的默认行为是并行的运行所有测试，并捕获测试运行过程中产生的输出避免他们被显示出来， 你 可以指定命令行参数来改变这些默认行为。
这些选项的一部分可以传递给 `cargo test` ，而另一些则需要传递给生成的测试二进制文件。为了分隔两种类型的参数，首先列出传递给 `cargo test` 的参数，接着是分隔符 `--` ，再之后是传递给测试二进制文件的参数。运行 `cargo test --help` 会告诉你 `cargo test` 的相关参数，而运行 `cargo test -- --help` 则会告诉你位于分隔符 `--` 之后的相关参数。
这些选项的一部分可以传递给 `cargo test` ，而另一些则需要传递给生成的测试二进制文件。为了分隔两种类型的参数，首先列出传递给 `cargo test` 的参数，接着是分隔符 `--` ，再之后是传递给测试二进制文件的参数。运行 `cargo test --help` 会告诉你 `cargo test` 的相关参数，而运行 `cargo test -- --help` 则会告诉你位于分隔符 `--` 之后的相关参数。
### 并行或连续的运行测试
### 并行或连续的运行测试
<!-- Are we safe assuming the reader will know enough about threads in this 当运行多个测试时，他们默认使用线程来并行的运行。这意味着测试会更快的运行完毕，所以可以更快的得到代码能否工作的反馈。因为测试是在同时运行的，你应该小心测试不能相互依赖或依赖任何共享状态，包括类似于当前工作目录或者环境变量这样的共享环境。
context? -->
<!-- Yes /Carol -->
当运行多个测试时，他们默认使用线程来并行的运行。这意味着测试会更快的运行完毕，所以可以更快的得到代码能否工作的反馈。因为测试是在同时运行的，你应该小心测试不能相互依赖或任何共享状态，包括类似于当前工作目录或者环境变量这样的共享环境。
例如，每一个测试都运行一些代码在硬盘上创建一个 `test-output.txt` 文件并写入一些数据。接着每一个测试都读取文件中的数据并断言这个文件包含特定的值，而这个值在每个测试中都是不同的。因为所有测试都是同时运行的，一个测试可能会在另一个测试读写文件过程中覆盖了文件。那么第二个测试就会失败，并不是因为代码不正确，而是因为测试并行运行时相互干涉。一个解决方案是使每一个测试读写不同的文件；另一个是一次运行一个测试。
例如，每一个测试都运行一些代码在硬盘上创建一个 `test-output.txt` 文件并写入一些数据。接着每一个测试都读取文件中的数据并断言这个文件包含特定的值，而这个值在每个测试中都是不同的。因为所有测试都是同时运行的，一个测试可能会在另一个测试读写文件过程中覆盖了文件。那么第二个测试就会失败，并不是因为代码不正确，而是因为测试并行运行时相互干涉。一个解决方案是使每一个测试读写不同的文件；另一个是一次运行一个测试。
如果你不希望测试并行运行，或者想要更加精确的控制使用线程的数量，可以传递 `--test-threads` 参数和希望使用线程的数量给测试二进制文件。例如：
如果你不希望测试并行运行，或者想要更加精确的控制使用线程的数量，可以传递 `--test-threads` 参数和希望使用线程的数量给测试二进制文件。例如：
```
```text
$ cargo test -- --test-threads=1
$ cargo test -- --test-threads=1
```
```
这里将测试线程设置为 1， ，
这里将测试线程设置为 1， ，
### 显示测试 输出
### 显示函数 输出
如果测试通过了， 任何 标准输出和其他错误信息。
如果测试通过了， `println!` 而测试通过了，我们将不会在终端看到 `println!` 的输出：只会看到说明测试通过的行。如果测试失败了，就会看到所有 标准输出和其他错误信息。
例如，列表 11-20 有一个无意义的函数它打印出其参数的值并接着返回 10。接着还有一个会通过的测试和一个会失败的测试：
例如，列表 11-20 有一个无意义的函数它打印出其参数的值并接着返回 10。接着还有一个会通过的测试和一个会失败的测试：
< span class = "filename" > Filename : src/lib.rs< / span > < span class = "filename" > 文件名 : src/lib.rs< / span >
```rust
```rust
fn prints_and_returns_10(a: i32) -> i32 {
fn prints_and_returns_10(a: i32) -> i32 {
@ -58,12 +54,11 @@ mod tests {
}
}
```
```
< span class = "caption" > Listing 11-10: Tests for a function that calls `println!` < span class = "caption" > 列表 11-10： `println!` 的函数的测试</ span >
< / span >
运行 `cargo test` 将会看到这些测试的输出：
运行 `cargo test` 将会看到这些测试的输出：
```
```text
running 2 tests
running 2 tests
test tests::this_test_will_pass ... ok
test tests::this_test_will_pass ... ok
test tests::this_test_will_fail ... FAILED
test tests::this_test_will_fail ... FAILED
@ -82,17 +77,17 @@ failures:
test result: FAILED. 1 passed; 1 failed; 0 ignored; 0 measured
test result: FAILED. 1 passed; 1 failed; 0 ignored; 0 measured
```
```
注意输出中哪里也不会出现`I got the value 4`，这是当测试通过时打印的内容。这些输出被捕获。失败测试的输出，`I got the value 8`，则出现在输出的测试总结部分，它 也显示了测试失败的原因。
注意输出中哪里也不会出现 `I got the value 4`同时 也显示了测试失败的原因。
如果你希望也能看到通过的测试中打印的值，捕获输出的行为可以通过 `--nocapture` 参数来禁用：
如果你希望也能看到通过的测试中打印的值，捕获输出的行为可以通过 `--nocapture` 参数来禁用：
```
```text
$ cargo test -- --nocapture
$ cargo test -- --nocapture
```
```
使用 `--nocapture` 参数再次运行列表 11-10 中的测试会显示：
使用 `--nocapture` 参数再次运行列表 11-10 中的测试会显示：
```
```text
running 2 tests
running 2 tests
I got the value 4
I got the value 4
I got the value 8
I got the value 8
@ -114,11 +109,11 @@ test result: FAILED. 1 passed; 1 failed; 0 ignored; 0 measured
### 通过名称来运行测试的子集
### 通过名称来运行测试的子集
有时运行整个测试集会耗费很多时间。如果你负责特定位置的代码，你可能会希望只与这些代码相关的测试。可以向`cargo test` 传递希望运行的测试的（部分）名称作为参数来选择运行哪些测试。
有时运行整个测试集会耗费很长时间。如果你负责特定位置的代码，你可能会希望只运行这些代码相关的测试。可以向 `cargo test` 传递希望运行的测试的（部分）名称作为参数来选择运行哪些测试。
为了展示如何运行测试的子集，列表 11-11 使用 `add_two` 函数创建了三个测试来供我们选择运行哪一个：
为了展示如何运行测试的子集，列表 11-11 使用 `add_two` 函数创建了三个测试来供我们选择运行哪一个：
< span class = "filename" > Filename : src/lib.rs< / span > < span class = "filename" > 文件名 : src/lib.rs< / span >
```rust
```rust
pub fn add_two(a: i32) -> i32 {
pub fn add_two(a: i32) -> i32 {
@ -146,11 +141,11 @@ mod tests {
}
}
```
```
< span class = "caption" > Listing 11-11: Three tests with a variety of names < / span > < span class = "caption" > 列表 11-11： < / span >
如果没有传递任何参数就运行测试，如你所见，所有测试都会并行运行：
如果没有传递任何参数就运行测试，如你所见，所有测试都会并行运行：
```
```text
running 3 tests
running 3 tests
test tests::add_two_and_two ... ok
test tests::add_two_and_two ... ok
test tests::add_three_and_two ... ok
test tests::add_three_and_two ... ok
@ -163,9 +158,9 @@ test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured
可以向 `cargo test` 传递任意测试的名称来只运行这个测试：
可以向 `cargo test` 传递任意测试的名称来只运行这个测试：
```
```text
$ cargo test one_hundred
$ cargo test one_hundred
Finished debug [unoptimized + debuginfo] target(s) in 0.0 secs
Finished dev [unoptimized + debuginfo] target(s) in 0.0 secs
Running target/debug/deps/adder-06a75b4a1f2515e9
Running target/debug/deps/adder-06a75b4a1f2515e9
running 1 test
running 1 test
@ -180,9 +175,9 @@ test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured
然而，可以指定测试的部分名称，这样任何名称匹配这个值的测试会被运行。例如，因为头两个测试的名称包含 `add` ，可以通过 `cargo test add` 来运行这两个测试：
然而，可以指定测试的部分名称，这样任何名称匹配这个值的测试会被运行。例如，因为头两个测试的名称包含 `add` ，可以通过 `cargo test add` 来运行这两个测试：
```
```text
$ cargo test add
$ cargo test add
Finished debug [unoptimized + debuginfo] target(s) in 0.0 secs
Finished dev [unoptimized + debuginfo] target(s) in 0.0 secs
Running target/debug/deps/adder-06a75b4a1f2515e9
Running target/debug/deps/adder-06a75b4a1f2515e9
running 2 tests
running 2 tests
@ -194,19 +189,11 @@ test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured
这运行了所有名字中带有 `add` 的测试。同时注意测试所在的模块作为测试名称的一部分，所以可以通过模块名来过滤运行一个模块中的所有测试。
这运行了所有名字中带有 `add` 的测试。同时注意测试所在的模块作为测试名称的一部分，所以可以通过模块名来过滤运行一个模块中的所有测试。
<!-- in what kind of situation might you need to run only some tests, when you
have lots and lots in a program? -->
<!-- We covered this in the first paragraph of the "Running a Subset of Tests
by Name" section, do you think it should be repeated so soon? Most people who
use tests have sufficient motivation for wanting to run a subset of the tests,
they just need to know how to do it with Rust, so we don't think this is a
point that needs to be emphasized multiple times. /Carol -->
### 除非指定否则忽略某些测试
### 除非指定否则忽略某些测试
有时一些特定的测试执行起来是非常耗费时间的，所以在运行 大多数`cargo test`的时候希望能排除他们。与其通过参数列举出所有希望运行的测试，也可以使用`ignore`属性来标记耗时的测试来排除他们：
有时一些特定的测试执行起来是非常耗费时间的，所以在大多数运行 `cargo test` 的时候希望能排除他们。与其通过参数列举出所有希望运行的测试，也可以使用 `ignore` 属性来标记耗时的测试来排除他们：
< span class = "filename" > Filename : src/lib.rs< / span > < span class = "filename" > 文件名: src/lib.rs< / span >
```rust
```rust
#[test]
#[test]
@ -221,12 +208,12 @@ fn expensive_test() {
}
}
```
```
我们 对想要排除的测试的`#[test]`之后增加了`#[ignore]`行。现在如果运行测试，就会发现`it_works`运行了，而`expensive_test`没有运行：对想要排除的测试的 `#[test]` 之后增加了 `#[ignore]` 行。现在如果运行测试，就会发现 `it_works` 运行了，而 `expensive_test` 没有运行：
```
```text
$ cargo test
$ cargo test
Compiling adder v0.1.0 (file:///projects/adder)
Compiling adder v0.1.0 (file:///projects/adder)
Finished debug [unoptimized + debuginfo] target(s) in 0.24 secs
Finished dev [unoptimized + debuginfo] target(s) in 0.24 secs
Running target/debug/deps/adder-ce99bcc2479f4607
Running target/debug/deps/adder-ce99bcc2479f4607
running 2 tests
running 2 tests
@ -244,20 +231,9 @@ test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured
`expensive_test` 被列为 `ignored` ，如果只希望运行被忽略的测试，可以使用 `cargo test -- --ignored` 来请求运行他们：`expensive_test` 被列为 `ignored` ，如果只希望运行被忽略的测试，可以使用 `cargo test -- --ignored` 来请求运行他们：
<!-- what does the double `-- --` mean? That seems interesting -->
<!-- We covered that in the second paragraph after the "Controlling How Tests
are Run" heading, and this section is beneath that heading, so I don't think a
back reference is needed /Carol -->
<!-- is that right, this way the program knows to run only the test with
`ignore` if we add this, or it knows to run all tests? -->
<!-- Is this unclear from the output that shows `expensive_test` was run and
the `it_works` test does not appear? I'm not sure how to make this clearer.
/Carol -->
```text
```text
$ cargo test -- --ignored
$ cargo test -- --ignored
Finished debug [unoptimized + debuginfo] target(s) in 0.0 secs
Finished dev [unoptimized + debuginfo] target(s) in 0.0 secs
Running target/debug/deps/adder-ce99bcc2479f4607
Running target/debug/deps/adder-ce99bcc2479f4607
running 1 test
running 1 test
@ -266,5 +242,4 @@ test expensive_test ... ok
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured
```
```
通过控制运行哪些测试，可以确保运行 `cargo test` 的结果是快速的。当某个时刻需要检查 `ignored` 测试的结果而且你也有时间等待这个结果的话，可以选择执行 `cargo test -- --ignored` 。
通过控制运行哪些测试，可以确保运行 `cargo test` 的结果是快速的。当某个时刻需要检查 `ignored` 测试的结果而且你也有时间等待这个结果的话，可以选择执行 `cargo test -- --ignored` 。
KaiserY
7 years ago