diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/markdown/snippets/rust_dependency_map.md | 18 | ||||
| -rw-r--r-- | docs/yaml/functions/_build_target_base.yaml | 10 |
2 files changed, 28 insertions, 0 deletions
diff --git a/docs/markdown/snippets/rust_dependency_map.md b/docs/markdown/snippets/rust_dependency_map.md new file mode 100644 index 000000000..62c9dae4d --- /dev/null +++ b/docs/markdown/snippets/rust_dependency_map.md @@ -0,0 +1,18 @@ +## Support for defining crate names of Rust dependencies in Rust targets + +Rust supports defining a different crate name for a dependency than what the +actual crate name during compilation of that dependency was. + +This allows using multiple versions of the same crate at once, or simply using +a shorter name of the crate for convenience. + +```meson +a_dep = dependency('some-very-long-name') + +my_executable = executable('my-executable', 'src/main.rs', + rust_dependency_map : { + 'some_very_long_name' : 'a', + }, + dependencies : [a_dep], +) +``` diff --git a/docs/yaml/functions/_build_target_base.yaml b/docs/yaml/functions/_build_target_base.yaml index 8b169c8f7..abc5bf94a 100644 --- a/docs/yaml/functions/_build_target_base.yaml +++ b/docs/yaml/functions/_build_target_base.yaml @@ -302,3 +302,13 @@ kwargs: "proc-macro" is a special rust procedural macro crate. "proc-macro" is new in 0.62.0. + + rust_dependency_map: + type: dict[str] + since: 1.2.0 + description: | + On rust targets this provides a map of library names to the crate name + with which it would be available inside the rust code. + + This allows renaming similar to the dependency renaming feature of cargo + or `extern crate foo as bar` inside rust code. |