Support calling Rust-ABI functions through the generated bindings.

Before this CL the tool would only generate meaningful code in the
..._cc_api.h file.  This was sufficient for invoking `pub extern "C" fn`
Rust functions (simply redeclaring `#[no_mangle]` functions in C++,
or defining a small, `inline` C++ function that forwards to a slightly
renamed `#[export_name = ...]` function).

After this CL the tool will also populate ..._cc_api_impl.rs file with
Rust thunks that expose `pub fn` Rust functions that use the default
Rust ABI (rather than using `extern "C"` to ask for C ABI).  A small,
`inline` C++ function is generated to call into the think (quite similar
to how the `#[export_name = ...]` case is handled).

The thunks expose the same parameter and return types as the original
function via C ABI.  (Currently the tool only supports a limited set of
parameter types and return types - all of the supported types can be
directly used in an `extedn "C"` function/thunk.)

PiperOrigin-RevId: 489328746
4 files changed
tree: 7a07c3511d37dcfaead2537f7b9434bb02ad37d2
  1. .bazelci/
  2. bazel/
  3. cc_bindings_from_rs/
  4. cc_import/
  5. cc_template/
  6. common/
  7. docs/
  8. lifetime_analysis/
  9. lifetime_annotations/
  10. migrator/
  11. nullability_verification/
  12. rs_bindings_from_cc/
  13. .bazelrc
  14. .gitignore
  15. BUILD
  16. Cargo.Bazel.lock
  17. CODE_OF_CONDUCT
  18. CONTRIBUTING
  19. LICENSE
  20. README.md
  21. WORKSPACE
README.md

Crubit: C++/Rust Bidirectional Interop Tool

Build status

Extremely experimental interop tooling for C++ and Rust.

Please don‘t use, this is an experiment and we don’t yet know where will it take us. There will be breaking changes without warning. Unfortunately, we can't take contributions at this point.

Building Crubit

$ apt install clang lld bazel
$ git clone git@github.com:google/crubit.git
$ cd crubit
$ bazel build --linkopt=-fuse-ld=/usr/bin/ld.lld //rs_bindings_from_cc:rs_bindings_from_cc_impl

Using a prebuilt LLVM tree

$ git clone https://github.com/llvm/llvm-project
$ cd llvm-project
$ CC=clang CXX=clang++ cmake -S llvm -B build -DLLVM_ENABLE_PROJECTS='clang' -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=install
$ cmake --build build -j
$ # wait...
$ cmake --install build
$ cd ../crubit
$ LLVM_INSTALL_PATH=../llvm-project/install bazel build //rs_bindings_from_cc:rs_bindings_from_cc_impl