cpp_to_rust_build_tools

Build script implementation for C++ library wrappers.

Online documentation

Crates generated by cpp_to_rust_generator require multiple custom build operations:

• Apply extra build configuration passed via environment variables (CPP_TO_RUST_LIB_PATHS, CPP_TO_RUST_FRAMEWORK_PATHS, CPP_TO_RUST_INCLUDE_PATHS);
• Select active build configuration based on current target;
• Build the C++ wrapper library;
• Generate ffi.rs file with actual linking attributes;
• Determine sizes of C++ types with stack allocation place;
• Print cargo attributes required for linking the crate.

It appears a common task to perform other custom operations in the build script, so all the above operations are implemented as a separate crate (cpp_to_rust_build_tools) which is used as build dependency of the default generated build script. If a custom build script is defined, it should use this crate's API to perform the necessary build operations.

See README of the repository root for more information about other parts of the project.