rust-mc-status 3.0.0

High-performance asynchronous Rust library for querying Minecraft server status (Java & Bedrock)
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

//! Unit tests for `core::address::parse`.

use rust_mc_status::McError;
use rust_mc_status::error::ConfigError;

fn parse(addr: &str, default: u16) -> Result<(String, u16, bool), McError> {
    rust_mc_status::core::address::parse(addr, default)
        .map(|(h, p, e)| (h.to_string(), p, e))
}
fn ok(addr: &str, default: u16) -> (String, u16, bool) {
    parse(addr, default).unwrap_or_else(|e| panic!("expected Ok for {addr:?}, got {e}"))
}
fn err(addr: &str, default: u16) -> McError {
    parse(addr, default).expect_err(&format!("expected Err for {addr:?}"))
}

// ── Hostname ──────────────────────────────────────────────────────────────────

#[test]
fn hostname_no_port_uses_default() {
    let (host, port, explicit) = ok("mc.hypixel.net", 25565);
    assert_eq!(host, "mc.hypixel.net");
    assert_eq!(port, 25565);
    assert!(!explicit);
}

#[test]
fn hostname_with_port() {
    let (host, port, explicit) = ok("mc.hypixel.net:19132", 25565);
    assert_eq!(host, "mc.hypixel.net");
    assert_eq!(port, 19132);
    assert!(explicit);
}

#[test]
fn hostname_port_overrides_default() {
    let (_, port, explicit) = ok("server.example.com:1234", 9999);
    assert_eq!(port, 1234);
    assert!(explicit);
}

// ── IPv4 ──────────────────────────────────────────────────────────────────────

#[test]
fn ipv4_no_port() {
    let (host, port, explicit) = ok("192.168.1.1", 25565);
    assert_eq!(host, "192.168.1.1");
    assert_eq!(port, 25565);
    assert!(!explicit);
}

#[test]
fn ipv4_with_port() {
    let (host, port, explicit) = ok("192.168.1.1:25566", 25565);
    assert_eq!(host, "192.168.1.1");
    assert_eq!(port, 25566);
    assert!(explicit);
}

// ── IPv6 ──────────────────────────────────────────────────────────────────────

#[test]
fn ipv6_bracketed_no_port() {
    let (host, port, explicit) = ok("[::1]", 25565);
    assert_eq!(host, "::1");
    assert_eq!(port, 25565);
    assert!(!explicit);
}

#[test]
fn ipv6_bracketed_with_port() {
    let (host, port, explicit) = ok("[::1]:19132", 25565);
    assert_eq!(host, "::1");
    assert_eq!(port, 19132);
    assert!(explicit);
}

#[test]
fn ipv6_full_address_bracketed() {
    let (host, port, explicit) = ok("[2001:db8::1]:25565", 9999);
    assert_eq!(host, "2001:db8::1");
    assert_eq!(port, 25565);
    assert!(explicit);
}

#[test]
fn ipv6_bare_no_brackets_uses_default_port() {
    // Multiple colons, no brackets — treated as raw host with default port
    let (host, port, explicit) = ok("::1", 25565);
    assert_eq!(host, "::1");
    assert_eq!(port, 25565);
    assert!(!explicit);
}

// ── Edge cases ────────────────────────────────────────────────────────────────

#[test]
fn port_zero_is_valid() {
    let (_, port, explicit) = ok("host.example.com:0", 25565);
    assert_eq!(port, 0);
    assert!(explicit);
}

#[test]
fn port_max_u16_is_valid() {
    let (_, port, explicit) = ok("host.example.com:65535", 25565);
    assert_eq!(port, 65535);
    assert!(explicit);
}

// ── Errors ────────────────────────────────────────────────────────────────────

#[test]
fn port_out_of_range_is_config_error() {
    let e = err("mc.hypixel.net:99999", 25565);
    assert!(
        matches!(e, McError::Config(ConfigError::InvalidPort(_))),
        "expected ConfigError::InvalidPort, got {e:?}"
    );
}

#[test]
fn port_not_a_number_is_config_error() {
    let e = err("mc.hypixel.net:abc", 25565);
    assert!(matches!(e, McError::Config(ConfigError::InvalidPort(_))));
}

#[test]
fn ipv6_missing_closing_bracket_is_config_error() {
    let e = err("[::1:25565", 25565);
    assert!(
        matches!(e, McError::Config(ConfigError::InvalidAddress(_))),
        "expected ConfigError::InvalidAddress, got {e:?}"
    );
}

#[test]
fn ipv6_port_not_a_number_is_config_error() {
    let e = err("[::1]:xyz", 25565);
    assert!(matches!(e, McError::Config(ConfigError::InvalidPort(_))));
}