comprehensive_dns 0.4.0

A DNS resolver for https://crates.io/crates/comprehensive
Documentation 
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

<!-- cargo-rdme start -->

A DNS resolver for [`comprehensive`]

This crate provides a DNS resolver for including in a
[`comprehensive::Assembly`]. Other [`Resource`]s that require DNS
resolution services can depend on this one to obtain a handle to
the singleton shared client.

It wraps a [`hickory_resolver::TokioResolver`].

There are currently no configuration parameters.

```rust
use comprehensive::{NoArgs, Resource, ResourceDependencies};
use comprehensive_dns::{DNSResolver, ResolverHandle};
use std::sync::Arc;

struct SomeResource(ResolverHandle);

#[derive(ResourceDependencies)]
struct SomeResourceDependencies(Arc<DNSResolver>);

impl Resource for SomeResource {
   type Args = NoArgs;
   type Dependencies = SomeResourceDependencies;
   const NAME: &str = "SomeResource";

   fn new(
       d: SomeResourceDependencies,
        _: NoArgs,
   ) -> Result<Self, Box<dyn std::error::Error>> {
       Ok(Self(d.0.resolver()))
   }

   async fn run(&self) -> Result<(), Box<dyn std::error::Error>> {
       println!("{:?}", self.0.as_ref().lookup_ip("example.org.").await);
       Ok(())
   }
}
```

<!-- cargo-rdme end -->