Add support for verbatim content after includes

Let the user add raw C code in the generated header after the include
blocks.

It matches what bindgen provides with the raw_lines option.

docs.md

@@ -396,6 +396,8 @@ no_includes = false
 # default: false
 cpp_compat = false
 
+# A list of lines to add verbatim after the includes block
+after_includes = "#define VERSION 1"
 
 
 

src/bindgen/bindings.rs

@@ -156,6 +156,7 @@ impl Bindings {
         if self.config.no_includes
             && self.config.sys_includes.is_empty()
             && self.config.includes.is_empty()
+            && self.config.after_includes.is_none()
         {
             return;
         }
@@ -200,6 +201,11 @@ impl Bindings {
             write!(out, "#include \"{}\"", include);
             out.new_line();
         }
+
+        if let Some(ref line) = self.config.after_includes {
+            write!(out, "{}", line);
+            out.new_line();
+        }
     }
 
     pub fn write<F: Write>(&self, file: F) {

src/bindgen/builder.rs

@@ -60,6 +60,12 @@ impl Builder {
         self
     }
 
+    #[allow(unused)]
+    pub fn with_after_include<S: AsRef<str>>(mut self, line: S) -> Builder {
+        self.config.after_includes = Some(String::from(line.as_ref()));
+        self
+    }
+
     #[allow(unused)]
     pub fn with_trailer<S: AsRef<str>>(mut self, trailer: S) -> Builder {
         self.config.trailer = Some(String::from(trailer.as_ref()));

src/bindgen/config.rs

@@ -701,6 +701,8 @@ pub struct Config {
     pub includes: Vec<String>,
     /// A list of additional system includes to put at the beginning of the generated header
     pub sys_includes: Vec<String>,
+    /// Optional verbatim code added after the include blocks
+    pub after_includes: Option<String>,
     /// Optional text to output at the end of the file
     pub trailer: Option<String>,
     /// Optional name to use for an include guard
@@ -768,6 +770,7 @@ impl Default for Config {
             header: None,
             includes: Vec::new(),
             sys_includes: Vec::new(),
+            after_includes: None,
             trailer: None,
             include_guard: None,
             pragma_once: false,

template.toml

@@ -24,6 +24,7 @@ using_namespaces = []
 sys_includes = []
 includes = []
 no_includes = false
+after_includes = ""
 
 
 

tests/expectations/both/raw_lines.c

@@ -0,0 +1,12 @@
+#ifndef INCLUDE_GUARD_H
+#define INCLUDE_GUARD_H
+
+#include <stdarg.h>
+#include <stdbool.h>
+#include <stdint.h>
+#include <stdlib.h>
+#define VERSION 1
+
+void root(void);
+
+#endif /* INCLUDE_GUARD_H */

tests/expectations/both/raw_lines.compat.c

@@ -0,0 +1,20 @@
+#ifndef INCLUDE_GUARD_H
+#define INCLUDE_GUARD_H
+
+#include <stdarg.h>
+#include <stdbool.h>
+#include <stdint.h>
+#include <stdlib.h>
+#define VERSION 1
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+void root(void);
+
+#ifdef __cplusplus
+} // extern "C"
+#endif // __cplusplus
+
+#endif /* INCLUDE_GUARD_H */

tests/expectations/raw_lines.c

@@ -0,0 +1,12 @@
+#ifndef INCLUDE_GUARD_H
+#define INCLUDE_GUARD_H
+
+#include <stdarg.h>
+#include <stdbool.h>
+#include <stdint.h>
+#include <stdlib.h>
+#define VERSION 1
+
+void root(void);
+
+#endif /* INCLUDE_GUARD_H */

tests/expectations/raw_lines.compat.c

@@ -0,0 +1,20 @@
+#ifndef INCLUDE_GUARD_H
+#define INCLUDE_GUARD_H
+
+#include <stdarg.h>
+#include <stdbool.h>
+#include <stdint.h>
+#include <stdlib.h>
+#define VERSION 1
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+void root(void);
+
+#ifdef __cplusplus
+} // extern "C"
+#endif // __cplusplus
+
+#endif /* INCLUDE_GUARD_H */

tests/expectations/raw_lines.cpp

@@ -0,0 +1,16 @@
+#ifndef INCLUDE_GUARD_H
+#define INCLUDE_GUARD_H
+
+#include <cstdarg>
+#include <cstdint>
+#include <cstdlib>
+#include <new>
+#define VERSION 1
+
+extern "C" {
+
+void root();
+
+} // extern "C"
+
+#endif // INCLUDE_GUARD_H

tests/expectations/tag/raw_lines.c

@@ -0,0 +1,12 @@
+#ifndef INCLUDE_GUARD_H
+#define INCLUDE_GUARD_H
+
+#include <stdarg.h>
+#include <stdbool.h>
+#include <stdint.h>
+#include <stdlib.h>
+#define VERSION 1
+
+void root(void);
+
+#endif /* INCLUDE_GUARD_H */

tests/expectations/tag/raw_lines.compat.c

@@ -0,0 +1,20 @@
+#ifndef INCLUDE_GUARD_H
+#define INCLUDE_GUARD_H
+
+#include <stdarg.h>
+#include <stdbool.h>
+#include <stdint.h>
+#include <stdlib.h>
+#define VERSION 1
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+void root(void);
+
+#ifdef __cplusplus
+} // extern "C"
+#endif // __cplusplus
+
+#endif /* INCLUDE_GUARD_H */

tests/rust/raw_lines.rs

@@ -0,0 +1,3 @@
+#[no_mangle]
+pub extern "C" fn root() {
+}

tests/rust/raw_lines.toml

@@ -0,0 +1,3 @@
+include_guard = "INCLUDE_GUARD_H"
+no_includes = false
+after_includes = "#define VERSION 1"