fast_scraper

HTML parsing and querying with CSS selectors.

fast_scraper is on Crates.io and GitHub.

Scraper provides an interface to Servo's html5ever and selectors crates, for browser-grade parsing and querying.

Examples

Parsing a document

```rust use fast_scraper::Html;

let html = r#"

Hello, world!

let document = Html::parse_document(html); ```

Parsing a fragment

rust use fast_scraper::Html; let fragment = Html::parse_fragment("<h1>Hello, <i>world!</i></h1>");

Parsing a selector

rust use fast_scraper::Selector; let selector = Selector::parse("h1.foo").unwrap();

Selecting elements

```rust use fast_scraper::{Html, Selector};

let html = r#"

• Foo
• Bar
• Baz

let fragment = Html::parse_fragment(html); let selector = Selector::parse("li").unwrap();

for element in fragment.select(&selector) { assert_eq!("li", element.value().name()); } ```

Selecting descendent elements

```rust use fast_scraper::{Html, Selector};

let html = r#"

• Foo
• Bar
• Baz

let fragment = Html::parsefragment(html); let ulselector = Selector::parse("ul").unwrap(); let li_selector = Selector::parse("li").unwrap();

let ul = fragment.select(&ulselector).next().unwrap(); for element in ul.select(&liselector) { assert_eq!("li", element.value().name()); } ```

Accessing element attributes

```rust use fast_scraper::{Html, Selector};

let fragment = Html::parse_fragment(r#""#); let selector = Selector::parse(r#"input[name="foo"]"#).unwrap();

let input = fragment.select(&selector).next().unwrap(); assert_eq!(Some("bar"), input.value().attr("value")); ```

Serializing HTML and inner HTML

```rust use fast_scraper::{Html, Selector};

let fragment = Html::parse_fragment("

Hello, world!

let h1 = fragment.select(&selector).next().unwrap();

asserteq!("

Hello, world!

Accessing descendent text

```rust use fast_scraper::{Html, Selector};

let fragment = Html::parse_fragment("

Hello, world!

let h1 = fragment.select(&selector).next().unwrap(); let text = h1.text().collect::>();

assert_eq!(vec!["Hello, ", "world!"], text); ```

Contributing

Please feel free to open pull requests. If you're planning on implementing something big (i.e. not fixing a typo, a small bug fix, minor refactor, etc) then please open an issue first.