soia-client 1.0.18__py3-none-any.whl → 1.0.20__py3-none-any.whl

soia/_impl/service.py

@@ -1,44 +1,47 @@
 import inspect
 import json
-from collections.abc import Mapping
 from dataclasses import dataclass
-from typing import Any, Callable, Generic, Literal, TypeAlias, Union, cast
+from typing import Any, Callable, Generic, Literal, TypeVar, Union, cast
 
 from soia._impl.method import Method, Request, Response
 
-RequestHeaders: TypeAlias = Mapping[str, str]
+RequestHeaders = TypeVar("RequestHeaders")
 
+ResponseHeaders = TypeVar("ResponseHeaders")
 
-ResponseHeaders: TypeAlias = dict[str, str]
 
-
-class Service:
+class Service(Generic[RequestHeaders, ResponseHeaders]):
     """Wraps around the implementation of a soia service on the server side.
 
     Usage: call '.add_method()' to register method implementations, then call
     '.handle_request()' from the function called by your web framework when an
-    HTTP request is sent to your service's URL.
+    HTTP request is received at your service's endpoint.
 
     Example with Flask:
 
         from flask import Response, request
+        from werkzeug.datastructures import Headers
+
 
-        soia_service = soia.Service()
-        soia_service.add_method(...)
-        soia_service.add_method(...)
+        s = soia.Service[Headers, Headers]()
+        s.add_method(...)
+        s.add_method(...)
 
         @app.route("/myapi", methods=["GET", "POST"])
         def myapi():
             if request.method == "POST":
                 req_body = request.get_data(as_text=True)
             else:
-                req_body = urllib.parse.unquote(request.query_string.decode("utf-8"))
-            req_headers = dict(request.headers)
-            raw_response = soia_service.handle_request(req_body, req_headers, {})
+                query_string = request.query_string.decode("utf-8")
+                req_body = urllib.parse.unquote(query_string)
+            req_headers = request.headers
+            res_headers = Headers()
+            raw_response = s.handle_request(req_body, req_headers, res_headers)
             return Response(
                 raw_response.data,
                 status=raw_response.status_code,
                 content_type=raw_response.content_type,
+                headers=res_headers,
             )
     """
 
@@ -125,7 +128,7 @@ class Service:
         self,
         req_body: str,
         req_headers: RequestHeaders,
-        res_headers: ResponseHeaders | None,
+        res_headers: ResponseHeaders,
     ) -> RawResponse:
         if req_body == "list":
 
@@ -180,7 +183,7 @@ class Service:
             )
 
         try:
-            res: Any = method_impl.impl(req, req_headers, res_headers or {})
+            res: Any = method_impl.impl(req, req_headers, res_headers)
         except Exception as e:
             return self.RawResponse(f"server error: {e}", "server-error")
 
@@ -197,6 +200,6 @@ class Service:
 
 
 @dataclass(frozen=True)
-class _MethodImpl(Generic[Request, Response]):
+class _MethodImpl(Generic[Request, Response, RequestHeaders, ResponseHeaders]):
     method: Method[Request, Response]
     impl: Callable[[Request, RequestHeaders, ResponseHeaders], Response]

{soia_client-1.0.18.dist-info → soia_client-1.0.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soia-client
-Version: 1.0.18
+Version: 1.0.20
 Author-email: Tyler Fibonacci <gepheum@gmail.com>
 License: MIT License
         
@@ -32,3 +32,18 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Dynamic: license-file
+
+# Soia Python Client
+
+Library imported from Python code generated from soia files.
+
+Install with:
+```shell
+pip install soia-client
+```
+
+See:
+
+*   [soia](https://github.com/gepheum/soia): home of the soia compiler
+*   [soia-python-gen](https://github.com/gepheum/soia-python-gen): soia to Python code generator
+*   [soia-python-example](https://github.com/gepheum/soia-python-example): example showing how to use soia's Python code generator in a project

{soia_client-1.0.18.dist-info → soia_client-1.0.20.dist-info}/RECORD

@@ -14,13 +14,13 @@ soia/_impl/primitives.py,sha256=Xk26Fv4oQG2oXd3tS_2sAnJYQdXYX9nva09713AcJvs,8940
 soia/_impl/repr.py,sha256=7WX0bEAVENTjlyZIcbT8TcJylS7IRIyafGCmqaIMxFM,1413
 soia/_impl/serializer.py,sha256=28IwkjtUnLpbnPQfVNfJXkApCK4JhXHwLkC5MVhF8xo,3529
 soia/_impl/serializers.py,sha256=IL9jHHMo11pgrL1-crarOEElvTyV5YM6FTcgumjW6IU,2564
-soia/_impl/service.py,sha256=z8Zj2s8AYAz-Bf1Dm7PRdNvh5FbGpgj5hm2velMBjmc,7052
+soia/_impl/service.py,sha256=GH0vujMDaqRpX8bNQATUPdzJ1V_fjt4eHGCBAjLjlaY,7229
 soia/_impl/service_client.py,sha256=qDntwRyXfLsmXl4ELfOkh-fgv553nrGy72K0JghLM80,2734
 soia/_impl/structs.py,sha256=YTc3Ykj2TxPquar2XsP2DhFfkfIoELXOveyd8yTqN90,26545
 soia/_impl/timestamp.py,sha256=lXBNH8mPmzflkNjSKZSBl2XS-ot9N8N92B_zGO2SMtU,4078
 soia/_impl/type_adapter.py,sha256=RyIyh4Fnt9rMy0HRzC-a2v2JAdZsV9FBzoGEUVygVRE,2101
-soia_client-1.0.18.dist-info/licenses/LICENSE,sha256=SaAftKkX6hfSOiPdENQPS70tifH3PDHgazq8eK2Pwfw,1064
-soia_client-1.0.18.dist-info/METADATA,sha256=2KPUoHzmxfNNNQ6Dnj4XYPbu8nHZpQzs2Dbt17GXGq0,1667
-soia_client-1.0.18.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-soia_client-1.0.18.dist-info/top_level.txt,sha256=lsYG9JrvauFe1oIV5zvnwsS9hsx3ztwfK_937op9mxc,5
-soia_client-1.0.18.dist-info/RECORD,,
+soia_client-1.0.20.dist-info/licenses/LICENSE,sha256=SaAftKkX6hfSOiPdENQPS70tifH3PDHgazq8eK2Pwfw,1064
+soia_client-1.0.20.dist-info/METADATA,sha256=7HocgiYValsPhLrZnucq5U1m-AIF3aRBQn5RZjXLl0o,2122
+soia_client-1.0.20.dist-info/WHEEL,sha256=GHB6lJx2juba1wDgXDNlMTyM13ckjBMKf-OnwgKOCtA,91
+soia_client-1.0.20.dist-info/top_level.txt,sha256=lsYG9JrvauFe1oIV5zvnwsS9hsx3ztwfK_937op9mxc,5
+soia_client-1.0.20.dist-info/RECORD,,

{soia_client-1.0.18.dist-info → soia_client-1.0.20.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (78.1.0)
+Generator: setuptools (80.3.0)
 Root-Is-Purelib: true
 Tag: py3-none-any