Refactor errors (#46)

This patch does a bunch of refactoring, mostly around error types, but it also
paves the way to allow `Codec` to be used standalone.

* `Codec` (and `FramedRead` / `FramedWrite`) is broken out into a codec module.
* An h2-codec crate is created that re-exports the frame and codec modules.
* New error types are introduced in the internals:
  * `RecvError` represents errors caused by trying to receive a frame.
  * `SendError` represents errors caused by trying to send a frame.
  * `UserError` is an enum of potential errors caused by invalid usage
    by the user of the lib.
  * `ProtoError` is either a `Reason` or an `io::Error`. However it doesn't
    specify connection or stream level.
  * `h2::Error` is an opaque error type and is the only error type exposed
    by the public API (used to be `ConnectionError`).

There are misc code changes to enable this as well. The biggest is a new "sink"
API for `Codec`. It provides buffer which queues up a frame followed by flush
which writes everything that is queued. This departs from the `Sink` trait in
order to provide more accurate error values. For example, buffer can never fail
(but it will panic if `poll_ready` is not called first).
This commit is contained in:
Carl Lerche
2017-09-02 11:12:50 -07:00
committed by GitHub
parent 6fd9674759
commit c122e97127
37 changed files with 1043 additions and 1027 deletions

18
util/h2-codec/Cargo.toml Normal file
View File

@@ -0,0 +1,18 @@
[package]
name = "h2-codec"
version = "0.1.0"
authors = ["Carl Lerche <me@carllerche.com>"]
[dependencies]
http = { git = "https://github.com/carllerche/http" }
log = "0.3.8"
fnv = "1.0.5"
bytes = "0.4"
string = { git = "https://github.com/carllerche/string" }
byteorder = "1.0"
futures = "0.1"
tokio-io = "0.1.3"
# tokio-timer = "0.1"
# http = { git = "https://github.com/carllerche/http", branch = "lower-case-header-name-parsing" }
# slab = "0.4.0"

22
util/h2-codec/src/lib.rs Normal file
View File

@@ -0,0 +1,22 @@
extern crate http;
extern crate fnv;
extern crate bytes;
extern crate string;
extern crate byteorder;
extern crate futures;
#[macro_use]
extern crate tokio_io;
#[macro_use]
extern crate log;
#[path = "../../../src/hpack/mod.rs"]
mod hpack;
#[path = "../../../src/frame/mod.rs"]
mod frame;
#[path = "../../../src/codec/mod.rs"]
mod codec;