f87e2442d4
This way we don't need to reimplement PartialEq for Element. It's also way easier to get an attribute by name as we don't need to iterate over every attribute to see if it exists. The only side effect is that now, in the Debug output, attributes are automatically sorted by names instead of being sorted by insertion order. Fixes #4
77 lines
1.9 KiB
Rust
77 lines
1.9 KiB
Rust
#![deny(missing_docs)]
|
|
|
|
//! A minimal DOM crate built on top of xml-rs.
|
|
//!
|
|
//! This library exports an `Element` struct which represents a DOM tree.
|
|
//!
|
|
//! # Example
|
|
//!
|
|
//! Run with `cargo run --example articles`. Located in `examples/articles.rs`.
|
|
//!
|
|
//! ```rust,ignore
|
|
//! 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. <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`:
|
|
//!
|
|
//! ```toml,ignore
|
|
//! minidom = "*"
|
|
//! ```
|
|
|
|
extern crate xml;
|
|
|
|
pub mod error;
|
|
pub mod element;
|
|
pub mod convert;
|
|
|
|
#[cfg(test)] mod tests;
|
|
|
|
pub use error::Error;
|
|
pub use element::{Element, Node, Children, ChildrenMut, ElementBuilder};
|
|
pub use convert::{IntoElements, IntoAttributeValue};
|