1# H2
2
3A Tokio aware, HTTP/2 client & server implementation for Rust.
4
5[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
6[![Crates.io](https://img.shields.io/crates/v/h2.svg)](https://crates.io/crates/h2)
7[![Documentation](https://docs.rs/h2/badge.svg)][dox]
8
9More information about this crate can be found in the [crate documentation][dox].
10
11[dox]: https://docs.rs/h2
12
13## Features
14
15* Client and server HTTP/2 implementation.
16* Implements the full HTTP/2 specification.
17* Passes [h2spec](https://github.com/summerwind/h2spec).
18* Focus on performance and correctness.
19* Built on [Tokio](https://tokio.rs).
20
21## Non goals
22
23This crate is intended to only be an implementation of the HTTP/2
24specification. It does not handle:
25
26* Managing TCP connections
27* HTTP 1.0 upgrade
28* TLS
29* Any feature not described by the HTTP/2 specification.
30
31This crate is now used by [hyper](https://github.com/hyperium/hyper), which will provide all of these features.
32
33## Usage
34
35To use `h2`, first add this to your `Cargo.toml`:
36
37```toml
38[dependencies]
39h2 = "0.4"
40```
41
42Next, add this to your crate:
43
44```rust
45extern crate h2;
46
47use h2::server::Connection;
48
49fn main() {
50    // ...
51}
52```
53
54## FAQ
55
56**How does h2 compare to [solicit] or [rust-http2]?**
57
58The h2 library has implemented more of the details of the HTTP/2 specification
59than any other Rust library. It also passes the [h2spec] set of tests. The h2
60library is rapidly approaching "production ready" quality.
61
62Besides the above, Solicit is built on blocking I/O and does not appear to be
63actively maintained.
64
65**Is this an embedded Java SQL database engine?**
66
67[No](https://www.h2database.com).
68
69[solicit]: https://github.com/mlalic/solicit
70[rust-http2]: https://github.com/stepancheg/rust-http2
71[h2spec]: https://github.com/summerwind/h2spec
72