Google Git
Sign in
fuchsia / fuchsia / 6697568849879512cc8452e84c2db4c0da200466 / . / src / sys / test_runners / gtest
tree: 40fa1e69d90a17bba494f6121cdb075155408851 [path history] [tgz]
  1. meta/
  2. src/
  3. test_data/
  4. tests/
  5. BUILD.gn
  6. default.shard.cml
  7. README.md
src/sys/test_runners/gtest/README.md

GTest Runner

Reviewed on: 2020-04-20

GTest Runner is a test runner that launches a gtest binary as a component, parses its output, and translates it to fuchsia.test.Suite protocol on behalf of the test.

Building

fx set core.x64 --with //src/sys/test_runners/gtest
fx build

Examples

Examples to demonstrate how to write v2 test

To run this example:

fx run-test gtest-runner-example-tests

Concurrency

Test cases are executed sequentially by default. Instruction to override.

Arguments

See passsing-arguments to learn more.

Limitations

  • If a test calls GTEST_SKIP(), it will be recorded as Passed rather than as Skipped. This is due to a bug in gtest itself.

Partial Support

  • gtest runner supports printing stdout from the test but if a newline is not added at the end of every printf message, the developer will see some extra prints from gtest framework. This limitation will be solved with fxbug.dev/53955.

Testing

Run:

fx run-test gtest_runner_tests

Source layout

The entrypoint is located in src/main.rs, the FIDL service implementation and all the test logic exists in src/test_server.rs. Unit tests are co-located with the implementation.