Crate magnesium

This crate provides very a simplistic iterator for stepping over XML data.

Only requires core, doesn’t allocate, doesn’t use unsafe.

The processing is quite simplistic, and the iterator will simply fail and end the iteration if there’s a problem. This doesn’t do any special character replacement for you.

The crate is intended for when you have a fairly basic XML file that is assumed to be “non-hostile”, and you just need to walk through and scrape the data. For example, when parsing gl.xml or vk.xml.

Example Usage

use magnesium::*;

let xml_string = r#"
  <?xml version="1.0" encoding="UTF-8"?>
  <!-- just imagine we had a whole file here -->
  <registry>
    <enums namespace="Graphics" group="Polygon">
      <enum value="0" name="GRAPHICS_POINTS"/>
      <enum value="1" name="GRAPHICS_LINES"/>
    </enums>
  </registry>
"#;

for element in ElementIterator::new(xml_string) {
  println!("{:?}", element);
}

Structs

ElementIterator

An iterator to walk the elements of some XML data.

TagAttribute

The output of a TagAttributeIterator.

TagAttributeIterator

Iterator to walk through a Start or Empty tag’s attribute string.

Enums

XmlElement

An element within an XML structure.

Functions

skip_comments

Filters out XmlElement::Comment(_).

skip_empty_text_elements

Filters out XmlElement::Text(t) when t is only whitespace.

trim_text

Applies str::trim to a Text element. No effect otherwise.