feat: add optional JSON serialization.

Author: vikpe

Cargo.toml

@@ -4,7 +4,7 @@ description = "Get server addresses from QuakeWorld master servers."
 keywords = ["masters", "quake", "quakeworld", "servers"]
 repository = "https://github.com/quakeworld/masterstat"
 authors = ["Viktor Persson <viktor.persson@arcsin.se>"]
-version = "0.5.0"
+version = "0.6.0"
 edition = "2024"
 license = "MIT"
 include = [
@@ -24,8 +24,12 @@ futures = "0.3.31"
 tokio = { version = "1.44.1", features = ["macros", "net", "rt-multi-thread", "sync", "time"] }
 tinyudp = "0.5.1"
 
+serde = { optional = true, version = "1.0.219", features = ["derive"] }
+serde_json = { optional = true, version = "1.0.140" }
+
 [dev-dependencies]
 pretty_assertions = "1.4.1"
 
 [features]
 ci = []
+json = ["dep:serde", "dep:serde_json"]

src/command.rs

@@ -7,7 +7,6 @@ use binrw::BinRead;
 use tokio::sync::Mutex;
 
 use crate::server_address::{RawServerAddress, ServerAddress};
-use tinyudp;
 
 /// Get server addresses from a single master server
 ///

src/server_address.rs

@@ -1,6 +1,9 @@
 use binrw::BinRead;
 use std::fmt::Display;
 
+#[cfg(feature = "json")]
+use serde::{Serialize, Serializer};
+
 #[derive(BinRead)]
 #[br(big)]
 pub struct RawServerAddress {
@@ -29,6 +32,16 @@ impl From<RawServerAddress> for ServerAddress {
     }
 }
 
+#[cfg(feature = "json")]
+impl Serialize for ServerAddress {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: Serializer,
+    {
+        serializer.serialize_str(&self.to_string())
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use crate::server_address::{RawServerAddress, ServerAddress};
@@ -64,4 +77,18 @@ mod tests {
         };
         assert_eq!(address.to_string(), "192.168.1.1:30000");
     }
+
+    #[cfg(feature = "json")]
+    #[test]
+    fn test_serialize() -> Result<()> {
+        assert_eq!(
+            serde_json::to_string(&ServerAddress {
+                ip: "10.10.10.10".to_string(),
+                port: 30000,
+            })?,
+            r#""10.10.10.10:30000""#
+        );
+
+        Ok(())
+    }
 }