Files
h2/README.md
Carl Lerche edaeaa8941 License h2 only under the MIT license
The intent of the original licensing text was to dual license under both
Apache 2.0 and MIT. As such, switching the license to only MIT is
permitted.
2017-12-16 14:52:08 -06:00

1.8 KiB

H2

A Tokio aware, HTTP/2.0 client & server implementation for Rust.

Build Status Codecov

This library is not production ready. Do not try to use it in a production environment or you will regret it! This crate is still under active development and there has not yet been any focus on documentation (because you shouldn't be using it yet!).

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

Features

  • Client and server HTTP/2.0 implementation.
  • Implements the full HTTP/2.0 specification.
  • Passes h2spec.
  • Focus on performance and correctness.
  • Built on Tokio.

Non goals

This crate is intended to only be an implementation of the HTTP/2.0 specification. It does not handle:

  • Managing TCP connections
  • HTTP 1.0 upgrade
  • TLS
  • Any feature not described by the HTTP/2.0 specification.

The intent is that this crate will eventually be used by hyper, which will provide all of these features.

Usage

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

[dependencies]
h2 = { git = 'https://github.com/carllerche/h2' } # soon to be on crates.io!

Next, add this to your crate:

extern crate h2;

use h2::server::Server;

fn main() {
    // ...
}

FAQ

Is this an embedded Java SQL database engine?

No.