rupsc: Implement listing clients

nut-client/src/blocking/mod.rs

@@ -28,6 +28,13 @@ impl Connection {
         }
     }
 
+    /// Queries a list of client IP addresses connected to the given device.
+    pub fn list_clients(&mut self, ups_name: &str) -> crate::Result<Vec<String>> {
+        match self {
+            Self::Tcp(conn) => conn.list_clients(ups_name),
+        }
+    }
+
     /// Queries the list of variables for a UPS device.
     pub fn list_vars(&mut self, ups_name: &str) -> crate::Result<Vec<Variable>> {
         match self {
@@ -103,6 +110,18 @@ impl TcpConnection {
         list.into_iter().map(|row| row.expect_ups()).collect()
     }
 
+    fn list_clients(&mut self, ups_name: &str) -> crate::Result<Vec<String>> {
+        let query = &["CLIENT", ups_name];
+        Self::write_cmd(
+            &mut self.tcp_stream,
+            Command::List(query),
+            self.config.debug,
+        )?;
+        let list = Self::read_list(&mut self.tcp_stream, query, self.config.debug)?;
+
+        list.into_iter().map(|row| row.expect_client()).collect()
+    }
+
     fn list_vars(&mut self, ups_name: &str) -> crate::Result<Vec<(String, String)>> {
         let query = &["VAR", ups_name];
         Self::write_cmd(

nut-client/src/cmd.rs

@@ -52,9 +52,17 @@ pub enum Response {
     /// Marks the end of a list response.
     EndList(String),
     /// A variable (VAR) response.
+    ///
+    /// Params: (var name, var value)
     Var(String, String),
     /// A UPS (UPS) response.
+    ///
+    /// Params: (device name, device description)
     Ups(String, String),
+    /// A client (CLIENT) response.
+    ///
+    /// Params: (client IP)
+    Client(String),
 }
 
 impl Response {
@@ -157,6 +165,23 @@ impl Response {
                 }?;
                 Ok(Response::Ups(name, description))
             }
+            "CLIENT" => {
+                let _device = if args.is_empty() {
+                    Err(ClientError::from(NutError::Generic(
+                        "Unspecified CLIENT device in response".into(),
+                    )))
+                } else {
+                    Ok(args.remove(0))
+                }?;
+                let ip_address = if args.is_empty() {
+                    Err(ClientError::from(NutError::Generic(
+                        "Unspecified CLIENT IP in response".into(),
+                    )))
+                } else {
+                    Ok(args.remove(0))
+                }?;
+                Ok(Response::Client(ip_address))
+            }
             _ => Err(NutError::UnknownResponseType(cmd_name).into()),
         }
     }
@@ -196,4 +221,12 @@ impl Response {
             Err(NutError::UnexpectedResponse.into())
         }
     }
+
+    pub fn expect_client(&self) -> crate::Result<String> {
+        if let Self::Client(client_ip) = &self {
+            Ok(client_ip.to_owned())
+        } else {
+            Err(NutError::UnexpectedResponse.into())
+        }
+    }
 }