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

//! [![Build status](https://img.shields.io/travis/Hexilee/unhtml.rs/master.svg)](https://travis-ci.org/Hexilee/unhtml.rs)
//! [![Crate version](https://img.shields.io/crates/v/unhtml.svg)](https://crates.io/crates/unhtml)
//! [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/Hexilee/unhtml.rs/blob/master/LICENSE)
//! [![Rust Docs](https://docs.rs/unhtml/badge.svg)](https://docs.rs/unhtml)
//!
//! There are two `trait` in crate `unhtml`
//!
//! - `FromHtml`
//!
//! The only method of `FromHtml` you should care about is `fn from_html(html: &str) -> Result<Self, Error>` and this method is implemented for all types implemented `FromStr<E, T>`
//!
//! ```ignore
//! impl<E, T> FromHtml for T
//!     where E: failure::Fail,
//!           T: FromStr<Err=E> {
//!     fn from_html(html: &str) -> Result<Self, Error> {
//!         Ok(T::from_str(html.trim())?)
//!     }
//! }
//! ```
//!
//! You can implement `FromHtml` automatically for `struct` by crate `unhtml_derive`
//! [![Crate version](https://img.shields.io/crates/v/unhtml_derive.svg)](https://crates.io/crates/unhtml_derive)
//!
//! - `VecFromHtml`
//!
//! `VecFromHtml` is implemented for `Vec<T> where T: FromHtml` by default
//!
//! ```ignore
//! impl<T> VecFromHtml for Vec<T>
//!     where T: FromHtml {
//!     type Elem = T;
//! }
//! ```
//!
//! As `FromHtml` is implemented for `u8` by default
//!
//! ```rust
//! use unhtml::scraper::Html;
//! use unhtml::VecFromHtml;
//! let html = Html::parse_fragment(r#"
//! <!DOCTYPE html>
//! <html lang="en">
//! <head>
//!     <meta charset="UTF-8">
//!     <title>Title</title>
//! </head>
//! <body>
//!     <div id="test">
//!         <a href="1"></a>
//!         <a href="2"></a>
//!         <a href="3"></a>
//!     </div>
//! </body>
//! </html>
//! "#);
//! let results = Vec::<u8>::from_attr("#test > a", "href", html.root_element()).unwrap();
//! assert_eq!(1u8, results[0]);
//! assert_eq!(2u8, results[1]);
//! assert_eq!(3u8, results[2]);

#[macro_use]
extern crate failure_derive;

#[cfg(test)]
mod test;
mod err;
mod traits;
mod util;
pub use self::err::*;
pub use self::traits::*;
pub use scraper;
pub use failure;