Struct safer_ffi::headers::Builder

pub struct Builder<'__, W> { /* private fields */ }

Available on crate feature headers only.

Implementations

impl<'__, W> Builder<'__, W>

pub fn with_guard(self, guard: &'__ str) -> Self

Sets up the name of the ifndef guard of the header file.

It defaults to:

format!("__RUST_{}__", env::var("CARGO_PKG_NAME")?.replace("-", "_").to_ascii_uppercase())

pub fn with_banner(self, banner: &'__ str) -> Self

Sets up the banner of the generated C header file.

It defaults to:

concat!(
    "/*! \\file */\n",
    "/*******************************************\n",
    " *                                         *\n",
    " *  File auto-generated by `::safer_ffi`.  *\n",
    " *                                         *\n",
    " *  Do not manually edit this file.        *\n",
    " *                                         *\n",
    " *******************************************/\n",
)

/*! \file */
/*******************************************
 *                                         *
 *  File auto-generated by `::safer_ffi`.  *
 *                                         *
 *  Do not manually edit this file.        *
 *                                         *
 *******************************************/

impl<'__> Builder<'__, WhereTo>

pub fn to_file(self, filename: impl AsRef<Path>) -> Result<Builder<'__, File>>

Specify the path to the file to be generated.

⚠️ If it already exists, its contents will be overwritten ⚠️

There is no default value here, either .to_file() or .to_writer() need to be called to be able to .generate() the headers.

For more fine-grained control over the “output stream” where the headers will be written to, use .to_writer().

Example

::safer_ffi::headers::builder()
    .to_file("my_header.h")?
    .generate()?

pub fn to_writer<W>(self, out: W) -> Builder<'__, W> where
    W: Write, 

Specify the Write “stream” where the headers will be written to.

Example

// Display the headers to the standard output
// (may need the `--nocapture` flag when running the tests)
::safer_ffi::headers::builder()
    .to_writer(::std::io::stdout())
    .generate()?

impl<'__, W: Write> Builder<'__, W>

pub fn generate(self) -> Result<()>

Generate the C header file.

impl Builder<'_, WhereTo>

pub fn generate_with_definer(self, definer: impl Definer) -> Result<()>

More customizable version of .generate().

With this call, one can provide a custom implementation of a Definer, which can be useful for mock tests, mainly.

Trait Implementations

impl<'__, W: Default> Default for Builder<'__, W>

fn default() -> Builder<'__, W>

Returns the “default value” for a type.