#xml #xml-parser #writer #reader #parser #reader-writer

xml-doc

Read, modify and write xml in tree-like structure. Supports UTF-16.

3 unstable releases

0.2.0 Oct 12, 2021
0.1.1 Oct 9, 2021
0.1.0 Oct 9, 2021

#106 in #xml-parser

30 downloads per month

MIT/Apache

64KB
1K SLoC

xml-doc

xml-doc is a rust library to read, modify, and write XML documents. Documentation

It's aim is to be able to read any xml files, and modify only the parts you want to.

Features:

  • Supports reading from most encodings, including UTF-16. (With the notable exception of UTF-32)
  • You can have references to the parts of the tree, and still mutate the tree.
  • Elements stores reference to its parent element, so traveling up the tree is fast.
  • One of the fastest XML tree-like parser & writer. See #Performance.
  • Supports attribute value normalization, character/entity references.

Due to its architecture, you can't exchange nodes or elements between documents. If your project modifies multiple xml documents at the same time, this library may not be a good fit.

Example

use xml_doc::{Document, Element};

let XML = r#"<?xml version="1.0"?>
<package xmlns:dc="http://purl.org/dc/elements/1.1/">
    <metadata>
        <dc:title>xml-doc</dc:title>
        <dc:rights>MIT or Apache 2.0</dc:rights>
    </metadata>
</package>
"#;

let doc = Document::parse_str(XML).unwrap();
let package = doc.root_element().unwrap();
let metadata = package.find(&doc, "metadata").unwrap();
let title = metadata.find(&doc, "title").unwrap();
title.set_attribute("xml:lang", "en");

// Add an element to metadata: <dc:creator id="author">Yoonchae Lee</dc:creator>
let author = Element::build(&mut doc, "dc:creator")
    .text_content("Yoonchae Lee")
    .attribute("id", "author")
    .push_to(metadata);

let new_xml = doc.write_str();

Performance

To run benchmark: cd benches ; cargo bench.

Parsing

                  tiny(4.8KB) medium(1.5MB) large(25MB) medium(UTF-16)
xml_doc v0.2.0:     73.79us     29.74ms      341.05ms      29.16ms
minidom v0.12.0:    85.19us     40.09ms      565.04ms
roxmltree v0.14.1:  49.34us     16.33ms      330.90ms
xmltree v0.10.3:  4065.8 us   1204.7 ms    21198.  ms

Only roxmltree which doesn't support writing, is considerably faster than xml_doc. You can see the result of the benchmarks here.

Dependencies

~4.5MB
~140K SLoC