ce56ffb656
Many people will find `hyper` when searching for a Rust HTTP crate. Reqwest is not nearly so easy to find unless you know what you are looking for, but is what a lot of people looking for a rust http library need. Let's point them in the right direction. I recently came across a new Rust user on Reddit who had found the hyper crate, but was trying to use libcurl bindings to make http requests because they hadn't managed to find reqwest.
44 lines
1.8 KiB
Markdown
44 lines
1.8 KiB
Markdown
# [hyper](https://hyper.rs)
|
|
|
|
[](https://travis-ci.org/hyperium/hyper)
|
|
[](./LICENSE)
|
|
[](https://crates.io/crates/hyper)
|
|
[](https://docs.rs/hyper)
|
|
|
|
A **fast** and **correct** HTTP implementation for Rust.
|
|
|
|
**Get started** by looking over the [guides](https://hyper.rs/guides).
|
|
|
|
**Hyper is a relatively low-level library, if you are looking for simple high-level HTTP client, then you may wish to consider [reqwest](https://github.com/seanmonstar/reqwest), which is built on top of this library.**
|
|
|
|
## Overview
|
|
|
|
hyper is a fast, safe HTTP implementation written in and for Rust.
|
|
|
|
hyper offers both an HTTP client and server which can be used to drive
|
|
complex web applications written entirely in Rust.
|
|
|
|
hyper makes use of "async IO" (non-blocking sockets) via the
|
|
[Tokio](https://tokio.rs) and [Futures](https://docs.rs/futures) crates.
|
|
|
|
Be aware that hyper is still actively evolving towards 1.0, and is likely
|
|
to experience breaking changes before stabilising. However, this mostly now
|
|
around the instability of `Future` and `async`. The rest of the API is rather
|
|
stable now. You can also see the
|
|
[issues in the upcoming milestones](https://github.com/hyperium/hyper/milestones).
|
|
|
|
## Contributing
|
|
|
|
To get involved, take a look at [CONTRIBUTING](CONTRIBUTING.md).
|
|
|
|
There are two main avenues for real-time chatting about hyper: a [Gitter room][gitter]
|
|
and [irc.mozilla.org/hyper][irc]. They are mirrored, so choose whichever format you
|
|
prefer.
|
|
|
|
[gitter]: https://gitter.im/hyperium/hyper
|
|
[irc]: https://kiwiirc.com/nextclient/irc.mozilla.org/#hyper
|
|
|
|
## License
|
|
|
|
hyper is provided under the MIT license. See [LICENSE](LICENSE).
|