ffx_e2e_emu

A Rust library for end-to-end testing of ffx tool and plugin behavior. Starts an isolated emulator instance with the system image from the main build and allows issuing ffx & ssh commands to it.

Build setup

To avoid dependency cycles in the build graph you must place your tests outside of the usual chain of test groups that get depended upon by the system image assembly.

Add host test binaries that depend on the library to //src/developer/ffx:host_tests and add any Fuchsia package dependencies required by your test to //src/developer/ffx:package_deps_for_host_tests, usually by adding similarly-named groups to the build for your test and the BUILD.gn files in any parent directories. See existing users of this library for examples.

Isolated emulator tests are slow

You should be sparing in the number of tests you write using this library for 2 reasons:

1. spinning up a full Fuchsia instance for a test can take 20-30 seconds
2. only one ffx isolate can be in use at once, serializing test execution