Struct Finder 

pub struct Finder { /* private fields */ }

Asks every source for a target, at the same time, and merges the answers.

An IP address goes to RDAP and Abusix. A domain name goes to RDAP, abuse.net and RFC 2142.

The finder holds the RDAP answers in a Cache, so it does not ask a registry about the same network or the same domain again. Finder::with_cache sets how long an answer is held.

use abuse_contact::{Client, Finder, Resolver};

let finder = Finder::new(Client::new().await?, Resolver::new()?);

let found = finder.lookup("196.216.2.1".parse::<std::net::IpAddr>().unwrap()).await?;
for contact in &found.contacts {
    println!("{} ({:?})", contact.email, contact.scope);
}
for failure in &found.failures {
    eprintln!("{failure}");
}

Implementations

impl Finder

pub fn new(client: Client, resolver: Resolver) -> Self

Returns a finder that asks RDAP with this client and DNS with this resolver.

It holds the RDAP answers in Cache::default.

pub fn with_cache(self, cache: Cache) -> Self

Returns the finder with the RDAP answers held in this cache.

Keep a clone of the cache to read its size or to clear it.

pub async fn lookup(&self, query: impl Into<Query>) -> Result<Found, Error>

Asks every source for the target and returns what they found.

A source that fails does not fail the lookup. Its error is in Found::failures, and the contacts from the other sources are still given.

Errors

Returns Error::NotPublic for a private or reserved address. No source is asked for it.

Trait Implementations

impl Clone for Finder

fn clone(&self) -> Finder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Finder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.