Rust HTTP types with URLs
Switch branches/tags
Clone or download
Pull request Compare This branch is 6 commits ahead, 49 commits behind hyperium:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
benches
src
tests
util
.gitignore
.travis.yml
CHANGELOG.md
Cargo.toml
LICENSE-APACHE
LICENSE-MIT
README.md

README.md

HTTP with URL

Did it ever bother you that you could not use regular URLs in Rust when using HTTP?

This crate modifies the HTTP crate to use URLs for requests.

See my blog post and the boguin HTTP client.

Original README

A general purpose library of common HTTP types

Build Status Crates.io Documentation

More information about this crate can be found in the crate documentation.

Usage

To use http, first add this to your Cargo.toml:

[dependencies]
http = "0.1"

Next, add this to your crate:

extern crate http;

use http::{Request, Response};

fn main() {
    // ...
}

Examples

Create an HTTP request:

extern crate http;

use http::Request;

fn main() {
    let request = Request::builder()
      .uri("https://www.rust-lang.org/")
      .header("User-Agent", "awesome/1.0")
      .body(())
      .unwrap();
}

Create an HTTP response:

extern crate http;

use http::{Response, StatusCode};

fn main() {
    let response = Response::builder()
      .status(StatusCode::MOVED_PERMANENTLY)
      .header("Location", "https://www.rust-lang.org/install.html")
      .body(())
      .unwrap();
}

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.