minecraft-pinger 0.1.0

A high-performance, asynchronous Rust library for pinging Minecraft servers to retrieve status, players, and metadata.
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
44
45

pub mod error;
pub mod config;
pub mod common;

#[cfg(feature = "java")]
pub mod java;
#[cfg(feature = "bedrock")]
pub mod bedrock;

use error::PingError;
use hickory_resolver::Resolver;
use hickory_resolver::config::{CLOUDFLARE, ResolverConfig};
use hickory_resolver::net::runtime::TokioRuntimeProvider;
use std::sync::Arc;

pub struct MinecraftPinger {
    dns_resolver: Arc<Resolver<TokioRuntimeProvider>>,
}

impl MinecraftPinger {
    pub fn new() -> Result<Self, PingError> {
        let resolver = Resolver::builder_with_config(
            ResolverConfig::udp_and_tcp(&CLOUDFLARE),
            TokioRuntimeProvider::default()
        )
            .build()
            .map_err(|e| PingError::Init(e.to_string()))?;

        Ok(Self {
            dns_resolver: Arc::new(resolver)
        })
    }

    #[deprecated(note="Some problems with default DNS of OVH for some servers.")]
    pub fn new_legacy() -> Result<Self, PingError> {
        let builder = Resolver::builder_tokio()
            .map_err(|e| PingError::Init(e.to_string()))?;
        let resolver = builder.build()
            .map_err(|e| PingError::Init(e.to_string()))?;

        Ok(Self {
            dns_resolver: Arc::new(resolver)
        })
    }
}