#dns-resolver #hyper #hickory #connector #default #advanced

hyper-hickory

HTTP connector for hyper that uses hickory's DNS resolver

2 unstable releases

0.7.0 Jan 12, 2024
0.6.0 Oct 14, 2023

#99 in HTTP client

Download history 167/week @ 2023-12-18 435/week @ 2024-01-01 268/week @ 2024-01-08 981/week @ 2024-01-15 953/week @ 2024-01-22 1035/week @ 2024-01-29 1011/week @ 2024-02-05 968/week @ 2024-02-12 881/week @ 2024-02-19 631/week @ 2024-02-26 1308/week @ 2024-03-04 1179/week @ 2024-03-11 1254/week @ 2024-03-18 1029/week @ 2024-03-25 1109/week @ 2024-04-01

4,576 downloads per month
Used in odd-box

MIT license

13KB
138 lines

hyper-hickory

This crate provides a HTTP connector for hyper that uses the fast and advanced DNS resolver of hickory instead of the default threadpool implementation of hyper.

Usage

use http_body_util::Full; // Or your preferred Body implementation
use hyper::body::Bytes;
use hyper_hickory::HickoryResolver;
use hyper_util::{client::legacy::Client, rt::TokioExecutor};

let connector = HickoryResolver::default().into_http_connector();
let client: Client<_, Full<Bytes>> = Client::builder(TokioExecutor::new()).build(connector);

Resolvers

There is a HickoryResolver resolver which can be built from an AsyncResolver using HickoryResolver::from_async_resolver.

For most cases where you are happy to use the standard TokioRuntimeProvider, the TokioHickoryResolver should be used and is able to be built much more easily.

Types of connectors

There are 2 connectors:

Hickory options

The crate has other features that toggle functionality in hickory-resolver, namingly dns-over-openssl, dns-over-native-tls and dns-over-rustls (combined with rustls-webpki or rustls-native) for DNS-over-TLS, dns-over-https-rustls for DNS-over-HTTPS and dnssec-openssl and dnssec-ring for DNSSEC.

A note on DNSSEC

DNSSEC functionality was never actually used if enabled prior to version 0.5.0 of this crate. This has been changed since and might result in sudden, breaking behaviour due to hickory-resolver failing on unsigned records.

This behaviour will continue until DNSSEC is improved in hickory.

Dependencies

~10–26MB
~403K SLoC