1
1
CARGO-BENCH(1)
2
2
3
3
NAME
4
- cargo-bench - Execute benchmarks of a package
4
+ cargo-bench — Execute benchmarks of a package
5
5
6
6
SYNOPSIS
7
7
cargo bench [options] [benchname] [-- bench-options]
@@ -11,11 +11,11 @@ DESCRIPTION
11
11
12
12
The benchmark filtering argument benchname and all the arguments
13
13
following the two dashes (--) are passed to the benchmark binaries and
14
- thus to libtest (rustc' s built in unit-test and micro-benchmarking
14
+ thus to libtest (rustc’ s built in unit-test and micro-benchmarking
15
15
framework). If you are passing arguments to both Cargo and the binary,
16
16
the ones after -- go to the binary, the ones before go to Cargo. For
17
- details about libtest' s arguments see the output of cargo bench --
18
- --help and check out the rustc book' s chapter on how tests work at
17
+ details about libtest’ s arguments see the output of cargo bench --
18
+ --help and check out the rustc book’ s chapter on how tests work at
19
19
<https://doc.rust-lang.org/rustc/tests/index.html>.
20
20
21
21
As an example, this will run only the benchmark named foo (and skip
@@ -52,7 +52,7 @@ DESCRIPTION
52
52
OPTIONS
53
53
Benchmark Options
54
54
--no-run
55
- Compile, but don' t run benchmarks.
55
+ Compile, but don’ t run benchmarks.
56
56
57
57
--no-fail-fast
58
58
Run all benchmarks regardless of failure. Without this flag, Cargo
@@ -74,7 +74,7 @@ OPTIONS
74
74
passing --workspace), and a non-virtual workspace will include only the
75
75
root crate itself.
76
76
77
- -p spec... , --package spec...
77
+ -p spec… , --package spec…
78
78
Benchmark only the specified packages. See cargo-pkgid(1) for the
79
79
SPEC format. This flag may be specified multiple times and supports
80
80
common Unix glob patterns like *, ? and []. However, to avoid your
@@ -88,7 +88,7 @@ OPTIONS
88
88
--all
89
89
Deprecated alias for --workspace.
90
90
91
- --exclude SPEC...
91
+ --exclude SPEC…
92
92
Exclude the specified packages. Must be used in conjunction with the
93
93
--workspace flag. This flag may be specified multiple times and
94
94
supports common Unix glob patterns like *, ? and []. However, to
@@ -136,23 +136,23 @@ OPTIONS
136
136
use single quotes or double quotes around each glob pattern.
137
137
138
138
--lib
139
- Benchmark the package' s library.
139
+ Benchmark the package’ s library.
140
140
141
- --bin name...
141
+ --bin name…
142
142
Benchmark the specified binary. This flag may be specified multiple
143
143
times and supports common Unix glob patterns.
144
144
145
145
--bins
146
146
Benchmark all binary targets.
147
147
148
- --example name...
148
+ --example name…
149
149
Benchmark the specified example. This flag may be specified multiple
150
150
times and supports common Unix glob patterns.
151
151
152
152
--examples
153
153
Benchmark all example targets.
154
154
155
- --test name...
155
+ --test name…
156
156
Benchmark the specified integration test. This flag may be specified
157
157
multiple times and supports common Unix glob patterns.
158
158
@@ -165,7 +165,7 @@ OPTIONS
165
165
integration tests, etc.). Targets may be enabled or disabled by
166
166
setting the test flag in the manifest settings for the target.
167
167
168
- --bench name...
168
+ --bench name…
169
169
Benchmark the specified benchmark. This flag may be specified
170
170
multiple times and supports common Unix glob patterns.
171
171
@@ -227,7 +227,7 @@ OPTIONS
227
227
228
228
--ignore-rust-version
229
229
Benchmark the target even if the selected Rust compiler is older
230
- than the required Rust version as configured in the project' s
230
+ than the required Rust version as configured in the project’ s
231
231
rust-version field.
232
232
233
233
--timings=fmts
@@ -265,10 +265,11 @@ OPTIONS
265
265
cargo bench -- --nocapture
266
266
267
267
-v, --verbose
268
- Use verbose output. May be specified twice for "very verbose" output
269
- which includes extra output such as dependency warnings and build
270
- script output. May also be specified with the term.verbose config
271
- value <https://doc.rust-lang.org/cargo/reference/config.html>.
268
+ Use verbose output. May be specified twice for “very verbose”
269
+ output which includes extra output such as dependency warnings and
270
+ build script output. May also be specified with the term.verbose
271
+ config value
272
+ <https://doc.rust-lang.org/cargo/reference/config.html>.
272
273
273
274
-q, --quiet
274
275
Do not print cargo log messages. May also be specified with the
@@ -303,18 +304,19 @@ OPTIONS
303
304
for more details. Conflicts with human and short.
304
305
305
306
o json-diagnostic-short: Ensure the rendered field of JSON messages
306
- contains the " short" rendering from rustc. Cannot be used with
307
- human or short.
307
+ contains the “ short” rendering from rustc. Cannot be used
308
+ with human or short.
308
309
309
310
o json-diagnostic-rendered-ansi: Ensure the rendered field of JSON
310
311
messages contains embedded ANSI color codes for respecting
311
- rustc's default color scheme. Cannot be used with human or short.
312
+ rustc’s default color scheme. Cannot be used with human or
313
+ short.
312
314
313
315
o json-render-diagnostics: Instruct Cargo to not include rustc
314
316
diagnostics in JSON messages printed, but instead Cargo itself
315
- should render the JSON diagnostics coming from rustc. Cargo's own
316
- JSON diagnostics and others coming from rustc are still emitted.
317
- Cannot be used with human or short.
317
+ should render the JSON diagnostics coming from rustc. Cargo’s
318
+ own JSON diagnostics and others coming from rustc are still
319
+ emitted. Cannot be used with human or short.
318
320
319
321
Manifest Options
320
322
--manifest-path path
0 commit comments