feat(core): add JSON-RPC helpers

Signed-off-by: Ronan Abhamon <ronan.abhamon@vates.tech>

Author: Wescoeur

.github/workflows/code-checkers.yml

@@ -28,3 +28,16 @@ jobs:
 
       - name: Mypy check
         run: mypy
+
+  tests:
+    name: Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/setup-python-env
+
+      - name: Install Pytest
+        run: pip install pytest
+
+      - name: Pytest check
+        run: pytest

pyproject.toml

@@ -1,7 +1,8 @@
 [tool.mypy]
 mypy_path = "stubs"
 files = [
-    "src"
+    "src",
+    "tests"
 ]
 
 disallow_untyped_defs = true
@@ -32,7 +33,8 @@ disallow_untyped_defs = false
 
 [tool.ruff]
 include = [
-    "src/**/*.py"
+    "src/**/*.py",
+    "tests/**/*.py"
 ]
 line-length = 120
 
@@ -116,3 +118,4 @@ ban-relative-imports = "all"
 
 [tool.pytest.ini_options]
 pythonpath = ["src", "stubs"]
+testpaths = ["tests"]

src/xcp_storage/utils/__init__.py

@@ -0,0 +1,24 @@
+# Copyright (C) 2026  Vates SAS
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+# ==============================================================================
+
+def stringify_exception(e: Exception) -> str:
+    try:
+        return str(e)
+    except Exception:
+        try:
+            return f"Exception of type `{e.__class__.__name__}`."
+        except Exception:
+            return "Unknown Exception."

src/xcp_storage/utils/exception.py

@@ -0,0 +1,34 @@
+# Copyright (C) 2026  Vates SAS
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+from xcp_storage.typing import (
+  Dict,
+  List,
+  Union,
+)
+
+# ==============================================================================
+
+JsonValue = Union[
+    str,
+    int,
+    float,
+    bool,
+    None,
+    List["JsonValue"],
+    Dict[str, "JsonValue"]
+]
+
+JsonDict = Dict[str, JsonValue]
+JsonList = List[JsonValue]