#build-dependencies #script #folly

build find-folly

Allows Rust build.rs scripts to easily locate the Folly library

1 unstable release

0.1.0 Aug 31, 2022

#418 in Build Utils

MIT/Apache

10KB
111 lines

find-folly

Overview

This crate is a simple build dependency you can use in your build.rs scripts to compile and link against the Folly C++ library.

In theory, the pkg-config library would be all you need in order to locate Folly, because Folly is typically packed with a .pc file. In practice, that is insufficient, because the .pc file doesn't fully describe all the dependencies that Folly has, and it has bugs. This crate knows about these idiosyncrasies and provides workarounds for them.

The following snippet should suffice for most use cases:

let folly = find_folly::probe_folly().unwrap();
let mut build = cc::Build::new();
... populate `build` ...
build.includes(&folly.include_paths);
for other_cflag in &folly.other_cflags {
    build.flag(other_cflag);
}

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Code of conduct

This project follows the same Code of Conduct as Rust itself. Reports can be made to the project authors.

Dependencies

~305–780KB
~18K SLoC