| --- |
| short-description: Rust language integration module |
| authors: |
| - name: Dylan Baker |
| email: dylan@pnwbakers.com |
| years: [2020] |
| ... |
| |
| # Unstable Rust module |
| |
| *(new in 0.57.0)* |
| |
| **Note** Unstable modules make no backwards compatible API guarantees. |
| |
| The rust module provides helper to integrate rust code into meson. The goal |
| is to make using rust in meson more pleasant, while still remaining mesonic, |
| this means that it attempts to make rust work more like meson, rather than |
| meson work more like rust. |
| |
| ## Functions |
| |
| ### test(name: string, target: library | executable, dependencies: []Dependency) |
| |
| This function creates a new rust unittest target from an existing rust based |
| target, which may be a library or executable. It does this by copying the |
| sources and arguments passed to the original target and adding the `--test` |
| argument to the compilation, then creates a new test target which calls that |
| executable, using the rust test protocol. |
| |
| This accepts all of the keyword arguments as the |
| [`test`](Reference-manual.md#test) function except `protocol`, it will set |
| that automatically. |
| |
| Additional, test only dependencies may be passed via the dependencies |
| argument. |
