Merge pull request #73 from Cysharp/feature/csharp_file_headerfooter

Add csharp_file_header/footer

Author: neuecc

README.md

@@ -299,6 +299,8 @@ csbindgen::Builder::default()
         "FfiConfiguration" => "Configuration".into(),
         _ => x,
     })
+    .csharp_file_header("#if !UNITY_WEBGL")       // optional, default: ""
+    .csharp_file_footer("#endif")                 // optional, default: ""
     .generate_to_file("src/lz4_ffi.rs", "../dotnet-sandbox/lz4_bindgen.cs") // required
     .unwrap();
 ```

csbindgen-tests/build.rs

@@ -143,6 +143,8 @@ fn main() -> Result<(), Box<dyn Error>> {
         .csharp_namespace("Physx")
         .csharp_class_name("LibPhysx")
         .csharp_dll_name("libphys")
+        .csharp_file_header("#if !FALSE")
+        .csharp_file_footer("#endif")
         .generate_csharp_file("../dotnet-sandbox/libphysx_csbindgen.cs")?;
 
     Ok(())

csbindgen/src/builder.rs

@@ -34,6 +34,8 @@ pub struct BindgenOptions {
     pub csharp_imported_namespaces: Vec<String>,
     pub csharp_generate_const_filter: fn(const_name: &str) -> bool,
     pub csharp_type_rename: fn(type_name: String) -> String,
+    pub csharp_file_header: String,
+    pub csharp_file_footer: String,
     pub always_included_types: Vec<String>,
 }
 
@@ -61,6 +63,8 @@ impl Default for Builder {
                 csharp_imported_namespaces: vec![],
                 csharp_generate_const_filter: |_| false,
                 csharp_type_rename: identity,
+                csharp_file_header: "".to_string(),
+                csharp_file_footer: "".to_string(),
                 always_included_types: vec![],
             },
         }
@@ -225,6 +229,18 @@ impl Builder {
         self
     }
 
+    /// configure the additional header for the generated C# code.
+    pub fn csharp_file_header<T: Into<String>>(mut self, csharp_file_header: T) -> Builder {
+        self.options.csharp_file_header = csharp_file_header.into();
+        self
+    }
+
+    /// configure the additional footer for the generated C# code.
+    pub fn csharp_file_footer<T: Into<String>>(mut self, csharp_file_footer: T) -> Builder {
+        self.options.csharp_file_footer = csharp_file_footer.into();
+        self
+    }
+
     pub fn generate_csharp_file<P: AsRef<Path>>(
         &self,
         csharp_output_path: P,

csbindgen/src/emitter.rs

@@ -344,18 +344,25 @@ pub fn emit_csharp(
         }
     }
 
+    let file_header = if options.csharp_file_header.len() > 0 {
+        options.csharp_file_header.to_string() + "\n"
+     } else {
+        "".to_string()
+     } + "// <auto-generated>
+// This code is generated by csbindgen.
+// DON'T CHANGE THIS DIRECTLY.
+// </auto-generated>
+#pragma warning disable CS8500
+#pragma warning disable CS8981";
+    let file_footer = &options.csharp_file_footer;
+
     let mut imported_namespaces = String::new();
     for name in &options.csharp_imported_namespaces {
         imported_namespaces.push_str_ln(format!("using {name};").as_str());
     }
 
     let result = format!(
-        "// <auto-generated>
-// This code is generated by csbindgen.
-// DON'T CHANGE THIS DIRECTLY.
-// </auto-generated>
-#pragma warning disable CS8500
-#pragma warning disable CS8981
+"{file_header}
 using System;
 using System.Runtime.InteropServices;
 {imported_namespaces}
@@ -374,8 +381,7 @@ namespace {namespace}
 {structs_string}
 {enum_string}
 }}
-    "
-    );
+{file_footer}");
 
     result
 }

dotnet-sandbox/libphysx_csbindgen.cs

@@ -1,3 +1,4 @@
+#if !FALSE
 // <auto-generated>
 // This code is generated by csbindgen.
 // DON'T CHANGE THIS DIRECTLY.
@@ -11271,4 +11272,4 @@ internal enum PxPvdInstrumentationFlags : byte
 
 
 }
-    
+#endif