soia-client 1.0.18__tar.gz → 1.0.20__tar.gz

{soia_client-1.0.18 → soia_client-1.0.20}/PKG-INFO

@@ -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.20/README.md

@@ -0,0 +1,14 @@
+# 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 → soia_client-1.0.20}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "soia-client"
-version = "1.0.18"
+version = "1.0.20"
 description = ""
 readme = "README.md"
 authors = [{ name = "Tyler Fibonacci", email = "gepheum@gmail.com" }]

{soia_client-1.0.18 → soia_client-1.0.20}/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 → soia_client-1.0.20}/soia_client.egg-info/PKG-INFO

@@ -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 → soia_client-1.0.20}/soia_client.egg-info/SOURCES.txt

@@ -1,5 +1,5 @@
 LICENSE
-README
+README.md
 pyproject.toml
 soia/__init__.py
 soia/_module_initializer.py

soia_client-1.0.18/README

@@ -1,5 +0,0 @@
-python3 -m unittest tests/**.py
-
-pyright
-flake8
-black-formatter