Auto merge of #1109 - fitzgen:rustfmt-stdout, r=fitzgen

lib: rustfmt output to stdout

*(Recreated + slightly touched up version of #1042 + a version bump)*

Simplify the rustfmt and write mechanism.  Use rustfmt generated string to allow writing to stdout or to rustfmt a file.
tree: f542f16958998424a6d0a811327bce651ac3cfee
  1. .github/
  2. bindgen-integration/
  3. book/
  4. ci/
  5. csmith-fuzzing/
  6. releases/
  7. src/
  8. tests/
  9. .gitattributes
  10. .gitignore
  11. .travis.yml
  12. appveyor.yml
  13. build.rs
  14. Cargo.lock
  15. Cargo.toml
  16. CONTRIBUTING.md
  17. example-graphviz-ir.png
  18. LICENSE
  19. README.md
  20. rustfmt.toml
README.md

bindgen

impl period has been started! Join us at Gitter.im.

bindgen automatically generates Rust FFI bindings to C and C++ libraries.

For example, given the C header doggo.h:

typedef struct Doggo {
    int many;
    char wow;
} Doggo;

void eleven_out_of_ten_majestic_af(Doggo* pupper);

bindgen produces Rust FFI code allowing you to call into the doggo library's functions and use its types:

/* automatically generated by rust-bindgen */

#[repr(C)]
pub struct Doggo {
    pub many: ::std::os::raw::c_int,
    pub wow: ::std::os::raw::c_char,
}

extern "C" {
    pub fn eleven_out_of_ten_majestic_af(pupper: *mut Doggo);
}

Users Guide

📚 Read the bindgen users guide here! 📚

API Reference

API reference documentation is on docs.rs

Contributing

See CONTRIBUTING.md for hacking on bindgen!