rpc-python-toolkit 0.1.0__tar.gz → 0.2.0__tar.gz

{rpc_python_toolkit-0.1.0/src/rpc_python_toolkit.egg-info → rpc_python_toolkit-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpc-python-toolkit
-Version: 0.1.0
+Version: 0.2.0
 Summary: Framework-agnostic Python JSON-RPC 2.0 toolkit with Safe Mode interoperability.
 Author: Nicola Carpanese
 License-Expression: MIT
@@ -25,13 +25,19 @@ Dynamic: license-file
 
 # RPC Python Toolkit
 
+[![CI](https://github.com/n-car/rpc-python-toolkit/actions/workflows/ci.yml/badge.svg)](https://github.com/n-car/rpc-python-toolkit/actions/workflows/ci.yml)
+[![PyPI Version](https://img.shields.io/pypi/v/rpc-python-toolkit.svg)](https://pypi.org/project/rpc-python-toolkit/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/rpc-python-toolkit.svg)](https://pypi.org/project/rpc-python-toolkit/)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Status](https://img.shields.io/badge/status-alpha-orange.svg)](https://pypi.org/project/rpc-python-toolkit/)
+
 Framework-agnostic JSON-RPC 2.0 toolkit for Python.
 
 Use this package when you need a small Python JSON-RPC 2.0 client/server core that can be embedded directly or adapted to HTTP frameworks. It follows the same protocol conventions used across the RPC Toolkit ecosystem.
 
 ## Project Status
 
-Small early package with the core JSON-RPC behavior implemented.
+Alpha package with the core JSON-RPC behavior implemented.
 
 - Published on PyPI as `rpc-python-toolkit`.
 - Standard JSON-RPC 2.0 remains the default behavior.
@@ -80,7 +86,11 @@ python -m unittest discover
 ```python
 from rpc_python_toolkit import RpcEndpoint
 
-rpc = RpcEndpoint(enable_introspection=True)
+rpc = RpcEndpoint(
+    enable_introspection=True,
+    enable_batch=True,
+    max_batch_size=100,
+)
 
 def test(request, context, params):
     return {"ok": True, "params": params}
@@ -97,6 +107,12 @@ response = rpc.handle_payload({
 print(response.body)
 ```
 
+Batch can be disabled with `enable_batch=False`. Introspection remains opt-in.
+When both application and request contexts are dictionaries, handlers receive a
+merged dictionary and request values take precedence. For a non-dictionary
+application context plus request data, handlers receive `RpcCallContext` with
+separate `application` and `request` attributes.
+
 Result:
 
 ```json

{rpc_python_toolkit-0.1.0 → rpc_python_toolkit-0.2.0}/README.md

@@ -1,12 +1,18 @@
 # RPC Python Toolkit
 
+[![CI](https://github.com/n-car/rpc-python-toolkit/actions/workflows/ci.yml/badge.svg)](https://github.com/n-car/rpc-python-toolkit/actions/workflows/ci.yml)
+[![PyPI Version](https://img.shields.io/pypi/v/rpc-python-toolkit.svg)](https://pypi.org/project/rpc-python-toolkit/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/rpc-python-toolkit.svg)](https://pypi.org/project/rpc-python-toolkit/)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Status](https://img.shields.io/badge/status-alpha-orange.svg)](https://pypi.org/project/rpc-python-toolkit/)
+
 Framework-agnostic JSON-RPC 2.0 toolkit for Python.
 
 Use this package when you need a small Python JSON-RPC 2.0 client/server core that can be embedded directly or adapted to HTTP frameworks. It follows the same protocol conventions used across the RPC Toolkit ecosystem.
 
 ## Project Status
 
-Small early package with the core JSON-RPC behavior implemented.
+Alpha package with the core JSON-RPC behavior implemented.
 
 - Published on PyPI as `rpc-python-toolkit`.
 - Standard JSON-RPC 2.0 remains the default behavior.
@@ -55,7 +61,11 @@ python -m unittest discover
 ```python
 from rpc_python_toolkit import RpcEndpoint
 
-rpc = RpcEndpoint(enable_introspection=True)
+rpc = RpcEndpoint(
+    enable_introspection=True,
+    enable_batch=True,
+    max_batch_size=100,
+)
 
 def test(request, context, params):
     return {"ok": True, "params": params}
@@ -72,6 +82,12 @@ response = rpc.handle_payload({
 print(response.body)
 ```
 
+Batch can be disabled with `enable_batch=False`. Introspection remains opt-in.
+When both application and request contexts are dictionaries, handlers receive a
+merged dictionary and request values take precedence. For a non-dictionary
+application context plus request data, handlers receive `RpcCallContext` with
+separate `application` and `request` attributes.
+
 Result:
 
 ```json

{rpc_python_toolkit-0.1.0 → rpc_python_toolkit-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rpc-python-toolkit"
-version = "0.1.0"
+version = "0.2.0"
 description = "Framework-agnostic Python JSON-RPC 2.0 toolkit with Safe Mode interoperability."
 readme = "README.md"
 requires-python = ">=3.10"

{rpc_python_toolkit-0.1.0 → rpc_python_toolkit-0.2.0}/src/rpc_python_toolkit/__init__.py

@@ -1,5 +1,5 @@
 from .client import RpcClient, RpcSafeClient
-from .endpoint import RpcEndpoint, RpcHttpResponse, RpcSafeEndpoint
+from .endpoint import RpcCallContext, RpcEndpoint, RpcHttpResponse, RpcSafeEndpoint
 from .errors import RpcError, RpcRemoteError
 from .serialization import deserialize_value, serialize_value
 from .version import __version__
@@ -10,10 +10,10 @@ __all__ = [
     "serialize_value",
     "RpcClient",
     "RpcEndpoint",
+    "RpcCallContext",
     "RpcError",
     "RpcHttpResponse",
     "RpcRemoteError",
     "RpcSafeClient",
     "RpcSafeEndpoint",
 ]
-

{rpc_python_toolkit-0.1.0 → rpc_python_toolkit-0.2.0}/src/rpc_python_toolkit/endpoint.py

@@ -23,6 +23,19 @@ class RpcHttpResponse:
     body: Any | None = None
 
 
+@dataclass(frozen=True)
+class RpcCallContext:
+    """Context used when application state is not a mapping.
+
+    Mapping application contexts are merged with request data for backward
+    compatibility. For other application context types, this wrapper keeps
+    application and request scopes explicit.
+    """
+
+    application: Any
+    request: dict[str, Any]
+
+
 @dataclass
 class MethodConfig:
     handler: Handler
@@ -40,6 +53,8 @@ class RpcEndpoint:
         strict_mode: bool = True,
         enable_introspection: bool = False,
         introspection_prefix: str = "__rpc",
+        enable_batch: bool = True,
+        max_batch_size: int = 100,
         max_serialization_depth: int = 100,
         max_deserialization_depth: int = 100,
     ):
@@ -49,6 +64,8 @@ class RpcEndpoint:
         self.strict_mode = strict_mode
         self.enable_introspection = enable_introspection
         self.introspection_prefix = introspection_prefix
+        self.enable_batch = enable_batch
+        self.max_batch_size = max_batch_size
         self.max_serialization_depth = max_serialization_depth
         self.max_deserialization_depth = max_deserialization_depth
         self.validator = SchemaValidator()
@@ -159,6 +176,29 @@ class RpcEndpoint:
                 make_response(None, error={"code": -32600, "message": "Invalid Request"}),
             )
 
+        if not self.enable_batch:
+            return RpcHttpResponse(
+                200,
+                headers,
+                make_response(
+                    None,
+                    error={"code": -32600, "message": "Batch requests are not enabled"},
+                ),
+            )
+
+        if self.max_batch_size > 0 and len(batch) > self.max_batch_size:
+            return RpcHttpResponse(
+                200,
+                headers,
+                make_response(
+                    None,
+                    error={
+                        "code": -32600,
+                        "message": f"Batch size exceeds maximum of {self.max_batch_size}",
+                    },
+                ),
+            )
+
         responses = []
         for item in batch:
             result = self._process_single(item, context)
@@ -226,11 +266,23 @@ class RpcEndpoint:
         context: dict[str, Any],
         params: Any,
     ) -> Any:
-        result = handler(request, self.context if self.context is not None else context, params)
+        result = handler(request, self._resolve_handler_context(context), params)
         if inspect.isawaitable(result):
             raise RpcError("Async handlers require an async adapter", -32603)
         return result
 
+    def _resolve_handler_context(self, request_context: dict[str, Any]) -> Any:
+        if self.context is None:
+            return request_context
+
+        if isinstance(self.context, dict):
+            return {**self.context, **request_context}
+
+        if request_context:
+            return RpcCallContext(application=self.context, request=request_context)
+
+        return self.context
+
     def _register_introspection_methods(self) -> None:
         prefix = self.introspection_prefix
 
@@ -255,7 +307,7 @@ class RpcEndpoint:
             f"{prefix}.capabilities",
             lambda _request, _context, _params: {
                 "jsonrpc": "2.0",
-                "batch": True,
+                "batch": self.enable_batch,
                 "notifications": True,
                 "introspection": True,
                 "safeMode": self.safe_enabled,
@@ -311,4 +363,3 @@ class RpcSafeEndpoint(RpcEndpoint):
         options.setdefault("safe_enabled", True)
         options.setdefault("strict_mode", True)
         super().__init__(context, **options)
-

rpc_python_toolkit-0.2.0/src/rpc_python_toolkit/version.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"

{rpc_python_toolkit-0.1.0 → rpc_python_toolkit-0.2.0/src/rpc_python_toolkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpc-python-toolkit
-Version: 0.1.0
+Version: 0.2.0
 Summary: Framework-agnostic Python JSON-RPC 2.0 toolkit with Safe Mode interoperability.
 Author: Nicola Carpanese
 License-Expression: MIT
@@ -25,13 +25,19 @@ Dynamic: license-file
 
 # RPC Python Toolkit
 
+[![CI](https://github.com/n-car/rpc-python-toolkit/actions/workflows/ci.yml/badge.svg)](https://github.com/n-car/rpc-python-toolkit/actions/workflows/ci.yml)
+[![PyPI Version](https://img.shields.io/pypi/v/rpc-python-toolkit.svg)](https://pypi.org/project/rpc-python-toolkit/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/rpc-python-toolkit.svg)](https://pypi.org/project/rpc-python-toolkit/)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Status](https://img.shields.io/badge/status-alpha-orange.svg)](https://pypi.org/project/rpc-python-toolkit/)
+
 Framework-agnostic JSON-RPC 2.0 toolkit for Python.
 
 Use this package when you need a small Python JSON-RPC 2.0 client/server core that can be embedded directly or adapted to HTTP frameworks. It follows the same protocol conventions used across the RPC Toolkit ecosystem.
 
 ## Project Status
 
-Small early package with the core JSON-RPC behavior implemented.
+Alpha package with the core JSON-RPC behavior implemented.
 
 - Published on PyPI as `rpc-python-toolkit`.
 - Standard JSON-RPC 2.0 remains the default behavior.
@@ -80,7 +86,11 @@ python -m unittest discover
 ```python
 from rpc_python_toolkit import RpcEndpoint
 
-rpc = RpcEndpoint(enable_introspection=True)
+rpc = RpcEndpoint(
+    enable_introspection=True,
+    enable_batch=True,
+    max_batch_size=100,
+)
 
 def test(request, context, params):
     return {"ok": True, "params": params}
@@ -97,6 +107,12 @@ response = rpc.handle_payload({
 print(response.body)
 ```
 
+Batch can be disabled with `enable_batch=False`. Introspection remains opt-in.
+When both application and request contexts are dictionaries, handlers receive a
+merged dictionary and request values take precedence. For a non-dictionary
+application context plus request data, handlers receive `RpcCallContext` with
+separate `application` and `request` attributes.
+
 Result:
 
 ```json

{rpc_python_toolkit-0.1.0 → rpc_python_toolkit-0.2.0}/tests/test_core.py

@@ -8,6 +8,7 @@ from http.server import BaseHTTPRequestHandler, HTTPServer
 
 from rpc_python_toolkit import (
     RpcClient,
+    RpcCallContext,
     RpcEndpoint,
     RpcRemoteError,
     RpcSafeClient,
@@ -68,6 +69,67 @@ class CoreTests(unittest.TestCase):
             [{"jsonrpc": "2.0", "id": "a", "result": {"value": 1}}],
         )
 
+    def test_can_disable_batch_requests(self):
+        rpc = RpcEndpoint(enable_batch=False)
+        rpc.add_method("echo", lambda _request, _context, params: params)
+
+        response = rpc.handle_payload(
+            [{"jsonrpc": "2.0", "method": "echo", "id": 1}]
+        )
+
+        self.assertEqual(response.body["error"]["code"], -32600)
+        self.assertIn("not enabled", response.body["error"]["message"])
+
+    def test_enforces_maximum_batch_size(self):
+        rpc = RpcEndpoint(max_batch_size=1)
+        rpc.add_method("echo", lambda _request, _context, params: params)
+
+        response = rpc.handle_payload(
+            [
+                {"jsonrpc": "2.0", "method": "echo", "id": 1},
+                {"jsonrpc": "2.0", "method": "echo", "id": 2},
+            ]
+        )
+
+        self.assertEqual(response.body["error"]["code"], -32600)
+        self.assertIn("maximum of 1", response.body["error"]["message"])
+
+    def test_merges_application_and_request_mapping_contexts(self):
+        rpc = RpcEndpoint({"service": "orders", "user": "application"})
+        rpc.add_method("context", lambda _request, context, _params: context)
+
+        response = rpc.handle_payload(
+            {"jsonrpc": "2.0", "method": "context", "id": 1},
+            {"user": "request", "request_id": "abc"},
+        )
+
+        self.assertEqual(
+            response.body["result"],
+            {"service": "orders", "user": "request", "request_id": "abc"},
+        )
+
+    def test_preserves_both_context_scopes_for_non_mapping_application_context(self):
+        application = object()
+        rpc = RpcEndpoint(application)
+        captured = []
+
+        def capture_context(_request, context, _params):
+            captured.append(context)
+            return "ok"
+
+        rpc.add_method("context", capture_context)
+
+        response = rpc.handle_payload(
+            {"jsonrpc": "2.0", "method": "context", "id": 1},
+            {"request_id": "abc"},
+        )
+        context = captured[0]
+
+        self.assertEqual(response.body["result"], "ok")
+        self.assertIsInstance(context, RpcCallContext)
+        self.assertIs(context.application, application)
+        self.assertEqual(context.request["request_id"], "abc")
+
     def test_enforces_safe_mode_header_in_strict_mode(self):
         rpc = RpcSafeEndpoint()
         rpc.add_method("echo", lambda _request, _context, params: params)

rpc_python_toolkit-0.1.0/src/rpc_python_toolkit/version.py

@@ -1,2 +0,0 @@
-__version__ = "0.1.0"
-