Visdom
API Document Online Demos Performance 中文 API 文档 更新文档
It's not only helpful for the working with html scraping, but also have useful APIs to mutate text nodes, so you can use it for mixing your html with dirty html fragement, and keep the web scrapers away.
Usage
use visdom::Vis;
use visdom::types::BoxDynError;
fn main() -> Result<(), BoxDynError>{
let html = r##"
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
</head>
<body>
<nav id="header">
<ul>
<li>Hello,</li>
<li>Vis</li>
<li>Dom</li>
</ul>
</nav>
</body>
</html>
"##;
// load html
let root = Vis::load(html)?;
let lis = root.find("#header li");
let lis_text = lis.text();
println!("{}", lis_text);
// will output "Hello,VisDom"
Ok(())
}Feature flags
After version v0.5.0, visdom add some feature flags to support conditional compilation for different usage.
| Feature | Description | API | Config |
|---|---|---|---|
destory |
When you don't need remove or clear the elements, you can ignore this feature flag. | .remove() .empty() (IElementTrait) remove_child() |
visdom = { version = xxx, features = ["destory"]} |
insertion |
When you don't need mutation the DOM, you can ignore this feature flag. | append() append_to() prepend() prepend_to() insert_after() after() insert_before() before() replace_with() |
visdom = { version = xxx, features = ["insertion"]} |
text |
When you don't need mutation the TextNode, you can ignore this feature flag. | .texts() .texts_by() texts_by_rec() |
visdom = { version = xxx, features = ["text"]} |
full |
When you need all the API above, you can open this feature flag. | - | visdom = { version = xxx, features = ["full"]} |
Depedencies
- Html parser：https://github.com/fefit/rphtml
- Html entity encoding and decoding：https://github.com/fefit/htmlentity
Questions & Advices & Bugs?
Welcome to report Issue to us if you have any question or bug or good advice.