2020-02-14 23:40:38 +00:00
|
|
|
// Copyright (c) 2020 lumi <lumi@pew.im>
|
|
|
|
|
// Copyright (c) 2020 Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
|
|
|
|
|
// Copyright (c) 2020 Bastien Orivel <eijebong+minidom@bananium.fr>
|
|
|
|
|
// Copyright (c) 2020 Astro <astro@spaceboyz.net>
|
|
|
|
|
// Copyright (c) 2020 Maxime “pep” Buquet <pep@bouah.net>
|
|
|
|
|
//
|
|
|
|
|
// This Source Code Form is subject to the terms of the Mozilla Public
|
|
|
|
|
// License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
|
|
|
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
|
|
|
|
2017-03-08 19:34:17 +00:00
|
|
|
#![deny(missing_docs)]
|
|
|
|
|
|
2018-06-23 12:06:18 +00:00
|
|
|
//! A minimal DOM crate built on top of quick-xml.
|
2017-02-21 14:46:06 +00:00
|
|
|
//!
|
|
|
|
|
//! 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
|
|
|
|
|
//!
|
2017-02-25 14:43:56 +00:00
|
|
|
//! To use `minidom`, add this to your `Cargo.toml` under `dependencies`:
|
2017-02-21 14:46:06 +00:00
|
|
|
//!
|
|
|
|
|
//! ```toml,ignore
|
2017-02-25 14:43:56 +00:00
|
|
|
//! minidom = "*"
|
2017-02-21 14:46:06 +00:00
|
|
|
//! ```
|
|
|
|
|
|
2019-10-15 21:50:57 +00:00
|
|
|
pub use quick_xml;
|
2017-02-19 19:46:44 +00:00
|
|
|
|
2017-03-08 19:34:17 +00:00
|
|
|
pub mod convert;
|
2019-10-22 23:32:41 +00:00
|
|
|
pub mod element;
|
|
|
|
|
pub mod error;
|
2017-08-13 15:29:38 +00:00
|
|
|
mod namespace_set;
|
2019-10-22 23:32:41 +00:00
|
|
|
pub mod node;
|
2017-02-19 19:46:44 +00:00
|
|
|
|
2019-10-22 23:32:41 +00:00
|
|
|
#[cfg(test)]
|
|
|
|
|
mod tests;
|
2017-02-19 19:46:44 +00:00
|
|
|
|
2019-10-22 23:32:41 +00:00
|
|
|
pub use convert::IntoAttributeValue;
|
|
|
|
|
pub use element::{Children, ChildrenMut, Element, ElementBuilder};
|
2018-02-18 18:54:09 +00:00
|
|
|
pub use error::{Error, Result};
|
2019-11-09 00:33:46 +00:00
|
|
|
pub use namespace_set::NSChoice;
|
2018-12-23 14:59:13 +00:00
|
|
|
pub use node::Node;
|
