1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107
//! Efficient tokens for `rcdom::RcDom` `Handle` parsing
//! aiming for O(1) HTML DOM walking.
//!
//! This library aims to provide convenient and efficient handling of
//! HTML DOM elements.
//!
//! ## Examples
//!
//!```
//! extern crate toks;
//! #[macro_use]
//! extern crate html5ever;
//!
//! use toks::prelude::*;
//! use std::io::{self, Read};
//!
//! pub struct LinkTok {
//! total: u32,
//! }
//!
//! impl Tok for LinkTok {
//! fn is_match(&self, qn: &QualName) -> bool {
//! qn.local == local_name!("a")
//! }
//!
//! fn process(&mut self, _: &mut Vec<Attribute>, _: &mut Vec<Handle>) {
//! self.total += 1;
//! }
//! }
//!
//! // How to use
//! // $ cargo build --example count_links
//! // $ cat your.html | ./target/debug/examples/count_links
//! // Link <a> count 9
//! fn main() {
//! let mut chunk = String::new();
//! io::stdin().read_to_string(&mut chunk).unwrap();
//!
//! let dom = parse_document(RcDom::default(), Default::default()).one(chunk);
//!
//! let mut lt = LinkTok { total: 0 };
//!
//! // Dropping mut reference
//! {
//! recursion(&mut vec![&mut lt], dom.document);
//! }
//!
//! println!("Link <a> count {}", lt.total);
//! }
//!```
#![deny(
warnings,
bad_style,
dead_code,
improper_ctypes,
non_shorthand_field_patterns,
no_mangle_generic_items,
overflowing_literals,
path_statements,
patterns_in_fns_without_body,
private_in_public,
unconditional_recursion,
unused,
unused_allocation,
unused_comparisons,
unused_parens,
while_true,
missing_debug_implementations,
missing_docs,
trivial_numeric_casts,
unused_extern_crates,
unused_import_braces,
unused_qualifications,
unused_results,
trivial_numeric_casts,
unreachable_pub,
unused_extern_crates,
unused_import_braces,
unused_qualifications,
unused_results,
deprecated,
unconditional_recursion,
unknown_lints,
unreachable_code,
unused_mut
)]
mod tok;
mod toks;
pub use crate::toks::{recursion, Toks};
pub use tok::Tok;
/// Prelude module contains several important traits that provide many
/// of the convenience imports in advance.
pub mod prelude {
pub use html5ever;
#[doc(no_inline)]
pub use html5ever::interface::Attribute;
pub use html5ever::tendril::TendrilSink;
pub use html5ever::{parse_document, QualName};
pub use markup5ever_rcdom::{Handle, NodeData, RcDom};
pub use std::cell::RefCell;
// Re-export
pub use crate::{recursion, Tok, Toks};
}