Crest

Crest is a REST client library, written in Rust.

Status

It is currently experimental, and incomplete. Pull requests are welcome.

Installation

Crest is available from Cargo. If you are using stable Rust, add this to [dependencies] in Cargo.toml:

toml crest = "0.3"

If you are using nightly Rust, this is needed instead:

toml [dependencies.crest] version = "0.3" default-features = false features = ["nightly"]

Usage

Example: Making a GET request and deserializing the response

The following code first constructs a GET request for a resource at https://httpbin.org/ip, and then deserializes the response – in JSON format – into a custom type.

Note that deserialization is performed by serde; for more information on how to derive Deserialize for custom types, refer to serde documentation.

```rust extern crate crest; extern crate serde;

use crest::error::Result; use crest::prelude::*;

[derive(Debug, Deserialize)]

struct HttpbinIP { origin: String, }

fn example() -> Result { // 1. Construct the endpoint off a base URL let endpoint = try!(Endpoint::new("https://httpbin.org/"));

// 2. Construct the request
let request = try!(endpoint.get(&["ip"]));

// 3. Perform the request
let response = try!(request.send());

// 4. Deserialize the response
let ip = try!(response.into::<HttpbinIP>());

Ok(ip)

} ```

More documentation is available here.

License

Crest is licensed under the Apache License, Version 2.0 (see LICENSE-APACHE) or the MIT license (see LICENSE-MIT), at your option.