twilight-http

Twilight生态系统中的HTTP支持。

示例

一些使用示例位于 twilight仓库的根目录。

功能

解压缩

decompression功能通过 brotli 包启用brotli解压缩支持。

默认启用。

反序列化

twilight-http支持 serde_json 和 simd-json 用于反序列化响应。

simd-json

simd-json功能通过使用现代CPU的simd特性来启用 simd-json 支持以更快地反序列化响应。默认不启用。

要使用此功能，您需要将以下行添加到 <项目根>/.cargo/config

[build]
rustflags = ["-C", "target-cpu=native"]

您还可以设置环境变量 RUSTFLAGS="-C target-cpu=native"。如果同时启用 serde_json 和 simd-json，则将使用 simd-json。

要启用 simd-json，在您的 Cargo.toml 中做类似以下操作：

[dependencies]
twilight-http = { default-features = false, features = ["rustls-native-roots", "simd-json"], version = "0.2" }

TLS

注意：不支持在代理后面使用时不启用任何TLS功能；Discord的API仅支持HTTPS。

twilight-http具有启用与hyper的HTTPS连接的功能。hyper。这些功能是互斥的。rustls-native-roots默认启用。

native-tls

native-tls功能使用由hyper-tls提供的HTTPS连接器。

要启用native-tls，在你的Cargo.toml中做如下操作

[dependencies]
twilight-http = { default-features = false, features = ["native"], version = "0.2" }

rustls-native-roots

rustls-native-roots功能使用由hyper-rustls提供的HTTPS连接器，该连接器使用rustls作为TLS后端，并启用其native-tokio功能，该功能使用rustls-native-certs作为根证书。

默认启用。

rustls-webpki-roots

rustls-webpki-roots功能使用由hyper-rustls提供的HTTPS连接器，该连接器使用rustls作为TLS后端，并启用其webpki-tokio功能，该功能使用webpki-roots作为根证书。

在基于scratch的Docker容器中，这应优先于rustls-native-roots。

Trust-DNS

hickory功能启用hyper-hickory，它替换了hyper中的默认GaiResolver。相反，hyper-hickory在应用级别提供了一个完全异步的DNS解析器。