Crate minidom

Expand description

A minimal DOM crate built on top of rxml, targeting exclusively the subset of XML useful for XMPP.

This library exports an Element struct which represents a DOM tree.

§Example

Run with cargo run --example articles. Located in examples/articles.rs.

extern crate minidom;

use minidom::Element;

const DATA: &'static str = r#"<articles xmlns="article">
    <article>
        <title>10 Terrible Bugs You Would NEVER Believe Happened</title>
        <body>
            Rust fixed them all. &lt;3
        </body>
    </article>
    <article>
        <title>BREAKING NEWS: Physical Bug Jumps Out Of Programmer's Screen</title>
        <body>
            Just kidding!
        </body>
    </article>
</articles>"#;

const ARTICLE_NS: &'static str = "article";

#[derive(Debug)]
pub struct Article {
    title: String,
    body: String,
}

fn main() {
    let root: Element = DATA.parse().unwrap();

    let mut articles: Vec<Article> = Vec::new();

    for child in root.children() {
        if child.is("article", ARTICLE_NS) {
            let title = child.get_child("title", ARTICLE_NS).unwrap().text();
            let body = child.get_child("body", ARTICLE_NS).unwrap().text();
            articles.push(Article {
                title: title,
                body: body.trim().to_owned(),
            });
        }
    }

    println!("{:?}", articles);
}

§Usage

To use minidom, add this to your Cargo.toml under dependencies:

minidom = "*"

Re-exports§

pub use convert::IntoAttributeValue;
pub use element::Children;
pub use element::ChildrenMut;
pub use element::Element;
pub use element::ElementBuilder;
pub use error::Error;
pub use error::Result;
pub use node::Node;

Modules§

convert: A module which exports a few traits for converting types to elements and attributes.
element: Provides an Element type, which represents DOM nodes, and a builder to create them with.
error: Provides an error type for this crate.
node: Provides the Node struct, which represents a node in the DOM.
tree_builder: SAX events to DOM tree conversion

Enums§

NSChoice: Use to compare namespaces