Support bindgen in recommended usage

Cargo.toml

@@ -14,8 +14,10 @@ build = "build.rs"
 [dependencies]
 libc = "0.2"
 
-[target.'cfg(not(windows))'.build-dependencies]
+[target.'cfg(not(all(windows, target_env="msvc")))'.build-dependencies]
 pkg-config = "0.3"
+bindgen = "0.53.2"
 
-[target.'cfg(windows)'.build-dependencies]
-vcpkg = "0.2"
+[target.'cfg(all(windows, target_env="msvc"))'.build-dependencies]
+vcpkg = "0.2"
+bindgen = "0.53.2"

README.md

@@ -0,0 +1,16 @@
+# `libftdi1-sys`
+`libftdi1-sys` is a crate providing Rust bindings to the C library
+[`libftdi1`](https://www.intra2net.com/en/developer/libftdi/index.php).
+
+## Prerequisites
+The libftdi1 bindings are generated at compile-time, per bindgen's
+[recommended usage](https://rust-lang.github.io/rust-bindgen/library-usage.html).
+
+* `libclang` must be installed and visible on your path. If you are using a
+  `gcc`-toolchain and don't want to install the entirity of LLVM just for
+  `libclang`,
+
+* `libftdi` version 1.4 (the most recent version as of 2017) is required.
+
+* The Minimum Supported Rust Version (MSRV) is stable `1.42`. However, older
+  versions may work and simply have not been tested.

build.rs

@@ -1,9 +1,28 @@
-#[cfg(not(windows))]
-fn main() {
-    pkg_config::find_library("libftdi1").unwrap();
-}
+use bindgen;
+use std::env;
+use std::path::PathBuf;
 
-#[cfg(windows)]
 fn main() {
+    #[cfg(not(all(windows, target_env="msvc")))]
+    pkg_config::Config::new().atleast_version("1.4").probe("libftdi1").unwrap();
+    #[cfg(all(windows, target_env="msvc"))]
     vcpkg::find_package("libftdi1").unwrap();
+
+    let bindings = bindgen::Builder::default()
+        .header("wrapper.h")
+        .default_enum_style(bindgen::EnumVariation::Rust{ non_exhaustive : true })
+        .rustfmt_bindings(true)
+        .whitelist_function("ftdi_.*")
+        .whitelist_type("ftdi_.*")
+        .whitelist_type("libusb_.*")
+        .blacklist_type("timeval")
+        .blacklist_type("__.*")
+        .raw_line("pub type timeval = libc::timeval;")
+        .generate()
+        .expect("Unable to generate bindings");
+
+    let out_path = PathBuf::from(env::var("OUT_DIR").unwrap());
+    bindings
+        .write_to_file(out_path.join("bindings.rs"))
+        .expect("Couldn't write bindings!");
 }