, } #[derive(FromHtml, Debug, Eq, PartialEq)] pub struct Article { #[h2s(select = "h2 > a")] title: String, #[h2s(select = "div > span")] view_count: usize, #[h2s(select = "h2 > a", attr = "href")] url: String, #[h2s(select = "ul > li")] tags: Vec, #[h2s(select = "ul > li:nth-child(1)")] first_tag: Option, } let html = r#"

My tech blog

article1

901 Views

Tag1
Tag2

article2

849 Views

article3

103 Views

Tag3

"#; let page = h2s::parse::(html).unwrap(); assert_eq!(page, Page { lang: "en".to_string(), blog_title: "My tech blog".to_string(), articles: vec![ Article { title: "article1".to_string(), url: "https://example.com/1".to_string(), view_count: 901, tags: vec!["Tag1".to_string(), "Tag2".to_string()], first_tag: Some("Tag1".to_string()), }, Article { title: "article2".to_string(), url: "https://example.com/2".to_string(), view_count: 849, tags: vec![], first_tag: None, }, Article { title: "article3".to_string(), url: "https://example.com/3".to_string(), view_count: 103, tags: vec!["Tag3".to_string()], first_tag: Some("Tag3".to_string()), }, ] }); // When the input HTML document structure does not match the expected, // `h2s::parse` will return an error with a detailed reason. let invalid_html = html.replace(r#"article3"#, ""); let err = h2s::parse::(invalid_html).unwrap_err(); assert_eq!( err.to_string(), "articles: [2]: title: mismatched number of selected elements by \"h2 > a\": expected exactly one element, but no elements found" ); ``` ## Supported types You can use the following types as a field value of the struct to parse. ### Basic types - `String` - Numeric types ( `usize`, `i64`, `NonZeroU32`, ... ) - And more built-in supported types ([List](./core/src/parseable.rs)) - Or you can use any types by implementing yourself ([Example](./examples/custom_field_value.rs)) ### Container types (where `T` is a basic type) - `[T;N]` - `Option` - `Vec` ## License MIT