| commit | 6adbf9cfd3aebd22cec7f025db72c88074eaff77 | [log] [tgz] |
|---|---|---|
| author | Sam McCall <sammccall@google.com> | Fri Nov 17 01:30:20 2023 -0800 |
| committer | Copybara-Service <copybara-worker@google.com> | Fri Nov 17 01:31:48 2023 -0800 |
| tree | 94399e4ff896781829976d5413c77304f6ea0e16 | |
| parent | 563c93c033b9f3e7e6c7119a278bb520b4fa7776 [diff] |
Document the invariant around PointerValue modelling We have recently introduced crashes by violating this invarinat. This is unfortunately easy and maybe we should address that, but documenting the requirement seems like a good start. PiperOrigin-RevId: 583304560 Change-Id: Ib7467d9532ab5f6e41e66faad74001b899668ab9
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