1 unstable release
Uses old Rust 2015
0.1.0 | Oct 26, 2017 |
---|
#2109 in Asynchronous
17KB
169 lines
mercury-rs
The official Rust client for the Mercury Parser.
With just one API request, Mercury takes any web article and returns only the relevant content — headline, author, body text, relevant images and more — free from any clutter. It’s reliable, easy-to-use and free.
Installation
The examples in this document assume you already have a Mercury Parser API key. If you do not already have one, you can sign up here.
Add this to your Cargo.toml
:
[dependencies]
futures = "0.1"
mercury = "0.1"
tokio-core = "0.1"
Add this to your main.rs
:
extern crate futures;
extern crate mercury;
extern crate tokio_core;
Usage
// Create a new event loop with tokio.
let mut core = Core::new()?;
// Load your API key from the environment.
let key = env::var("MERCURY_API_KEY")?;
// Pass a handle to the event loop and the API key to the Mercury constructor.
let client = Mercury::new(&core.handle(), key)?;
// The parse method returns a Future that will resolve to a parsed Article.
let resp = client.parse("https://example.com").inspect(|article| {
println!("{:#?}", article);
});
// Block the current thread until the future completes.
core.run(resp)?;
Additional examples can be found here.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (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.
Dependencies
~12–22MB
~307K SLoC