nipper 0.1.4

HTML manipulation with CSS seletors
Documentation 
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


# Nipper


> Manipulation HTML with CSS Selectors.

<div>
  <!-- Crates version -->
  <a href="https://crates.io/crates/nipper">
    <img src="https://img.shields.io/crates/v/nipper.svg?style=flat-square"

    alt="Crates.io version" />
  </a>
  <!-- Downloads -->
  <a href="https://crates.io/crates/nipper">
    <img src="https://img.shields.io/crates/d/nipper.svg?style=flat-square"

      alt="Download" />
  </a>
  <!-- docs.rs docs -->
  <a href="https://docs.rs/nipper">
    <img src="https://img.shields.io/badge/docs-latest-blue.svg?style=flat-square"

      alt="docs.rs docs" />
  </a>

  <a href="https://travis-ci.com/github/importcjj/nipper">
    <img src="https://travis-ci.com/importcjj/nipper.svg?branch=master" alt="travis ci" />
  </a>
</div>


Nipper based on HTML crate html5ever and the CSS selector crate selectors. You can use the jQuery-like syntax to query and manipulate an HTML document quickly. **Not only can query, but also can modify**.


![nipper-logo](./logo.jpg)

## Example


#### Extract the hacker news.


```rust
use nipper::Document;

let html = include_str!("../test-pages/hacker_news.html");
let document = Document::from(html);

document.select("tr.athing").iter().for_each(|athing| {
    let title = athing.select(".title a");
    let source = title.select(".sitestr");
    // The next sibling.
    let meta = athing.next();
    let score = meta.select("span.score");
    let hnuser = meta.select("a.hnuser");
    let age = meta.select("span.age");
    // The last matched element.
    let comment = meta.select("a").last();

    println!("Title: {}", title.text());
    if source.exists() {
        println!("> from: {}", source.text());
    }
    if score.exists() {
        println!("> {}", score.text());
    }
    if hnuser.exists() {
        println!("> by {}", hnuser.text());
    }
    println!("> {}", age.text());
    println!("> {}", comment.text());
    println!();
});
```

#### Readability. 

[examples/readability.rs](./examples/readability.rs)

## Related projects


* [html5ever](https://crates.io/crates/html5ever)
* [selectors](https://crates.io/crates/selectors)
* [goquery](https://godoc.org/github.com/PuerkitoBio/goquery)
* [scraper](https://crates.io/crates/scraper)
* [select.rs](https://crates.io/crates/select)


## License


Licensed under either of

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

#### Contribution


Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.