Add as_json to responses

mcstatus/responses.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from abc import ABC, abstractmethod
-from dataclasses import dataclass
+from dataclasses import asdict, dataclass
 from typing import Any, TYPE_CHECKING
 
 from mcstatus.forge_data import ForgeData, RawForgeData
@@ -101,6 +101,25 @@ def build(cls, *args, **kwargs) -> Self:
         """
         raise NotImplementedError("You can't use abstract methods.")
 
+    def as_dict(self) -> dict[str, Any]:
+        """Return the dataclass as JSON-serializable :class:`dict`.
+
+        Do note that this method doesn't return :class:`string <str>` but
+        :class:`dict`, so you can do some processing on returned value.
+
+        Difference from
+        :attr:`~mcstatus.responses.JavaStatusResponse.raw` is in that,
+        :attr:`~mcstatus.responses.JavaStatusResponse.raw` returns raw response
+        in the same format as we got it. This method returns the response
+        in a more user-friendly JSON serializable format (for example,
+        :attr:`~mcstatus.responses.BaseStatusResponse.motd` is returned as a
+        :func:`Minecraft string <mcstatus.motd.Motd.to_minecraft>` and not
+        :class:`dict`).
+        """
+        as_dict = asdict(self)
+        as_dict["motd"] = self.motd.simplify().to_minecraft()
+        return as_dict
+
 
 @dataclass(frozen=True)
 class JavaStatusResponse(BaseStatusResponse):

tests/responses/test_bedrock.py

@@ -65,6 +65,16 @@ def test_optional_parameters_is_none(self, field, pop_index):
         build = BedrockStatusResponse.build(parameters, 123.0)
         assert getattr(build, field) is None
 
+    def test_as_dict(self, build: BedrockStatusResponse):
+        assert build.as_dict() == {
+            "gamemode": "Default",
+            "latency": 123.0,
+            "map_name": "map name here",
+            "motd": "§4G§6a§ey§2B§1o§9w§ds§4e§6r",
+            "players": {"max": 69, "online": 1},
+            "version": {"brand": "MCPE", "name": "1.18.100500", "protocol": 422},
+        }
+
 
 @BaseResponseTest.construct
 class TestBedrockStatusPlayers(BaseResponseTest):

tests/responses/test_java.py

@@ -40,6 +40,24 @@ class TestJavaStatusResponse(BaseResponseTest):
     def build(self) -> JavaStatusResponse:
         return JavaStatusResponse.build(self.RAW)  # type: ignore # dict[str, Unknown] cannot be assigned to TypedDict
 
+    def test_as_dict(self, build: JavaStatusResponse):
+        assert build.as_dict() == {
+            "enforces_secure_chat": True,
+            "forge_data": None,
+            "icon": "data:image/png;base64,foo",
+            "latency": 0,
+            "motd": "A Minecraft Server",
+            "players": {"max": 20, "online": 0, "sample": None},
+            "raw": {
+                "description": "A Minecraft Server",
+                "enforcesSecureChat": True,
+                "favicon": "data:image/png;base64,foo",
+                "players": {"max": 20, "online": 0},
+                "version": {"name": "1.8-pre1", "protocol": 44},
+            },
+            "version": {"name": "1.8-pre1", "protocol": 44},
+        }
+
 
 @BaseResponseTest.construct
 class TestJavaStatusPlayers(BaseResponseTest):