motorhead/qemu
1
0
Fork 0
mirror of https://github.com/Motorhead1991/qemu.git synced 2025-08-03 07:43:54 -06:00
Code Issues Projects Releases Packages Wiki Activity Actions

rust: build: add "make clippy", "make rustfmt", "make rustdoc"

Browse source 
Abstract common invocations of "cargo", that do not require copying
the generated bindgen file or setting up MESON_BUILD_ROOT.

In the future these could also do completely without cargo and invoke
the underlying programs directly.

Reviewed-by: Junjie Mao <junjie.mao@hotmail.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
This commit is contained in:
Paolo Bonzini 2024-11-13 09:11:48 +01:00
parent 2f9eec8f72
commit cab1d0bceb
3 changed files with 35 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

10
rust/qemu-api/README.md
View file

@ -5,13 +5,15 @@ This library exports helper Rust types, Rust macros and C FFI bindings for inter
The C bindings can be generated with `bindgen`, using this build target:
```console
$ ninja bindings.inc.rs
$ make bindings.inc.rs
```
## Generate Rust documentation
To generate docs for this crate, including private items:
Common Cargo tasks can be performed from the QEMU build directory
```sh
pyvenv/bin/meson devenv -w ../rust cargo doc --no-deps --document-private-items
```console
$ make clippy
$ make rustfmt
$ make rustdoc
```

9
rust/qemu-api/build.rs
View file

@ -20,8 +20,13 @@ fn main() -> Result<()> {
let file = Path::new(&file);
if !Path::new(&file).exists() {
panic!(concat!(
"No generated C bindings found! If you want to run `cargo`, start a subshell\n",
"with `meson devenv`, or point MESON_BUILD_ROOT to the top of the build tree."
"\n",
" No generated C bindings found! Maybe you wanted one of\n",
" `make clippy`, `make rustfmt`, `make rustdoc`?\n",
"\n",
" For other uses of `cargo`, start a subshell with\n",
" `pyvenv/bin/meson devenv`, or point MESON_BUILD_ROOT to\n",
" the top of the build tree."
));
}