seesaw 0.1.7

//! Generate traits from C header files.
//!
//! When rewriting a C libary in Rust,
//! you often want to preserve the original C header files.
//!
//! This is possible using this crate in conjuction with [`bindgen`](https://docs.rs/bindgen).
//!
//! Take the following `C` header.
//!
//! ```c
#![doc = include_str!("../tests/yakshaver.h")]
//! ```
//!
//! In your `build.rs` script:
//! 1. Use [`bindgen`](https://docs.rs/bindgen) to generate equivalent Rust blocks.
//! 2. Use [`seesaw`] to generate a trait from those bindings.
//!
//! ```no_run
//! // build.rs
//! # fn main() -> Result<(), Box<dyn std::error::Error>> {
//! let bindings = bindgen::builder().header("yakshaver.h").generate()?;
//! seesaw::seesaw("Yakshaver", &bindings, "generated/seesaw.rs")?;
//! bindings.write_to_file("generated/bindgen.rs")?;
//! # Ok(())
//! # }
//! ```
//!
//! The generated file will look like this:
//!
//! ```
//! # struct yakshaver;
#![doc = include_str!("../tests/generated/seesaw.rs")]
//! ```
//!
//! And you can export the same ABI as the C library using [`no_mangle`],
//! which simply adds `#[no_mangle]` to each of the functions.
//!
//! ```
//! # const _: &str = stringify! {
//! #[seesaw::no_mangle]
//! impl YakShaver for () { .. }
//! # };
//! ```

#![cfg_attr(not(feature = "std"), no_std)]

#[cfg(feature = "macros")]
#[doc(inline)]
pub use seesaw_macros::no_mangle;

#[cfg(feature = "build")]
pub use imp::{seesaw, Destination, Trait, TraitSet};

#[cfg(feature = "build")]
mod imp;