nagai/fune

Chris H-C 6f5695446e Bug 1635255 - Build glean crate conditionally on Gecko symbols r=janerik

Introduces a gkrust Cargo feature `glean_with_gecko` and `with_gecko` on fog
and glean. This feature signifies the presence of gecko symbols in the build.

Use this feature to implement needs_ipc() which asks Gecko which process type
we're running as.

Differential Revision: https://phabricator.services.mozilla.com/D79744

2020-06-24 16:16:17 +00:00

2.1 KiB

Raw Blame History

Testing

Given the multiple API languages, processes, and dependencies, testing FOG is a matter of choosing the right tool for the situation.

Logging

An often-overlooked first line of testing is "what do the logs say?". To turn on logging for FOG, use any of the following:

Run Firefox with RUST_LOG="glean=info,fog=info,glean_core=info".
- On some platforms this will use terminal colours to indicate log level.
Run Firefox with MOZ_LOG="timestamp,glean::*:5,fog::*:5,glean_core::*:5".
Set the following prefs:
- logging.config.timestamp to true
- logging.fog::* to 5
- logging.glean::* to 5
- logging.glean_core::* to 5

For more information on logging in Firefox Desktop, see the Gecko Logging docs.

Rust

Not all of our Rust code can be tested in a single fashion, unfortunately.

Using `rusttests`

If the crate you're testing has no Gecko symbols you can write standard Rust tests.

This supports both unit tests (inline in the file under test) and integration tests (in the tests/ folder in the crate root).

To run FOG's rusttests suite use mach rusttests

If the crate uses only a few Gecko symbols, they may use the with_gecko feature to conditionally use them. This allows the crate to test its non-Gecko-adjacent code using Rust tests. (You will need to cover the Gecko-adjacent code via another means.)

Using `gtest`

Because Gecko symbols aren't built for the rusttests build, any test that is written for code that uses Gecko symbols should be written as a gtest in toolkit/components/glean/gtest/.

By necessity these can only be integration tests against the compiled crate.

Note: When adding a new test file, don't forget to add it to toolkit/components/glean/gtest/moz.build and use the FOG prefix in your test names (e.g. TEST(FOG, YourTestName) { ... }).

To run FOG's Rust gtest suite use mach gtest FOG.*

2.1 KiB Raw Blame History