Skip to content

Commit

Permalink
guides: add connector stub
Browse files Browse the repository at this point in the history
  • Loading branch information
seanmonstar committed Dec 9, 2023
1 parent ae0ba91 commit 4ec75f1
Show file tree
Hide file tree
Showing 2 changed files with 36 additions and 3 deletions.
4 changes: 1 addition & 3 deletions _data/stable.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,14 +16,12 @@
guides:
- hello-world
- echo
- graceful-shutdown

- title: Client
path: "/client"
guides:
- basic
- advanced
- configuration
- connectors

- title: Upgrading
path: "/upgrading"
Expand Down
35 changes: 35 additions & 0 deletions _stable/client/connectors.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
title: Connectors, Pools, and HTTPS
layout: guide
---

> **Unstable**: The code discussed in this guide is in `hyper-util`,
> which is not as stable as that which is in `hyper`. It is production
> ready, but changes may come more frequently.
_TODO_

## What is a connector?

_TODO_

## Connection Pools

_TODO_

## HTTPS

hyper allows you to bring your own IO, so it can work on top of any TLS
implementation. (TODO: link to runtime guide)

There are also crates that provide "connectors" which result in
easy-to-use HTTPS for the legacy client in `hyper-util`. Each has their
own reason for existing, and pros and cons, but this list is provided to
help you get started[^tls-list]:

- [hyper-tls](https://crates.io/crates/hyper-tls)
- [hyper-rustls](https://crates.io/crates/hyper-rustls)
- [hyper-openssl](https://crates.io/crates/hyper-openssl)

[^tls-list]: This isn't an endorsement for any of the crates, and they
all are maintained separately from hyper.

0 comments on commit 4ec75f1

Please sign in to comment.