aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
authorDylan Baker <dylan@pnwbakers.com>2020-10-21 16:07:31 -0700
committerDylan Baker <dylan@pnwbakers.com>2021-01-05 15:10:50 -0800
commit3d80a88bd3c3dc8f9e20bbda485b0b436fd79fb3 (patch)
treed8c4fe8fd2c76920a42e4090348681169974f2af /docs/markdown/snippets
parentb2c2549b93a8001d8a6d9d6da1ce756645e59160 (diff)
downloadmeson-3d80a88bd3c3dc8f9e20bbda485b0b436fd79fb3.zip
meson-3d80a88bd3c3dc8f9e20bbda485b0b436fd79fb3.tar.gz
meson-3d80a88bd3c3dc8f9e20bbda485b0b436fd79fb3.tar.bz2
modules: Add an unstable-rust module
Like other language specific modules this module is module for holding rust specific helpers. This commit adds a test() function, which simplifies using rust's internal unittest mechanism. Rust tests are generally placed in the same code files as they are testing, in contrast to languages like C/C++ and python which generally place the tests in separate translation units. For meson this is somewhat problematic from a repetition point of view, as the only changes are generally adding --test, and possibly some dependencies. The rustmod.test() method provides a mechanism to remove the repatition: it takes a rust target, copies it, and then addes the `--test` option, then creates a Test() target with the `rust` protocol. You can pass additional dependencies via the `dependencies` keyword. This all makes for a nice, DRY, test definition.
Diffstat (limited to 'docs/markdown/snippets')
-rw-r--r--docs/markdown/snippets/unstable-rust-module.md4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/markdown/snippets/unstable-rust-module.md b/docs/markdown/snippets/unstable-rust-module.md
new file mode 100644
index 0000000..15a7ecb
--- /dev/null
+++ b/docs/markdown/snippets/unstable-rust-module.md
@@ -0,0 +1,4 @@
+## Untable Rust module
+
+A new unstable module has been added to make using rust with meson easier.
+Currently it adds a single function to ease defining rust tests.