Confirm
1,345
edits
Changes
→Documentation and assistance
** Nika Layzell (:mystor)
** Cameron McCormack (:heycam)
== FAQ ==
'''Q:''' What is the policy for vendoring non-Mozilla crates into mozilla-central?<br />
'''A:''' It is possible. The most important point is that the license must be compatible. Reviewers should also look at the crate code some to check that it looks reasonable (especially for unsafe code) and that it has reasonable tests. Other than that, there is no formal sign-off procedure, but one may be added in the future.
'''Q:''' Do we support building standalone Rust programs?<br />
'''A:''' Yes! Look for <tt>RUST_PROGRAMS</tt> rules in <tt>moz.build</tt> files.
'''Q:''' How are in-tree Rust crates tested?<br />
'''A:''' In general we don't run tests for third-party crates; the assumption is that these crates are sufficiently well-tested elsewhere. (Which means that large test fixtures should be removed when vendoring third-party crates, because they just bloat mozilla-central.) Mozilla crates can be tested with <tt>cargo test</tt> by adding them to <tt>RUST_TESTS</tt> in <tt>toolkit/library/rust/moz.build</tt>. Alternatively, you can write a GTest that uses FFI to call into Rust code.
= Rust Components =
