gpr-rust

Gpr-Rust is a Rust binding for gpr. its goal is to provide an easy way to integrate Ada sources into the Rust build process. It allows to select and build a GNAT project file by parsing the project and providing all required information to call gprbuild and link the resulting library.

Dependencies

To build this project additionally to Rust an Ada toolchain is needed. Furthermore the following libraries are required:

• gnatcoll_iconv
• gnatcoll_gmp

The easiest way to get these is to install the GNAT Community Edition.

Usage

This library is intended to be used in build scripts. The basic process consists of three steps.

• Loading the project: rust let project = gpr::Project::load(Path::new("/path/to/project.gpr")).unwrap();
• Building the project: rust Command::new("gprbuild") .args(project.gprbuild_args().unwrap()) .spawn() .unwrap() .wait() .unwrap();
• Providing cargo with the required linker flags: rust println!( "cargo:rustc-link-search{}", project.library_dir().unwrap().to_str().unwrap() ); println!( "cargo:rustc-link-lib={}={}", project.library_kind().unwrap(), project.library_name().unwrap() );

Gpr-Rust doesn't need much configuration, most of the code needed is boilerplate. If any additional options are required to build the Ada project these can be added as arguments to the gprbuild command.

An example project is located in examples/ada_hello/build.rs. It can be tested by running: shell cd examples/ada_hello LD_LIBRARY_PATH=ada_hello/lib cargo run