tree: 0516c274deb27059ad907b4b40732949bafa5c48 [path history] [tgz]
  1. bazel_support/
  2. test/
  3. bindings.rs
  4. BUILD
  5. cc_bindings_from_rs.rs
  6. cc_bindings_from_rs_sh_test.sh
  7. cmdline.rs
  8. crubit_attr.rs
  9. README.md
  10. run_compiler.rs
  11. run_compiler_test_support.rs
  12. toposort.rs
cc_bindings_from_rs/README.md

cc_bindings_from_rs

Invoking the tool on the command line

Most rustc cmdline parameters should be supported (e.g. --crate-type).

The following example should work in the current dev environment:

$ echo > $HOME/scratch/test.rs "
pub extern \"C\" fn public_function() {
    private_function()
}
fn private_function() {}
"

$ cd crubit/cc_bindings_from_rs
$ bazel run :cc_bindings_from_rs -- \
    --h-out=$HOME/scratch/test.h \
    --rs-out=$HOME/scratch/test_impl.rs \
    --clang-format-exe-path=<path_of_clang_format_executable> -- \
    --rustfmt-exe-path=<path_of_rustfmt_executable> -- \
    $HOME/scratch/test.rs \
    --crate-type=lib \
    --codegen=panic=abort

$ cat $HOME/scratch/test.h
// Automatically @generated C++ bindings for the following Rust crate:
// test

#pragma once

namespace test {
extern "C" void public_function();
}

Invoking the tool through bazel aspect

You can inspect the generated bindings files by building the aspect:

bazel build --aspects \
  //cc_bindings_from_rs/bazel_support:cc_bindings_from_rust_rule.bzl%cc_bindings_from_rust_aspect \
  --output_groups=out \
  //some/rust:library

Contributing

See rs_bindings_from_cc/README.md.