polyxml 0.18.0__tar.gz → 0.19.1__tar.gz

{polyxml-0.18.0 → polyxml-0.19.1}/Cargo.lock

@@ -549,7 +549,7 @@ dependencies = [
 
 [[package]]
 name = "polyxml"
-version = "0.18.0"
+version = "0.19.1"
 dependencies = [
  "criterion",
  "heck",
@@ -567,14 +567,14 @@ dependencies = [
 
 [[package]]
 name = "polyxml-c"
-version = "0.18.0"
+version = "0.19.1"
 dependencies = [
  "polyxml",
 ]
 
 [[package]]
 name = "polyxml-cli"
-version = "0.18.0"
+version = "0.19.1"
 dependencies = [
  "clap",
  "glob",
@@ -588,7 +588,7 @@ dependencies = [
 
 [[package]]
 name = "polyxml-js"
-version = "0.18.0"
+version = "0.19.1"
 dependencies = [
  "napi",
  "napi-build",
@@ -598,7 +598,7 @@ dependencies = [
 
 [[package]]
 name = "polyxml-python"
-version = "0.18.0"
+version = "0.19.1"
 dependencies = [
  "lexical-core",
  "polyxml",

{polyxml-0.18.0 → polyxml-0.19.1}/Cargo.toml

@@ -3,7 +3,7 @@ resolver = "2"
 members = ["crates/polyxml-core", "crates/polyxml-python"]
 
 [workspace.package]
-version = "0.18.0"
+version = "0.19.1"
 edition = "2021"
 rust-version = "1.80"
 license = "MIT"

{polyxml-0.18.0 → polyxml-0.19.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: polyxml
-Version: 0.18.0
+Version: 0.19.1
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/src/codegen/cpp/mod.rs

@@ -77,6 +77,8 @@ pub struct CppOptions {
     pub emit_cmake: bool,
     /// Emit Meson build definition (meson.build) (default: false)
     pub emit_meson: bool,
+    /// Custom header text to prepend to generated files (default: None)
+    pub custom_header: Option<String>,
 }
 
 impl Default for CppOptions {
@@ -92,6 +94,7 @@ impl Default for CppOptions {
             emit_root_aliases: true,
             emit_cmake: false,
             emit_meson: false,
+            custom_header: None,
         }
     }
 }
@@ -247,9 +250,16 @@ impl CppCodegen {
     /// Generate complete header-only source (`.hpp`).
     pub fn generate_header(&self, ir: &SchemaIR) -> String {
         let mut out = String::new();
+        if let Some(ref header) = self.options.custom_header {
+            let trimmed = header.trim();
+            if !trimmed.is_empty() {
+                out.push_str(trimmed);
+                out.push_str("\n\n");
+            }
+        }
         writeln!(
             out,
-            "// Generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)"
+            "// @generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)"
         )
         .unwrap();
         writeln!(out, "// Target: Modern C++20/C++23 (Header-Only)").unwrap();
@@ -277,9 +287,16 @@ impl CppCodegen {
     /// Generate complete C++20 module interface unit (`.cppm`).
     pub fn generate_module_unit(&self, ir: &SchemaIR, module_name: &str) -> String {
         let mut out = String::new();
+        if let Some(ref header) = self.options.custom_header {
+            let trimmed = header.trim();
+            if !trimmed.is_empty() {
+                out.push_str(trimmed);
+                out.push_str("\n\n");
+            }
+        }
         writeln!(
             out,
-            "// Generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)"
+            "// @generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)"
         )
         .unwrap();
         writeln!(out, "// Target: Modern C++20/C++23 Module Interface Unit").unwrap();

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/src/codegen/csharp/mod.rs

@@ -55,6 +55,8 @@ pub struct CSharpOptions {
     pub use_file_scoped_namespaces: bool,
     /// Emit root element wrapper records or aliases
     pub emit_root_records: bool,
+    /// Custom header text to prepend to generated files
+    pub custom_header: Option<String>,
 }
 
 impl Default for CSharpOptions {
@@ -69,6 +71,7 @@ impl Default for CSharpOptions {
             record_kind: CSharpRecordKind::Class,
             use_file_scoped_namespaces: true,
             emit_root_records: true,
+            custom_header: None,
         }
     }
 }
@@ -233,7 +236,19 @@ impl CSharpCodegen {
     pub fn generate_module(&self, ir: &SchemaIR) -> String {
         let mut out = String::new();
 
+        if let Some(ref header) = self.options.custom_header {
+            let trimmed = header.trim();
+            if !trimmed.is_empty() {
+                out.push_str(trimmed);
+                out.push_str("\n\n");
+            }
+        }
         writeln!(out, "// <auto-generated/>").unwrap();
+        writeln!(
+            out,
+            "// @generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)"
+        )
+        .unwrap();
         writeln!(out, "#nullable enable\n").unwrap();
         writeln!(out, "using System;").unwrap();
         writeln!(out, "using System.Collections.Generic;").unwrap();
@@ -376,8 +391,8 @@ impl CSharpCodegen {
         if self.options.emit_json_attributes {
             writeln!(
                 out,
-                "{}[JsonConverter(typeof(JsonStringEnumConverter))]",
-                indent
+                "{}[JsonConverter(typeof(JsonStringEnumConverter<{}>))]",
+                indent, enum_name
             )
             .unwrap();
         }
@@ -654,7 +669,7 @@ impl CSharpCodegen {
                 || f.nillable
                 || (f.cardinality.is_list() && f.cardinality.min_occurs == 0);
             let default_arg = if is_opt {
-                "default".to_string()
+                format!("default({})", field_type)
             } else {
                 format!("default({})!", field_type)
             };

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/src/codegen/go/mod.rs

@@ -49,6 +49,8 @@ pub struct GoOptions {
     pub validate_facets: bool,
     /// Emit top-level type aliases for root elements (default: true)
     pub emit_root_aliases: bool,
+    /// Custom header text to prepend to generated files (default: None)
+    pub custom_header: Option<String>,
 }
 
 impl Default for GoOptions {
@@ -61,6 +63,7 @@ impl Default for GoOptions {
             validate_choice_exclusivity: true,
             validate_facets: true,
             emit_root_aliases: true,
+            custom_header: None,
         }
     }
 }
@@ -286,11 +289,23 @@ impl GoCodegen {
 
         // Assemble final output with package and imports
         let mut out = String::new();
+        if let Some(ref header) = self.options.custom_header {
+            let trimmed = header.trim();
+            if !trimmed.is_empty() {
+                out.push_str(trimmed);
+                out.push_str("\n\n");
+            }
+        }
         writeln!(
             out,
             "// Code generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML). DO NOT EDIT."
         )
         .unwrap();
+        writeln!(
+            out,
+            "// @generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)\n"
+        )
+        .unwrap();
 
         let pkg = to_go_package_name(&self.options.package_name);
         writeln!(out, "package {}\n", pkg).unwrap();

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/src/codegen/java/mod.rs

@@ -47,6 +47,8 @@ pub struct JavaOptions {
     pub validate_facets: bool,
     /// Emit top-level aliases for root elements (default: true)
     pub emit_root_aliases: bool,
+    /// Custom header text to prepend to generated files (default: None)
+    pub custom_header: Option<String>,
 }
 
 impl Default for JavaOptions {
@@ -57,6 +59,7 @@ impl Default for JavaOptions {
             use_records: true,
             validate_facets: true,
             emit_root_aliases: true,
+            custom_header: None,
         }
     }
 }
@@ -270,7 +273,14 @@ impl JavaCodegen {
     }
 
     fn emit_file_header(&self, out: &mut String) {
-        out.push_str("// Generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)\n");
+        if let Some(ref header) = self.options.custom_header {
+            let trimmed = header.trim();
+            if !trimmed.is_empty() {
+                out.push_str(trimmed);
+                out.push_str("\n\n");
+            }
+        }
+        out.push_str("// @generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)\n");
         if self.options.backend.is_jackson() {
             out.push_str("// Target: Java 21+ (Records, Jackson XML/JSON Annotations)\n\n");
         } else {

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/src/codegen/python/mod.rs

@@ -39,6 +39,7 @@ pub struct PythonOptions {
     pub emit_root_aliases: bool,
     pub emit_codecs: bool,
     pub emit_json_metadata: bool,
+    pub custom_header: Option<String>,
 }
 
 impl Default for PythonOptions {
@@ -52,6 +53,7 @@ impl Default for PythonOptions {
             emit_root_aliases: true,
             emit_codecs: true,
             emit_json_metadata: true,
+            custom_header: None,
         }
     }
 }
@@ -199,7 +201,26 @@ impl PythonCodegen {
     pub fn generate_module(&self, ir: &SchemaIR) -> String {
         let mut out = String::new();
 
-        out.push_str("# Generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)\n");
+        if let Some(ref header) = self.options.custom_header {
+            let trimmed = header.trim();
+            if !trimmed.is_empty() {
+                for line in trimmed.lines() {
+                    let line_trimmed = line.trim_start();
+                    if line_trimmed.starts_with("//") {
+                        let content = line_trimmed.strip_prefix("//").unwrap_or("");
+                        out.push('#');
+                        out.push_str(content);
+                        out.push('\n');
+                    } else {
+                        out.push_str(line);
+                        out.push('\n');
+                    }
+                }
+                out.push('\n');
+            }
+        }
+
+        out.push_str("# @generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)\n");
         out.push_str("from __future__ import annotations\n\n");
 
         self.emit_imports(&mut out, ir);

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/src/codegen/rust/mod.rs

@@ -27,6 +27,8 @@ pub struct RustOptions {
     pub emit_codecs: bool,
     /// Derive rkyv::{Archive, Serialize, Deserialize} zero-copy wire format serialization (default: false).
     pub emit_rkyv: bool,
+    /// Custom header text to prepend to generated files (default: None).
+    pub custom_header: Option<String>,
 }
 
 impl Default for RustOptions {
@@ -39,6 +41,7 @@ impl Default for RustOptions {
             emit_root_aliases: true,
             emit_codecs: true,
             emit_rkyv: false,
+            custom_header: None,
         }
     }
 }
@@ -202,7 +205,15 @@ impl RustCodegen {
     pub fn generate_module(&self, ir: &SchemaIR) -> String {
         let mut out = String::new();
 
-        out.push_str("// Generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)\n");
+        if let Some(ref header) = self.options.custom_header {
+            let trimmed = header.trim();
+            if !trimmed.is_empty() {
+                out.push_str(trimmed);
+                out.push_str("\n\n");
+            }
+        }
+
+        out.push_str("// @generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)\n");
         out.push_str(
             "#![allow(dead_code, unused_imports, unused_mut, unused_variables, non_camel_case_types, non_snake_case)]\n\n",
         );

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/src/codegen/typescript/mod.rs

@@ -49,6 +49,8 @@ pub struct TypeScriptOptions {
     pub readonly_fields: bool,
     /// Emit type aliases for top-level root XML elements (default: true)
     pub emit_root_aliases: bool,
+    /// Custom header text to prepend to generated files (default: None)
+    pub custom_header: Option<String>,
 }
 
 impl TypeScriptOptions {
@@ -71,6 +73,7 @@ impl Default for TypeScriptOptions {
             use_interface: true,
             readonly_fields: false,
             emit_root_aliases: true,
+            custom_header: None,
         }
     }
 }
@@ -236,8 +239,15 @@ impl TypeScriptCodegen {
     }
 
     fn emit_header(&self, out: &mut String, ir: &SchemaIR) {
+        if let Some(ref header) = self.options.custom_header {
+            let trimmed = header.trim();
+            if !trimmed.is_empty() {
+                out.push_str(trimmed);
+                out.push_str("\n\n");
+            }
+        }
         out.push_str("/**\n");
-        out.push_str(" * Generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)\n");
+        out.push_str(" * @generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)\n");
         out.push_str(" * Target: TypeScript 5+\n");
         if let Some(ref ns) = ir.target_namespace {
             let _ = writeln!(out, " * Target Namespace: {}", ns);

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/tests/test_cpp_codegen.rs

@@ -162,6 +162,7 @@ fn test_cpp_struct_and_enum_codegen_compilation() {
         emit_root_aliases: true,
         emit_cmake: false,
         emit_meson: false,
+        custom_header: None,
     };
 
     let codegen = CppCodegen::new(options);

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/tests/test_csharp_codegen.rs

@@ -180,7 +180,7 @@ fn test_csharp_records_and_enums_generation() {
 
     assert!(cs_code.contains("using System.Text.Json.Serialization;"));
     assert!(cs_code.contains("namespace Crm.Models;"));
-    assert!(cs_code.contains("[JsonConverter(typeof(JsonStringEnumConverter))]"));
+    assert!(cs_code.contains("[JsonConverter(typeof(JsonStringEnumConverter<OrderStatus>))]"));
     assert!(cs_code.contains("public enum OrderStatus"));
     assert!(cs_code.contains("[XmlEnum(\"pending\")]"));
     assert!(cs_code.contains("Pending,"));

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/tests/test_go_codegen.rs

@@ -163,6 +163,7 @@ fn test_go_struct_and_enum_generation() {
         validate_choice_exclusivity: true,
         validate_facets: true,
         emit_root_aliases: true,
+        custom_header: None,
     };
 
     let codegen = GoCodegen::new(options);
@@ -347,6 +348,7 @@ fn test_go_choice_mutual_exclusivity() {
         validate_choice_exclusivity: true,
         validate_facets: true,
         emit_root_aliases: true,
+        custom_header: None,
     };
 
     let codegen = GoCodegen::new(options);

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/tests/test_java_codegen.rs

@@ -158,6 +158,7 @@ fn test_java_records_and_enums_generation() {
         use_records: true,
         validate_facets: true,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = JavaCodegen::new(options);
     let files = codegen.generate_files(&ir);
@@ -245,6 +246,7 @@ fn test_java_sealed_interface_choice() {
         use_records: true,
         validate_facets: true,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = JavaCodegen::new(options);
     let files = codegen.generate_files(&ir);
@@ -298,6 +300,7 @@ fn test_java_module_container_class() {
         use_records: true,
         validate_facets: true,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = JavaCodegen::new(options);
     let code = codegen.generate_module(&ir, "BankingModels");
@@ -407,6 +410,7 @@ fn test_java_jackson_backend_struct_annotations() {
         use_records: true,
         validate_facets: true,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = JavaCodegen::new(options);
     let files = codegen.generate_files(&ir);
@@ -467,6 +471,7 @@ fn test_java_jackson_backend_enum_annotations() {
         use_records: true,
         validate_facets: true,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = JavaCodegen::new(options);
     let files = codegen.generate_files(&ir);
@@ -514,6 +519,7 @@ fn test_java_jackson_backend_union_annotations() {
         use_records: true,
         validate_facets: true,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = JavaCodegen::new(options);
     let files = codegen.generate_files(&ir);
@@ -555,6 +561,7 @@ fn test_java_jackson_backend_simple_type_annotations() {
         use_records: true,
         validate_facets: true,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = JavaCodegen::new(options);
     let files = codegen.generate_files(&ir);

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/tests/test_python_codegen.rs

@@ -127,6 +127,7 @@ fn test_python_dataclass_codegen() {
         emit_root_aliases: true,
         emit_codecs: true,
         emit_json_metadata: true,
+        custom_header: None,
     });
 
     let code = codegen.generate_module(&ir);
@@ -222,6 +223,7 @@ fn test_python_pydantic_codegen_with_facets() {
         emit_root_aliases: true,
         emit_codecs: true,
         emit_json_metadata: true,
+        custom_header: None,
     });
 
     let code = codegen.generate_module(&ir);
@@ -399,3 +401,36 @@ fn test_python_codecs_generation() {
     assert!(!code_disabled.contains("def from_json("));
     assert!(!code_disabled.contains("def to_json("));
 }
+
+#[test]
+fn test_python_generated_tag_and_custom_header() {
+    let mut ir = SchemaIR::new();
+    ir.add_type(TypeDef::Struct(StructDef {
+        qname: QName::local("Item"),
+        base_type: None,
+        is_abstract: false,
+        fields: vec![FieldDef::new(
+            "name",
+            "name",
+            FieldKind::Element,
+            TypeRef::Primitive(PrimitiveType::String),
+        )],
+        documentation: None,
+    }));
+
+    // Without custom header: emits default @generated tag
+    let default_codegen = PythonCodegen::new(PythonOptions::default());
+    let default_code = default_codegen.generate_module(&ir);
+    assert!(default_code
+        .contains("# @generated by PolyXML Compiler (https://github.com/nth-bailey/PolyXML)"));
+    assert!(default_code.contains("from __future__ import annotations"));
+
+    // With custom header: prepends custom header
+    let custom_codegen = PythonCodegen::new(PythonOptions {
+        custom_header: Some("# ruff: noqa\n# mypy: ignore-errors".into()),
+        ..Default::default()
+    });
+    let custom_code = custom_codegen.generate_module(&ir);
+    assert!(custom_code
+        .starts_with("# ruff: noqa\n# mypy: ignore-errors\n\n# @generated by PolyXML Compiler"));
+}

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/tests/test_rust_codegen.rs

@@ -134,6 +134,7 @@ fn test_rust_zero_copy_codegen() {
         emit_root_aliases: true,
         emit_codecs: false,
         emit_rkyv: false,
+        custom_header: None,
     });
 
     let code = codegen.generate_module(&ir);
@@ -185,6 +186,7 @@ fn test_rust_owned_codegen() {
         emit_root_aliases: true,
         emit_codecs: false,
         emit_rkyv: false,
+        custom_header: None,
     });
 
     let code = codegen.generate_module(&ir);

{polyxml-0.18.0 → polyxml-0.19.1}/crates/polyxml-core/tests/test_ts_codegen.rs

@@ -144,6 +144,7 @@ fn test_ts_interface_and_enum_codegen() {
         use_interface: true,
         readonly_fields: false,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = TypeScriptCodegen::new(options);
     let code = codegen.generate_module(&ir);
@@ -199,6 +200,7 @@ fn test_ts_discriminated_union_choice() {
         use_interface: true,
         readonly_fields: true,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = TypeScriptCodegen::new(options);
     let code = codegen.generate_module(&ir);
@@ -285,6 +287,7 @@ fn test_ts_zod_schema_generation() {
         use_interface: true,
         readonly_fields: false,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = TypeScriptCodegen::new(options);
     let code = codegen.generate_module(&ir);
@@ -352,6 +355,7 @@ fn test_ts_recursive_cycle_zod_lazy() {
         use_interface: true,
         readonly_fields: false,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = TypeScriptCodegen::new(options);
     let code = codegen.generate_module(&ir);
@@ -488,6 +492,7 @@ fn test_ts_valibot_schema_generation() {
         use_interface: true,
         readonly_fields: false,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = TypeScriptCodegen::new(options);
     let code = codegen.generate_module(&ir);
@@ -585,6 +590,7 @@ fn test_ts_typebox_schema_generation() {
         use_interface: true,
         readonly_fields: false,
         emit_root_aliases: true,
+        custom_header: None,
     };
     let codegen = TypeScriptCodegen::new(options);
     let code = codegen.generate_module(&ir);

{polyxml-0.18.0 → polyxml-0.19.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "polyxml"
-version = "0.18.0"
+version = "0.19.1"
 description = "High-performance, polyglot XML data-binding engine built in Rust"
 authors = [
     { name = "Bailey Nguyen", email = "bailey.tan.nguyen@gmail.com" }