Skip to content

Commit 4ec75f1

Browse files
committed
guides: add connector stub
1 parent ae0ba91 commit 4ec75f1

File tree

2 files changed

+36
-3
lines changed

2 files changed

+36
-3
lines changed

_data/stable.yml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,14 +16,12 @@
1616
guides:
1717
- hello-world
1818
- echo
19-
- graceful-shutdown
2019

2120
- title: Client
2221
path: "/client"
2322
guides:
2423
- basic
25-
- advanced
26-
- configuration
24+
- connectors
2725

2826
- title: Upgrading
2927
path: "/upgrading"

_stable/client/connectors.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
title: Connectors, Pools, and HTTPS
3+
layout: guide
4+
---
5+
6+
> **Unstable**: The code discussed in this guide is in `hyper-util`,
7+
> which is not as stable as that which is in `hyper`. It is production
8+
> ready, but changes may come more frequently.
9+
10+
_TODO_
11+
12+
## What is a connector?
13+
14+
_TODO_
15+
16+
## Connection Pools
17+
18+
_TODO_
19+
20+
## HTTPS
21+
22+
hyper allows you to bring your own IO, so it can work on top of any TLS
23+
implementation. (TODO: link to runtime guide)
24+
25+
There are also crates that provide "connectors" which result in
26+
easy-to-use HTTPS for the legacy client in `hyper-util`. Each has their
27+
own reason for existing, and pros and cons, but this list is provided to
28+
help you get started[^tls-list]:
29+
30+
- [hyper-tls](https://crates.io/crates/hyper-tls)
31+
- [hyper-rustls](https://crates.io/crates/hyper-rustls)
32+
- [hyper-openssl](https://crates.io/crates/hyper-openssl)
33+
34+
[^tls-list]: This isn't an endorsement for any of the crates, and they
35+
all are maintained separately from hyper.

0 commit comments

Comments
 (0)