| commit | 199d969cc3d2ddd8bb75c8eb23d1cd7d2371e9e5 | [log] [tgz] |
|---|---|---|
| author | Devin Jeanpierre <jeanpierreda@google.com> | Mon Oct 02 11:53:53 2023 -0700 |
| committer | Copybara-Service <copybara-worker@google.com> | Mon Oct 02 11:54:23 2023 -0700 |
| tree | 8762b25062f1590a3e92a70f08f6b89adcb41170 | |
| parent | 8c90fda07daf96b893e7b2786bfa775cb6e55f9b [diff] |
Allow multiple headers in `--bindings-from-dependency`. A rust crate will only ever have one header. However, if we export types that come from the Rust bindings for a C++ library, that C++ library may have multiple headers. And so if we want to support these round-tripped-types, using `--bindings-from-dependency` to record which headers they came from, `--bindings-from-dependency` must have a vec of includes, not just a single include. Similarly, the provider which outputs this must support a list of headers, not just a single header -- but that is a separate CL. (And at any rate, we can't usefully _send_ multiple headers until an updated crubit release.) This isn't a sufficient change to cc_bindings_from_rs to support round-tripping the interop (we still need to generate correct include paths and type names), but it's part of that change. PiperOrigin-RevId: 570132807 Change-Id: I9fe02bc63cb35e46af46d3047ce5ac14a33e4e8b
Crubit is an experimental bidirectional bindings generator 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.
Crubit allows for C++ code and Rust code to call each other without manually wrapping the APIs in an FFI-friendly interop layer. For example, a C++ function like this:
bool IsAbsPath(std::string_view path);
... becomes callable from Rust as if it were defined as:
pub fn IsAbsPath(path: std::string_view) -> bool {...}
Crubit automatically generates ABI-compatible bindings for structs (which can be passed both by value and by reference), functions, and methods, for a large variety of types. (Trivial types, nontrivial types, templated types, etc.)
$ 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
$ 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