0fd6fcd7c7
All instances of `old_io` and `old_path` were switched to use the new shiny `std::io`, `std::net`, and `std::path` modules. This means that `Request` and `Response` implement `Read` and `Write` now. Because of the changes to `TcpListener`, this also takes the opportunity to correct the method usage of `Server`. As with other languages/frameworks, the server is first created with a handler, and then a host/port is passed to a `listen` method. This reverses what `Server` used to do. Closes #347 BREAKING CHANGE: Check the docs. Everything was touched.
83 lines
1.8 KiB
Markdown
83 lines
1.8 KiB
Markdown
# hyper
|
|
|
|
[](https://travis-ci.org/hyperium/hyper)
|
|
|
|
A Modern HTTP library for Rust.
|
|
|
|
[Documentation](http://hyperium.github.io/hyper)
|
|
|
|
## Overview
|
|
|
|
Hyper is a fast, modern HTTP implementation written in and for Rust. It
|
|
is a low-level typesafe abstraction over raw HTTP, providing an elegant
|
|
layer over "stringly-typed" HTTP.
|
|
|
|
Hyper offers both an HTTP/S client and HTTP server which can be used to drive
|
|
complex web applications written entirely in Rust.
|
|
|
|
The documentation is located at [http://hyperium.github.io/hyper](http://hyperium.github.io/hyper).
|
|
|
|
__WARNING: Hyper is still under active development. The API is still changing
|
|
in non-backwards-compatible ways without warning.__
|
|
|
|
## Example
|
|
|
|
Hello World Server:
|
|
|
|
```rust
|
|
extern crate hyper;
|
|
|
|
use std::io::Write;
|
|
use std::net::IpAddr;
|
|
|
|
use hyper::Server;
|
|
use hyper::server::Request;
|
|
use hyper::server::Response;
|
|
use hyper::net::Fresh;
|
|
|
|
fn hello(_: Request, mut res: Response<Fresh>) {
|
|
let mut res = res.start().unwrap();
|
|
res.write_all(b"Hello World!").unwrap();
|
|
res.end().unwrap();
|
|
}
|
|
|
|
fn main() {
|
|
Server::http(hello).listen(IpAddr::new_v4(127, 0, 0, 1), 3000).unwrap();
|
|
}
|
|
```
|
|
|
|
Client:
|
|
|
|
```rust
|
|
extern crate hyper;
|
|
|
|
use std::io::Read;
|
|
|
|
use hyper::Client;
|
|
use hyper::header::Connection;
|
|
use hyper::header::ConnectionOption;
|
|
|
|
fn main() {
|
|
// Create a client.
|
|
let mut client = Client::new();
|
|
|
|
// Creating an outgoing request.
|
|
let mut res = client.get("http://www.gooogle.com/")
|
|
// set a header
|
|
.header(Connection(vec![ConnectionOption::Close]))
|
|
// let 'er go!
|
|
.send().unwrap();
|
|
|
|
// Read the Response.
|
|
let mut body = String::new();
|
|
res.read_to_string(&mut body).unwrap();
|
|
|
|
println!("Response: {}", body);
|
|
}
|
|
```
|
|
|
|
## License
|
|
|
|
[MIT](./LICENSE)
|
|
|