Google Git
Sign in
fuchsia / fuchsia / refs/heads/releases/field-image-f6 / . / src / sys / test_runners / gtest
tree: 32a7273dcd7416f16b97bc49f691590959c44c73 [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 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 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.