runtimepy 5.12.2__tar.gz → 5.13.0__tar.gz

{runtimepy-5.12.2/runtimepy.egg-info → runtimepy-5.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtimepy
-Version: 5.12.2
+Version: 5.13.0
 Summary: A framework for implementing Python services.
 Home-page: https://github.com/libre-embedded/runtimepy
 Author: Libre Embedded
@@ -17,11 +17,11 @@ Classifier: Development Status :: 5 - Production/Stable
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiofiles
 Requires-Dist: psutil
-Requires-Dist: websockets
+Requires-Dist: aiofiles
 Requires-Dist: vcorelib>=3.5.1
 Requires-Dist: svgen>=0.7.4
+Requires-Dist: websockets
 Provides-Extra: test
 Requires-Dist: pylint; extra == "test"
 Requires-Dist: flake8; extra == "test"
@@ -51,11 +51,11 @@ Dynamic: requires-python
     =====================================
     generator=datazen
     version=3.2.1
-    hash=c4f50a5547bbff6a73c98b12f4a8ee75
+    hash=4f0e82dc45d3ea9c4ccf5b262413c206
     =====================================
 -->
 
-# runtimepy ([5.12.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.13.0](https://pypi.org/project/runtimepy/))
 
 [![python](https://img.shields.io/pypi/pyversions/runtimepy.svg)](https://pypi.org/project/runtimepy/)
 ![Build Status](https://github.com/libre-embedded/runtimepy/workflows/Python%20Package/badge.svg)

{runtimepy-5.12.2 → runtimepy-5.13.0}/README.md

@@ -2,11 +2,11 @@
     =====================================
     generator=datazen
     version=3.2.1
-    hash=c4f50a5547bbff6a73c98b12f4a8ee75
+    hash=4f0e82dc45d3ea9c4ccf5b262413c206
     =====================================
 -->
 
-# runtimepy ([5.12.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.13.0](https://pypi.org/project/runtimepy/))
 
 [![python](https://img.shields.io/pypi/pyversions/runtimepy.svg)](https://pypi.org/project/runtimepy/)
 ![Build Status](https://github.com/libre-embedded/runtimepy/workflows/Python%20Package/badge.svg)

{runtimepy-5.12.2 → runtimepy-5.13.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta:__legacy__"
 
 [project]
 name = "runtimepy"
-version = "5.12.2"
+version = "5.13.0"
 description = "A framework for implementing Python services."
 readme = "README.md"
 requires-python = ">=3.12"

{runtimepy-5.12.2 → runtimepy-5.13.0}/runtimepy/__init__.py

@@ -1,7 +1,7 @@
 # =====================================
 # generator=datazen
 # version=3.2.1
-# hash=15077f6e9231129c803ebd9d9db1a5e1
+# hash=35e5555173fdfd064e5047172de9b6a4
 # =====================================
 
 """
@@ -10,7 +10,7 @@ Useful defaults and other package metadata.
 
 DESCRIPTION = "A framework for implementing Python services."
 PKG_NAME = "runtimepy"
-VERSION = "5.12.2"
+VERSION = "5.13.0"
 
 # runtimepy-specific content.
 METRICS_NAME = "metrics"

{runtimepy-5.12.2 → runtimepy-5.13.0}/runtimepy/commands/server.py

@@ -48,7 +48,6 @@ def get_kwargs(args: _Namespace, **kwargs) -> dict[str, Any]:
     new_kwargs: dict[str, Any] = {**kwargs}
 
     # Pass additional arguments through.
-    print(args)
     for opt in PASSTHROUGH:
         value = getattr(args, opt, None)
         if value is not None:

{runtimepy-5.12.2 → runtimepy-5.13.0}/runtimepy/net/http/response.py

@@ -6,8 +6,12 @@ A module implementing HTTP-response interfaces.
 import http
 from io import StringIO
 import logging
+from pathlib import Path
+from typing import AsyncIterator, cast
 
 # third-party
+import aiofiles
+import aiofiles.os
 from vcorelib.logging import LoggerType
 
 # internal
@@ -83,3 +87,31 @@ class ResponseHeader(HeadersMixin):
             self.status_line,
             self.headers,
         )
+
+
+class AsyncResponse:
+    """
+    A class facilitating asynchronous server responses for e.g.
+    file-system files.
+    """
+
+    def __init__(self, path: Path, chunk_size: int = 1024) -> None:
+        """Initialize this instance."""
+
+        self.path = path
+        self.chunk_size = chunk_size
+
+    async def size(self) -> int:
+        """Get this response's size."""
+        return cast(int, await aiofiles.os.path.getsize(self.path))
+
+    async def process(self) -> AsyncIterator[bytes]:
+        """Yield chunks to write asynchronously."""
+
+        async with aiofiles.open(self.path, mode="rb") as path_fd:
+            while True:
+                data = await path_fd.read(self.chunk_size)
+                if data:
+                    yield data
+                else:
+                    break

{runtimepy-5.12.2 → runtimepy-5.13.0}/runtimepy/net/server/__init__.py

@@ -21,11 +21,11 @@ from runtimepy.channel.environment.command import GLOBAL
 from runtimepy.net.html import full_markdown_page
 from runtimepy.net.http.header import RequestHeader
 from runtimepy.net.http.request_target import PathMaybeQuery
-from runtimepy.net.http.response import ResponseHeader
+from runtimepy.net.http.response import AsyncResponse, ResponseHeader
 from runtimepy.net.server.html import HtmlApp, HtmlApps, get_html, html_handler
 from runtimepy.net.server.json import encode_json, json_handler
 from runtimepy.net.server.markdown import markdown_for_dir
-from runtimepy.net.tcp.http import HttpConnection
+from runtimepy.net.tcp.http import HttpConnection, HttpResult
 from runtimepy.util import normalize_root, path_has_part, read_binary
 
 MIMETYPES_INIT = False
@@ -173,10 +173,10 @@ class RuntimepyServerConnection(HttpConnection):
 
     async def try_file(
         self, path: PathMaybeQuery, response: ResponseHeader
-    ) -> Optional[bytes]:
+    ) -> HttpResult:
         """Try serving this path as a file directly from the file-system."""
 
-        result = None
+        result: HttpResult = None
 
         # Keep track of directories encountered.
         directories: list[Path] = []
@@ -214,7 +214,7 @@ class RuntimepyServerConnection(HttpConnection):
                 self.logger.info("Serving '%s' (MIME: %s)", candidate, mime)
 
                 # Return the file data.
-                result = await read_binary(candidate)
+                result = AsyncResponse(candidate)
                 break
 
         # Handle a directory as a last resort.
@@ -259,7 +259,7 @@ class RuntimepyServerConnection(HttpConnection):
         response: ResponseHeader,
         request: RequestHeader,
         request_data: Optional[bytes],
-    ) -> Optional[bytes]:
+    ) -> HttpResult:
         """Handle POST requests."""
 
         request.log(self.logger, False, level=logging.INFO)
@@ -281,7 +281,7 @@ class RuntimepyServerConnection(HttpConnection):
         response: ResponseHeader,
         request: RequestHeader,
         request_data: Optional[bytes],
-    ) -> Optional[bytes]:
+    ) -> HttpResult:
         """Handle GET requests."""
 
         request.log(self.logger, False, level=logging.INFO)

{runtimepy-5.12.2 → runtimepy-5.13.0}/runtimepy/net/tcp/http/__init__.py

@@ -16,22 +16,24 @@ from vcorelib import DEFAULT_ENCODING
 from runtimepy import PKG_NAME, VERSION
 from runtimepy.net.http import HttpMessageProcessor
 from runtimepy.net.http.header import RequestHeader
-from runtimepy.net.http.response import ResponseHeader
+from runtimepy.net.http.response import AsyncResponse, ResponseHeader
 from runtimepy.net.tcp.connection import TcpConnection as _TcpConnection
 
+HttpResult = Optional[bytes | AsyncResponse]
+
 #
 # async def handler(
 #     response: ResponseHeader,
 #     request: RequestHeader,
 #     request_data: Optional[bytes],
-# ) -> Optional[bytes]:
+# ) -> HttpResult:
 #     """Sample handler."""
 #
 HttpRequestHandler = Callable[
     [ResponseHeader, RequestHeader, Optional[bytes]],
-    Awaitable[Optional[bytes]],
+    Awaitable[HttpResult],
 ]
-HttpResponse = Tuple[ResponseHeader, Optional[bytes]]
+HttpResponse = Tuple[ResponseHeader, HttpResult]
 
 HttpRequestHandlers = dict[http.HTTPMethod, HttpRequestHandler]
 
@@ -89,7 +91,7 @@ class HttpConnection(_TcpConnection):
         response: ResponseHeader,
         request: RequestHeader,
         request_data: Optional[bytes],
-    ) -> Optional[bytes]:
+    ) -> HttpResult:
         """Sample handler."""
 
     async def post_handler(
@@ -97,7 +99,7 @@ class HttpConnection(_TcpConnection):
         response: ResponseHeader,
         request: RequestHeader,
         request_data: Optional[bytes],
-    ) -> Optional[bytes]:
+    ) -> HttpResult:
         """Sample handler."""
 
     async def _process_request(
@@ -105,7 +107,7 @@ class HttpConnection(_TcpConnection):
         response: ResponseHeader,
         request_header: RequestHeader,
         request_data: Optional[bytes] = None,
-    ) -> Optional[bytes]:
+    ) -> HttpResult:
         """Process an individual request."""
 
         result = None
@@ -137,7 +139,7 @@ class HttpConnection(_TcpConnection):
             # Set boilerplate header data.
             request["user-agent"] = self.identity
 
-            self._send(request, data)
+            await self._send(request, data)
             self.expecting_response = True
             result = await self.responses.get()
             self.expecting_response = False
@@ -153,21 +155,29 @@ class HttpConnection(_TcpConnection):
         """
         return to_json(await self.request(request, data))
 
-    def _send(
+    async def _send(
         self,
         header: Union[ResponseHeader, RequestHeader],
-        data: Optional[bytes] = None,
+        data: HttpResult = None,
     ) -> None:
         """Send a request or response to a request."""
 
         # Set content length.
         header["content-length"] = "0"
-        if data:
+
+        if isinstance(data, AsyncResponse):
+            header["content-length"] = str(await data.size())
+        elif data is not None:
             header["content-length"] = str(len(data))
 
         self.send_binary(bytes(header))
-        if data:
-            self.send_binary(data)
+
+        if data is not None:
+            if isinstance(data, AsyncResponse):
+                async for chunk in data.process():
+                    self.send_binary(chunk)
+            else:
+                self.send_binary(data)
 
         header.log(self.logger, True)
 
@@ -183,7 +193,7 @@ class HttpConnection(_TcpConnection):
             if not self.expecting_response:
                 # Process request.
                 response = ResponseHeader()
-                self._send(
+                await self._send(
                     response,
                     await self._process_request(
                         response, cast(RequestHeader, header), payload

{runtimepy-5.12.2 → runtimepy-5.13.0/runtimepy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtimepy
-Version: 5.12.2
+Version: 5.13.0
 Summary: A framework for implementing Python services.
 Home-page: https://github.com/libre-embedded/runtimepy
 Author: Libre Embedded
@@ -17,11 +17,11 @@ Classifier: Development Status :: 5 - Production/Stable
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiofiles
 Requires-Dist: psutil
-Requires-Dist: websockets
+Requires-Dist: aiofiles
 Requires-Dist: vcorelib>=3.5.1
 Requires-Dist: svgen>=0.7.4
+Requires-Dist: websockets
 Provides-Extra: test
 Requires-Dist: pylint; extra == "test"
 Requires-Dist: flake8; extra == "test"
@@ -51,11 +51,11 @@ Dynamic: requires-python
     =====================================
     generator=datazen
     version=3.2.1
-    hash=c4f50a5547bbff6a73c98b12f4a8ee75
+    hash=4f0e82dc45d3ea9c4ccf5b262413c206
     =====================================
 -->
 
-# runtimepy ([5.12.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.13.0](https://pypi.org/project/runtimepy/))
 
 [![python](https://img.shields.io/pypi/pyversions/runtimepy.svg)](https://pypi.org/project/runtimepy/)
 ![Build Status](https://github.com/libre-embedded/runtimepy/workflows/Python%20Package/badge.svg)