mirror of
https://github.com/rust-lang/cargo.git
synced 2025-10-01 11:30:39 +00:00
64 lines
3.1 KiB
Plaintext
64 lines
3.1 KiB
Plaintext
Execute all unit and integration tests and build examples of a local package
|
|
|
|
Usage: cargo[EXE] test [OPTIONS] [TESTNAME] [-- [ARGS]...]
|
|
|
|
Arguments:
|
|
[TESTNAME] If specified, only run tests containing this string in their names
|
|
[ARGS]... Arguments for the test binary
|
|
|
|
Options:
|
|
--doc Test only this library's documentation
|
|
--no-run Compile, but don't run tests
|
|
--no-fail-fast Run all tests regardless of failure
|
|
--ignore-rust-version Ignore `rust-version` specification in packages
|
|
--future-incompat-report Outputs a future incompatibility report at the end of the build
|
|
--message-format <FMT> Error format
|
|
-q, --quiet Display one character per test instead of one line
|
|
-v, --verbose... Use verbose output (-vv very verbose/build.rs output)
|
|
--color <WHEN> Coloring: auto, always, never
|
|
--config <KEY=VALUE> Override a configuration value
|
|
-Z <FLAG> Unstable (nightly-only) flags to Cargo, see 'cargo -Z help' for
|
|
details
|
|
-h, --help Print help
|
|
|
|
Package Selection:
|
|
-p, --package [<SPEC>] Package to run tests for
|
|
--workspace Test all packages in the workspace
|
|
--exclude <SPEC> Exclude packages from the test
|
|
--all Alias for --workspace (deprecated)
|
|
|
|
Target Selection:
|
|
--lib Test only this package's library
|
|
--bins Test all binaries
|
|
--bin [<NAME>] Test only the specified binary
|
|
--examples Test all examples
|
|
--example [<NAME>] Test only the specified example
|
|
--tests Test all test targets
|
|
--test [<NAME>] Test only the specified test target
|
|
--benches Test all bench targets
|
|
--bench [<NAME>] Test only the specified bench target
|
|
--all-targets Test all targets (does not include doctests)
|
|
|
|
Feature Selection:
|
|
-F, --features <FEATURES> Space or comma separated list of features to activate
|
|
--all-features Activate all available features
|
|
--no-default-features Do not activate the `default` feature
|
|
|
|
Compilation Options:
|
|
-j, --jobs <N> Number of parallel jobs, defaults to # of CPUs.
|
|
-r, --release Build artifacts in release mode, with optimizations
|
|
--profile <PROFILE-NAME> Build artifacts with the specified profile
|
|
--target [<TRIPLE>] Build for the target triple
|
|
--target-dir <DIRECTORY> Directory for all generated artifacts
|
|
--unit-graph Output build graph in JSON (unstable)
|
|
--timings[=<FMTS>] Timing output formats (unstable) (comma separated): html, json
|
|
|
|
Manifest Options:
|
|
--manifest-path <PATH> Path to Cargo.toml
|
|
--frozen Require Cargo.lock and cache are up to date
|
|
--locked Require Cargo.lock is up to date
|
|
--offline Run without accessing the network
|
|
|
|
Run `cargo help test` for more detailed information.
|
|
Run `cargo test -- --help` for test binary options.
|