no_browser 0.4.0

a light-weight, head-less 'web browser' based on reqwest
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

#![deny(unsafe_code)]
#![deny(missing_docs)]
#![deny(missing_debug_implementations)]
#![cfg_attr(test, deny(warnings))]

//! # no_browser
//!
//! The `no_browser` crate strives to provide a high-level API for programmatically interacting with web pages through
//! a _light-weight, head-less "web browser"_. This is not a real web browser, like Firefox or Chrome.
//!
//! `no_browser` builds on top of [reqwest](https://crates.io/crates/reqwest) handling http requests, http redirects and
//! cookie management, as well as, [scraper](https://crates.io/crates/scraper) parsing html code. This crate uses
//! [CSS selectors](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors) to freely access any element of a
//! given web page. It also provides its own abstraction to fill out and submit web forms.
//!
//! However, `no_browser` has no support for client-side JavaScript or any concept of actually rendering web pages. So if
//! you want to test modern JavaScript-driven web apps, opt for a crate driving a real web browser like
//! [fantoccini](https://crates.io/crates/fantoccini) or [thirtyfour](https://crates.io/crates/thirtyfour), instead.
//!
//! ## Example
//!
//! ```rust
//! # // Skip doctest when executed by Docs.rs (because we have no network access)
//! # if std::env::var("DOCS_RS").is_ok() {
//! #     return Ok::<(), no_browser::browser::Error>(());
//! # }
//! #
//! # use no_browser::Browser;
//! # use no_browser::Result;
//! # use no_browser::InputType;
//! #
//! let browser = Browser::builder().finish()?;
//!
//! // Lets go to the Wikipedia main page
//! let mut page = browser.navigate_to("https://en.wikipedia.org/", None)?;
//!
//! // the title tag should be "Wikipedia, the free encyclopedia"
//! assert_eq!(
//!     page.select_first("head > title")?.inner_html(),
//!     "Wikipedia, the free encyclopedia"
//! );
//!
//! // the main page should welcome us
//! assert!(page
//!     .select_first("div.mw-heading > h1")?
//!     .inner_html()
//!     .starts_with("Welcome to"));
//!
//! // fill out the search form ...
//! let search_form = page.form_by_id_mut("searchform")?;
//! search_form
//!     .input_mut(InputType::Search, "search")?
//!     .set_value(Some("rust programming language".to_owned()));
//!
//! // ... and submit
//! let page = browser.submit_form(search_form, None)?;
//!
//! // the new title tag should be "Rust (programming language) - Wikipedia"
//! assert_eq!(
//!     page.select_first("head > title")?.inner_html(),
//!     "Rust (programming language) - Wikipedia"
//! );
//!
//! // The main title on the html page should be quite similar
//! assert_eq!(
//!     page.select_first("span.mw-page-title-main")?.inner_html(),
//!     "Rust (programming language)"
//! );
//!
//! // The main title should have a subtitle showing we've been redirected
//! assert!(page
//!     .select_first("div#contentSub span.mw-redirectedfrom")?
//!     .inner_html()
//!     .starts_with("(Redirected from"));
//!
//! // The table of contents should have more than 10 entries
//! assert!(page
//!     .select("div#vector-toc ul#mw-panel-toc-list li.vector-toc-list-item")?
//!     .len() > 10);
//!
//! # Ok::<(), no_browser::browser::Error>(())
//! ```

pub mod browser;
pub mod form;
pub mod input;
pub mod page;

pub use browser::Browser;
pub use browser::Result;
pub use input::InputType;