diff --git a/src/doc/man/cargo-test.adoc b/src/doc/man/cargo-test.adoc index 32aa5ff6688..ba338b12bfb 100644 --- a/src/doc/man/cargo-test.adoc +++ b/src/doc/man/cargo-test.adoc @@ -21,8 +21,10 @@ dashes (`--`) are passed to the test binaries and thus to _libtest_ (rustc's built in unit-test and micro-benchmarking framework). If you're passing arguments to both Cargo and the binary, the ones after `--` go to the binary, the ones before go to Cargo. For details about libtest's arguments see the -output of `cargo test \-- --help`. As an example, this will run all tests with -`foo` in their name on 3 threads in parallel: +output of `cargo test \-- --help`. + +As an example, this will filter for tests with `foo` in their name and run them +on 3 threads in parallel: cargo test foo -- --test-threads 3 @@ -152,6 +154,10 @@ include::section-exit-status.adoc[] cargo test +. Run only tests whose names match against a filter string: + + cargo test name_filter + . Run only a specific test within a specific integration test: cargo test --test int_test_name -- modname::test_name diff --git a/src/doc/man/generated/cargo-test.html b/src/doc/man/generated/cargo-test.html index aefe8d37ff0..ee87f3cba85 100644 --- a/src/doc/man/generated/cargo-test.html +++ b/src/doc/man/generated/cargo-test.html @@ -22,8 +22,11 @@

DESCRIPTION

built in unit-test and micro-benchmarking framework). If you’re passing arguments to both Cargo and the binary, the ones after -- go to the binary, the ones before go to Cargo. For details about libtest’s arguments see the -output of cargo test -- --help. As an example, this will run all tests with -foo in their name on 3 threads in parallel:

+output of cargo test -- --help.

+ +
+

As an example, this will filter for tests with foo in their name and run them +on 3 threads in parallel:

@@ -581,6 +584,14 @@

EXAMPLES

  • +

    Run only tests whose names match against a filter string:

    +
    +
    +
    cargo test name_filter
    +
    +
    +
  • +
  • Run only a specific test within a specific integration test:

    diff --git a/src/etc/man/cargo-test.1 b/src/etc/man/cargo-test.1 index 0f967958fc7..bbcc99186ca 100644 --- a/src/etc/man/cargo-test.1 +++ b/src/etc/man/cargo-test.1 @@ -2,12 +2,12 @@ .\" Title: cargo-test .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.10 -.\" Date: 2020-06-25 +.\" Date: 2020-07-28 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" -.TH "CARGO\-TEST" "1" "2020-06-25" "\ \&" "\ \&" +.TH "CARGO\-TEST" "1" "2020-07-28" "\ \&" "\ \&" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 @@ -41,8 +41,10 @@ dashes (\fB\-\-\fP) are passed to the test binaries and thus to \fIlibtest\fP (r built in unit\-test and micro\-benchmarking framework). If you\(cqre passing arguments to both Cargo and the binary, the ones after \fB\-\-\fP go to the binary, the ones before go to Cargo. For details about libtest\(cqs arguments see the -output of \fBcargo test \-\- \-\-help\fP. As an example, this will run all tests with -\fBfoo\fP in their name on 3 threads in parallel: +output of \fBcargo test \-\- \-\-help\fP. +.sp +As an example, this will filter for tests with \fBfoo\fP in their name and run them +on 3 threads in parallel: .sp .if n .RS 4 .nf @@ -678,6 +680,23 @@ cargo test . sp -1 . IP " 2." 4.2 .\} +Run only tests whose names match against a filter string: +.sp +.if n .RS 4 +.nf +cargo test name_filter +.fi +.if n .RE +.RE +.sp +.RS 4 +.ie n \{\ +\h'-04' 3.\h'+01'\c +.\} +.el \{\ +. sp -1 +. IP " 3." 4.2 +.\} Run only a specific test within a specific integration test: .sp .if n .RS 4