rzmq 0.5.21

High performance, CPU and memory efficient, fully asynchronous, safe pure-Rust implementation of ZeroMQ (ØMQ) messaging with io_uring and TCP Cork acceleration on Linux.
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

use crate::error::ZmqError;
use std::path::PathBuf;

/// Represents a parsed and validated endpoint address.
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub(crate) enum Endpoint {
  Tcp(String, String), // Store address part (e.g., "my-host:5555") and original URI
  #[cfg(feature = "ipc")]
  Ipc(PathBuf, String), // Store validated PathBuf and original string
  #[cfg(feature = "inproc")]
  Inproc(String), // Store name
}

/// Parses an endpoint string into a structured Endpoint enum.
pub(crate) fn parse_endpoint(endpoint_str: &str) -> Result<Endpoint, ZmqError> {
  let invalid_endpoint_err = || ZmqError::InvalidEndpoint(endpoint_str.to_string());

  // Find the scheme separator "://"
  if let Some(separator_pos) = endpoint_str.find("://") {
    let scheme = &endpoint_str[..separator_pos];
    let address_part = &endpoint_str[separator_pos + 3..]; // Skip "://"

    // Match on the scheme
    match scheme {
      "tcp" => {
        if address_part.is_empty() {
          Err(invalid_endpoint_err())
        } else {
          Ok(Endpoint::Tcp(
            address_part.to_string(),
            endpoint_str.to_string(),
          ))
        }
      }

      #[cfg(feature = "ipc")]
      "ipc" => {
        // Parse IPC path
        if address_part.is_empty() || address_part.contains('\0') {
          Err(invalid_endpoint_err())
        } else {
          let path = PathBuf::from(address_part);
          Ok(Endpoint::Ipc(path, endpoint_str.to_string()))
        }
      }

      #[cfg(feature = "inproc")]
      "inproc" => {
        // Parse Inproc name
        if address_part.is_empty() || address_part.contains('\0') {
          Err(invalid_endpoint_err())
        } else {
          Ok(Endpoint::Inproc(address_part.to_string()))
        }
      }

      // Handle schemes disabled by features or unknown schemes
      _ => Err(ZmqError::UnsupportedTransport(endpoint_str.to_string())),
    } // End match scheme
  } else {
    // No "://" found, invalid format
    Err(invalid_endpoint_err())
  }
}

// Optional: Add methods to Endpoint enum?
// impl Endpoint { pub fn scheme(&self) -> &'static str { ... } }

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

  #[test]
  fn test_parse_valid_tcp_endpoint() {
    let uri = "tcp://127.0.0.1:5555";
    let parsed = parse_endpoint(uri).expect("Should parse valid TCP URI");

    match parsed {
      Endpoint::Tcp(addr, original) => {
        assert_eq!(addr, "127.0.0.1:5555");
        assert_eq!(original, uri);
      }
      #[allow(unreachable_patterns)]
      _ => panic!("Expected Endpoint::Tcp"),
    }
  }

  #[test]
  fn test_parse_invalid_format() {
    assert!(matches!(
      parse_endpoint("tcp:/127.0.0.1"),
      Err(ZmqError::InvalidEndpoint(_))
    ));
    assert!(matches!(
      parse_endpoint("tcp://"),
      Err(ZmqError::InvalidEndpoint(_))
    ));
  }

  #[test]
  fn test_parse_unsupported_scheme() {
    let result = parse_endpoint("udp://127.0.0.1:5555");
    assert!(matches!(result, Err(ZmqError::UnsupportedTransport(_))));
  }

  #[test]
  #[cfg(feature = "ipc")]
  fn test_parse_valid_ipc_endpoint() {
    let uri = "ipc:///tmp/rzmq.sock";
    let parsed = parse_endpoint(uri).expect("Should parse valid IPC URI");

    match parsed {
      Endpoint::Ipc(path, original) => {
        assert_eq!(path.to_str().unwrap(), "/tmp/rzmq.sock");
        assert_eq!(original, uri);
      }
      _ => panic!("Expected Endpoint::Ipc"),
    }
  }

  #[test]
  #[cfg(feature = "inproc")]
  fn test_parse_valid_inproc_endpoint() {
    let uri = "inproc://my-service";
    let parsed = parse_endpoint(uri).expect("Should parse valid inproc URI");

    match parsed {
      Endpoint::Inproc(name) => {
        assert_eq!(name, "my-service");
      }
      _ => panic!("Expected Endpoint::Inproc"),
    }
  }
}