#builder #xml #macro #rss #serde-json

ogrim

XML builder macro letting you write literal XML inside your Rust code (similar to serde_json::json!). Features interpolation, escaping, auto-close tags and minimal memory allocations.

2 releases

0.1.1 Nov 15, 2023
0.1.0 Nov 14, 2023

#672 in Template engine

MIT/Apache

25KB
316 lines

ogrim: macro for building XML from inline XML

CI status of main Crates.io Version docs.rs

XML builder macro letting you write XML inside Rust code (similar to serde_json::json!). Features:

  • Value interpolation (with escaping of course)
    • Interpolate lists or optional attributes with <foo {..iter}>
  • Auto close tags for convenience (e.g. <foo>"body"</>)
  • Minimal memory allocations (only the String being built allocates)
  • Choice between minimized and pretty XML
use ogrim::xml;

let cat_name = "Tony";
let doc = xml!(
    <?xml version="1.0" ?>
    <zoo name="Lorem Ipsum" openingYear={2000 + 13}>
        <cat>{cat_name}</>
        <dog>"Barbara"</>
    </>
);

println!("{}", doc.as_str()); // Print XML

See the documentation for more information and examples.


License

Licensed under either of Apache License, Version 2.0 or MIT license at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~250KB