hwire 0.2.5

An HTTP library written in Rust
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

# hwire


[![CI](https://github.com/0x676e67/hwire/actions/workflows/ci.yml/badge.svg)](https://github.com/0x676e67/hwire/actions/workflows/ci.yml)
[![License](https://img.shields.io/crates/l/hwire.svg)][license]
[![Crates.io](https://img.shields.io/crates/v/hwire.svg)](https://crates.io/crates/hwire)

An HTTP library written in Rust.

## Features


- [HTTP/1](https://www.rfc-editor.org/rfc/rfc9112.html) and [HTTP/2](https://www.rfc-editor.org/rfc/rfc9113.html) implementations.
- Optional [HTTP/3](https://www.rfc-editor.org/rfc/rfc9114.html) over [QUIC](https://www.rfc-editor.org/rfc/rfc9000.html) implementations. 
- Streaming bodies and trailers with backpressure.
- [HTTP Upgrade](https://www.rfc-editor.org/rfc/rfc9110.html#name-upgrade) and [CONNECT](https://www.rfc-editor.org/rfc/rfc9110.html#name-connect) tunnels, including [HTTP/2 Extended CONNECT](https://www.rfc-editor.org/rfc/rfc8441.html).
- Pluggable executor, timer and transport interfaces implemented by the caller.
- Optional tracing with no default Cargo features.
- Tested against [Hyper] servers.

## Usage


Add the protocol crate to `Cargo.toml`:

```toml
[dependencies]
hwire = "0.2"
```

The client APIs are organized by protocol:

```rust
use hwire::conn::{http1, http2};

fn main() {
    // ...
}
```

## Documentation


- [Protocol API][protocol-api]
- [Runtime contracts](https://docs.rs/hwire/latest/hwire/rt/)

## License


Licensed under either of Apache License, Version 2.0 ([LICENSE][license] or [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)).

## 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] license, shall be licensed as above, without any additional terms or conditions.

## Accolades


A hard fork of [Hyper].

[Hyper]: https://github.com/hyperium/hyper
[protocol-api]: https://docs.rs/hwire
[license]: ./LICENSE