Skip to content

Foxcirc/rtv

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rtv

Rtv is a simple, minimal dependency, HTTP client that runs ontop of mio. It supports fully nonblocking requests, even dns resolution is nonblocking. You can also use it with async as a much more light weight (but also less robust and featurefull) alternative to something like hyper.

You can either setup mio youself and then use a Client to make requests using your own Poll or alternatively you can use a SimpleClient if you want to use async. However the latter is currently supported on 64 bit unix only.

Example (Client)

This is the main functionality that this crate provides. You can find an example here on docs.rs.

Example (SimpleClient)

It is really simple to make a single request. This is not the only functionality that this client provides though!

let mut client = SimpleClient::new()?;
let request = Request::get().host("google.com");
client.send(request).await?;

Mio Httpc

This crate is similar to mio_httpc, however the API is much more clean, in my opinion. MioHttpc makes event handling, timeouts and errors very verbose, while this crate aims to provide a much simpler interface that only requires calling one function (pump). Rtv supports only a subset of mio_httpc's features though and is probably not as efficient and stable. Rtv really is a simple HTTP client.

Notes

Earlier versions of this crate were completely different. I decided to repurpose the name because I don't wanna litter my profile or crates.io.

  • First rtv was a crate for doing recursive-file-traversal
  • Then it was a crate for resolving futures (completely useless)