Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
CARGO-TEST(1)			 Cargo Manual			 CARGO-TEST(1)

       cargo-test - Execute unit and integration tests of a package

       cargo test [OPTIONS] [--] [<ARGS>...]

       Execute all unit	and integration	tests of a local package.

       All of the trailing arguments are passed	to the test binaries generated
       for filtering tests and generally  providing  options  configuring  how
       they  run.  For example,	this will run all tests	with the name 'foo' in
       their name:

	      cargo test foo

       If the --package	argument is given, then	'SPEC' is a package id	speci-
       fication	 which indicates which package should be tested.  If it	is not
       given, then the current package is tested.   For	 more  information  on
       'SPEC' and its format, see the "cargo help pkgid" command.

       The  --jobs  argument  affects  the building of the test	executable but
       does not	affect how many	jobs are used when running the tests.

       Compilation can be configured via the 'test' profile in the manifest.

       By default the rust test	harness	hides output from  test	 execution  to
       keep  results readable.	Test output can	be recovered (e.g.  for	debug-
       ging) by	passing	--nocapture to the test	binaries:

	      cargo test -- --nocapture

       -h, --help
	      Print this message.

       --lib  Test only	this package's library.

       --doc  Test only	this library's documentation

       --bin NAME
	      Test only	the specified binary.

       --example NAME
	      Test only	the specified example.

       --test NAME
	      Test only	the specified integration test target.

       --bench NAME
	      Test only	the specified benchmark	target.

	      Compile, but don't run tests.

       -p SPEC,	--package SPEC ...
	      Package to run tests for.

       -j IN, --jobs IN
	      Number of	parallel jobs, defaults	to # of	CPUs.

	      Build artifacts in release mode, with optimizations.

       --features FEATURES
	      Space-separated list of features to also build.

	      Build all	available features.

	      Do not build the default feature.

       --target	TRIPLE
	      Build for	the target triple.

       --manifest-path PATH
	      Path to the manifest to compile.

	      Run all tests regardless of failure.

       -v, --verbose
	      Use verbose output.

       -q, --quiet
	      No output	printed	to stdout.

       --color WHEN
	      Coloring:	auto, always, never.

       Execute all the unit and	integration tests of the current package

	      $	cargo test

       Execute the BENCH benchmark

	      $	cargo test --bench BENCH

       cargo(1), cargo-build(1)

       This work is dual-licensed under	Apache 2.0 and MIT terms.   See	 COPY-
       RIGHT file in the cargo source distribution.

The Rust package manager	   May 2016			 CARGO-TEST(1)


Want to link to this manual page? Use this URL:

home | help