#web #request #http #rest #client

hreq-h1

Asynchronous HTTP/1.1 (and 1.0) implementation

6 releases

new 0.2.0 Aug 9, 2020
0.1.4 Aug 9, 2020
0.1.1 Jul 31, 2020

#15 in #request


Used in hreq

MIT/Apache

94KB
2K SLoC

hreq-h1

An asynchronous HTTP/1 server and client implemenation.

This library provides the lower level parts of the HTTP/1.1 (and 1.0) spec. Specifically it concerns sending/receiving http requests and bodies over some unnamed transport. Which async runtime to use, TCP and TLS are handled outside this library.

Since HTTP/1.1 has no multiplexing, the HTTP headers Content-Length and Transfer-Encoding are handled/enforced by this library to be able to correctly delinate where a request starts/ends over the transport.

In scope

  • Content-Length for known body sizes and ensuring the body size is correct.
  • Transfer-Encoding: chunked when body size not known.
  • Connection: keep-alive or close to handle HTTP/1.0 response delineation.

Out of scope

Basically everything which isn't about HTTP as "transport", i.e. application level logic.

  • Following redirects
  • Cookie handling
  • Content-Type characters sets, mime types.
  • Content-Encoding compression, gzip.
  • Expect: 100-Continue

Layout and API

The API tries to closely follow that of h2 so that a user of the library can make uniform handling of both HTTP/1.1 and HTTP/2.0.

There are separate client and server modules and code that is shared between them lives in the crate root.

Handshake

Some connection must already have been established between client and server, this library does not perform socket connection.

In HTTP/1.1 there is no "handshake" like in HTTP/2.0, but to be congruent with h2, the entry points for starting a connection are client::handshake and server::handshake.

Dependencies

~2.5MB
~49K SLoC