https://github.com/drager/httper

An asynchronous HTTP(S) client built on top of hyper.
https://github.com/drager/httper

http http-client networking request rust rust-library

Last synced: about 2 months ago
JSON representation

An asynchronous HTTP(S) client built on top of hyper.

• Host: GitHub
• URL: https://github.com/drager/httper
• Owner: drager
• License: apache-2.0
• Created: 2018-08-01T22:01:07.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2018-08-14T20:54:25.000Z (about 6 years ago)
• Last Synced: 2024-07-05T12:55:38.515Z (3 months ago)
• Topics: http, http-client, networking, request, rust, rust-library
• Language: Rust
• Homepage: https://docs.rs/httper/
• Size: 78.1 KB
• Stars: 16
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
# HTTPer

[![Build Status](https://travis-ci.org/drager/httper.svg?branch=master)](https://travis-ci.org/drager/httper)

[![crates.io](https://img.shields.io/crates/v/httper.svg)](https://crates.io/crates/httper)

[![API docs](https://docs.rs/httper/badge.svg)](https://docs.rs/httper)

[![MIT/Apache-2.0 licensed](https://img.shields.io/crates/l/httper.svg)](https://github.com/drager/httper/tree/master/README.md#license)

A asynchronous HTTP(S) client built on top of [hyper](https://github.com/hyperium/hyper/).

## Why

At the time when I started writting parts of this client

I couldn't find any higher level asynchronous http(s) client. I also tended to

write the same code over and over again for serveral different projects

based on hyper, always wanted to be able to make requests to https addresses

and deserialize the response body into json.

## Usage

A simple usage example:

```rust

extern crate httper;

extern crate tokio;

#[macro_use]

extern crate serde_derive;

use httper::client::HttperClient;

use tokio::runtime::Runtime;

fn main() {

    let mut rt = Runtime::new().unwrap();

    let httper_client = HttperClient::new();

    #[derive(Debug, Deserialize)]

    struct Contributor {

        id: u32,

        login: String,

    }

    // Call .send() to fire the request and then call .json::>()

    // to turn the json response into a Vec containing Contributor.

    let result = rt.block_on(

        httper_client

            .get("https://api.github.com/repos/drager/httper/contributors")

            .send()

            .json::>(),

    );

    println!("Contributors: {:?}", result);

}

```

## Features and bugs

Please file feature requests and bugs at the [issue tracker][tracker].

[tracker]: https://github.com/drager/httper/issues

## License

Licensed under either of:

* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://apache.org/licenses/LICENSE-2.0)

* MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)