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.
To build this project additionally to Rust an Ada toolchain is needed. Furthermore the following libraries are required:
gnatcoll_iconvgnatcoll_gmpThe easiest way to get the required dependencies is alire. This repository comes with an alire package that already defines the correct dependencies. To get an Ada environment run
shell
$ alr update
$ eval $(alr printenv --unix)
After that you can simply run cargo test. Note that this only adds the dependencies
for the gpr-rust crate itself. Any additional Ada dependencies for software built with
this library must be added by other means.
This library is intended to be used in build scripts. The basic process consists of three steps.
rust
let project = gpr::Project::load(Path::new("/path/to/project.gpr")).unwrap();
if !output.status.success() {
panic!();
}
- Providing cargo with the required linker flags:
rust
println!(
"cargo:rustc-link-search{}",
project.librarydir().unwrap().tostr().unwrap()
);
println!(
"cargo:rustc-link-lib={}={}",
project.librarykind().unwrap(),
project.libraryname().unwrap()
);
- Additionally it can be helpful to tell cargo that changes in the Ada code also
should trigger a rerun:
rust
for dir in project.sourcedirs().unwrap() {
println!(
"cargo:rerun-if-changed={}", dir.asstr()
);
}
```
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