#xml #xml-document #xml-writer

xml-builder

Easy and highly-configurable XML builder/writer

16 releases

0.5.4 Jan 31, 2025
0.5.3 Aug 27, 2024
0.5.2 Mar 19, 2023
0.5.1 Nov 5, 2022
0.2.2 Jul 31, 2021

#171 in Data structures

Download history 913/week @ 2025-03-28 1047/week @ 2025-04-04 1869/week @ 2025-04-11 1119/week @ 2025-04-18 1351/week @ 2025-04-25 1225/week @ 2025-05-02 1375/week @ 2025-05-09 976/week @ 2025-05-16 755/week @ 2025-05-23 636/week @ 2025-05-30 1021/week @ 2025-06-06 948/week @ 2025-06-13 1053/week @ 2025-06-20 877/week @ 2025-06-27 846/week @ 2025-07-04 1155/week @ 2025-07-11

4,101 downloads per month
Used in 23 crates (8 directly)

MIT license

19KB
348 lines

xml-builder

Documentation Latest version dependency status codecov

This crate allows you to easily create an XML file in a short time by building a highly-configurable object tree.

Main advantages

This crate offers many advantages over other XML-building crates :

  • Fast and easy XML documents creation
  • Low size, suits fine for embedeed systems
  • Does not depend on other crates
  • Highly configurable
  • No unsafe code, it integrates the #![forbid(unsafe_code)] lint directive

Main features

Using this crate can bring you many useful features :

  • Element attributes sorting
  • XML indentation, or not
  • Custom XML versions
  • Custom XML encodings

Usage

To use this crate you just need to add this to your Cargo.toml file:

[dependencies]
xml-builder = "*"

Examples

use xml_builder::{XMLBuilder, XMLElement, XMLVersion};

let mut xml = XMLBuilder::new()
    .version(XMLVersion::XML1_1)
    .encoding("UTF-8".into())
    .build();

let mut house = XMLElement::new("house");
house.add_attribute("rooms", "2");

for i in 1..=2 {
    let mut room = XMLElement::new("room");
    room.add_attribute("number", &i.to_string());
    room.add_text(format!("This is room number {}", i)).unwrap();
    house.add_child(room).unwrap();
}

xml.set_root_element(house);

let mut writer: Vec<u8> = Vec::new();
xml.generate(&mut writer).unwrap();

This following XML content will then be displayed:

<?xml encoding="UTF-8" version="1.1"?>
<house rooms="2">
        <room number="1" price="42">This is room number 1</room>
        <room number="2" price="84">This is room number 2</room>
</house>

No runtime deps