1 unstable release
0.2.0 | Sep 21, 2022 |
---|
#100 in #writer
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:
- add log4rs support
Example
use xml_doc_log4rs::{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
~6MB
~169K SLoC