https://github.com/neolegends/tokio-request
An asynchronous HTTP client library for Rust
https://github.com/neolegends/tokio-request
Last synced: 12 months ago
JSON representation
An asynchronous HTTP client library for Rust
- Host: GitHub
- URL: https://github.com/neolegends/tokio-request
- Owner: NeoLegends
- License: mit
- Created: 2016-09-06T12:04:35.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-02-19T10:39:13.000Z (over 9 years ago)
- Last Synced: 2025-06-04T19:18:05.551Z (12 months ago)
- Language: Rust
- Homepage:
- Size: 42 KB
- Stars: 13
- Watchers: 1
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tokio-request
[](https://travis-ci.org/NeoLegends/tokio-request)
[](https://github.com/NeoLegends/tokio-request/issies)
[](https://github.com/NeoLegends/tokio-request/issues)
[](https://coveralls.io/github/NeoLegends/tokio-request?branch=master)
An asynchronous HTTP client library for Rust
As this isn't on crates.io as of now, add the following to your Cargo.toml:
```toml
[dependencies]
tokio-request = { git = "https://github.com/NeoLegends/tokio-request" }
```
and the following to your crate's root file:
```rust
extern crate tokio_request;
```
## Examples
Asynchronously send an HTTP request on the specified loop:
```rust
use tokio_core::reactor::Core;
use tokio_request::str::get;
use url::Url;
let mut evloop = Core::new().unwrap();
let future = get("https://httpbin.org/get")
.header("User-Agent", "tokio-request")
.param("Hello", "This is Rust")
.param("Hello2", "This is also from Rust")
.send(evloop.handle());
let result = evloop.run(future).expect("HTTP Request failed!");
println!(
"Site answered with status code {} and body\n{}",
result.status_code(),
result.body_str().unwrap_or("")
);
```
POST some JSON to an API (data must be serializable):
```rust
use tokio_core::reactor::Core;
use tokio_request::str::post;
let mut evloop = Core::new().unwrap();
let future = post("https://httpbin.org/post")
.json(&Data { a: 10, b: 15 })
.send(evloop.handle());
let result = evloop.run(future).expect("HTTP Request failed!");
println!(
"Site answered with status code {} and body\n{}",
result.status_code(),
result.body_str().unwrap_or("")
);
```
## Caveats
Right now the focus for this library is on interacting with REST
APIs that talk JSON, so this library is buffering the entire response
into memory. This means it is not recommended for downloading large
files from the internet. Streaming request / response bodies will be
added at a later stage when implementation and API details have been
figured out.