mihomo-rs 2.1.0

A Rust SDK and CLI tool for mihomo proxy management with service lifecycle management, configuration handling, and real-time monitoring
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

use std::net::{TcpListener, ToSocketAddrs};

/// Check if a port is available on localhost
pub fn is_port_available(port: u16) -> bool {
    TcpListener::bind(("127.0.0.1", port)).is_ok()
}

/// Find an available port starting from the given port
pub fn find_available_port(start_port: u16) -> Option<u16> {
    (start_port..start_port + 100).find(|&port| is_port_available(port))
}

/// Parse port from address string (e.g., "127.0.0.1:9090" -> 9090)
pub fn parse_port_from_addr(addr: &str) -> Option<u16> {
    addr.to_socket_addrs()
        .ok()?
        .next()
        .map(|socket_addr| socket_addr.port())
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_is_port_available() {
        // Port 0 should always be available (OS assigns a free port)
        let listener = TcpListener::bind("127.0.0.1:0").unwrap();
        let port = listener.local_addr().unwrap().port();

        // Port should not be available while listener is active
        assert!(!is_port_available(port));

        drop(listener);

        // Port should be available after listener is dropped
        assert!(is_port_available(port));
    }

    #[test]
    fn test_find_available_port() {
        let port = find_available_port(9090);
        assert!(port.is_some());
        assert!(port.unwrap() >= 9090);
    }

    #[test]
    fn test_parse_port_from_addr() {
        assert_eq!(parse_port_from_addr("127.0.0.1:9090"), Some(9090));
        assert_eq!(parse_port_from_addr("localhost:8080"), Some(8080));
        assert_eq!(parse_port_from_addr("invalid"), None);
    }
}