runtimepy 5.15.7__tar.gz → 5.15.8__tar.gz

{runtimepy-5.15.7/runtimepy.egg-info → runtimepy-5.15.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtimepy
-Version: 5.15.7
+Version: 5.15.8
 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: websockets
-Requires-Dist: svgen>=0.8.0
+Requires-Dist: psutil
 Requires-Dist: vcorelib>=3.6.4
+Requires-Dist: svgen>=0.8.0
+Requires-Dist: websockets
 Requires-Dist: aiofiles
-Requires-Dist: psutil
 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.3
-    hash=fd0b9f87927033d8ee2eb5448d8aec76
+    hash=c354cb6439439285d244ad2bdcc32cc8
     =====================================
 -->
 
-# runtimepy ([5.15.7](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.15.8](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.15.7 → runtimepy-5.15.8}/README.md

@@ -2,11 +2,11 @@
     =====================================
     generator=datazen
     version=3.2.3
-    hash=fd0b9f87927033d8ee2eb5448d8aec76
+    hash=c354cb6439439285d244ad2bdcc32cc8
     =====================================
 -->
 
-# runtimepy ([5.15.7](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.15.8](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.15.7 → runtimepy-5.15.8}/pyproject.toml

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

{runtimepy-5.15.7 → runtimepy-5.15.8}/runtimepy/__init__.py

@@ -1,7 +1,7 @@
 # =====================================
 # generator=datazen
 # version=3.2.3
-# hash=7591d3ee09b156575678bdf806e1b5c7
+# hash=be3f79364e840f1950bc121205810f02
 # =====================================
 
 """
@@ -10,7 +10,7 @@ Useful defaults and other package metadata.
 
 DESCRIPTION = "A framework for implementing Python services."
 PKG_NAME = "runtimepy"
-VERSION = "5.15.7"
+VERSION = "5.15.8"
 
 # runtimepy-specific content.
 METRICS_NAME = "metrics"

{runtimepy-5.15.7 → runtimepy-5.15.8}/runtimepy/net/http/response.py

@@ -3,11 +3,12 @@ A module implementing HTTP-response interfaces.
 """
 
 # built-in
+from abc import ABC, abstractmethod
 import http
 from io import StringIO
 import logging
 from pathlib import Path
-from typing import AsyncIterator, cast
+from typing import AsyncIterator, Optional, cast
 
 # third-party
 import aiofiles
@@ -96,19 +97,32 @@ class ResponseHeader(HeadersMixin):
         self["Cache-Control"] = value
 
 
-class AsyncResponse:
+class AsyncResponse(ABC):
+    """Interface for asynchronous responses."""
+
+    @abstractmethod
+    async def size(self) -> Optional[int]:
+        """Get this response's size."""
+
+    @abstractmethod
+    async def process(self) -> AsyncIterator[bytes]:
+        """Yield chunks to write asynchronously."""
+        yield bytes()  # pragma: nocover
+
+
+class AsyncFile(AsyncResponse):
     """
     A class facilitating asynchronous server responses for e.g.
     file-system files.
     """
 
-    def __init__(self, path: Path, chunk_size: int = 1024) -> None:
+    def __init__(self, path: Path, chunk_size: int = 4096) -> None:
         """Initialize this instance."""
 
         self.path = path
         self.chunk_size = chunk_size
 
-    async def size(self) -> int:
+    async def size(self) -> Optional[int]:
         """Get this response's size."""
         return cast(int, await aiofiles.os.path.getsize(self.path))
 

{runtimepy-5.15.7 → runtimepy-5.15.8}/runtimepy/net/server/__init__.py

@@ -8,7 +8,7 @@ from io import StringIO
 import logging
 import mimetypes
 from pathlib import Path
-from typing import Any, Optional, TextIO, Union
+from typing import Any, Awaitable, Callable, Optional, TextIO, Union
 from urllib.parse import urlencode
 
 # third-party
@@ -22,7 +22,7 @@ from runtimepy.channel.environment.command import GLOBAL, global_command
 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 AsyncResponse, ResponseHeader
+from runtimepy.net.http.response import AsyncFile, 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 DIR_FILE, markdown_for_dir
@@ -41,11 +41,17 @@ def package_data_dir() -> Path:
     return result.parent
 
 
+CustomAsync = Callable[
+    [ResponseHeader, RequestHeader, Optional[bytearray]], Awaitable[HttpResult]
+]
+
+
 class RuntimepyServerConnection(HttpConnection):
     """A class implementing a server-connection interface for this package."""
 
     # Can register application methods to URL paths.
     apps: HtmlApps = {"/mux.html": mux_app}
+    custom: dict[str, CustomAsync] = {}
     default_app: Optional[HtmlApp] = None
 
     # Can load additional data into this dictionary for easy HTTP access.
@@ -245,7 +251,7 @@ class RuntimepyServerConnection(HttpConnection):
                 response.static_resource()
 
                 # Return the file data.
-                result = AsyncResponse(candidate)
+                result = AsyncFile(candidate)
                 break
 
         # Handle a directory as a last resort.
@@ -335,6 +341,12 @@ class RuntimepyServerConnection(HttpConnection):
                     response.static_resource()
                     return self.favicon_data
 
+                # Check for a custom handler.
+                if path in self.custom:
+                    return await self.custom[path](
+                        response, request, request_data
+                    )
+
                 # Try serving a file and handling redirects.
                 for handler in [self.try_redirect, self.try_file]:
                     result = await handler(

{runtimepy-5.15.7 → runtimepy-5.15.8}/runtimepy/net/tcp/http/__init__.py

@@ -173,13 +173,13 @@ class HttpConnection(_TcpConnection):
     ) -> None:
         """Send a request or response to a request."""
 
-        # Set content length.
-        header["content-length"] = "0"
-
+        size = None
         if isinstance(data, AsyncResponse):
-            header["content-length"] = str(await data.size())
+            size = await data.size()
         elif data is not None:
-            header["content-length"] = str(len(data))
+            size = len(data)
+        if size is not None:
+            header["content-length"] = str(size)
 
         self.send_binary(bytes(header))
 

{runtimepy-5.15.7 → runtimepy-5.15.8/runtimepy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtimepy
-Version: 5.15.7
+Version: 5.15.8
 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: websockets
-Requires-Dist: svgen>=0.8.0
+Requires-Dist: psutil
 Requires-Dist: vcorelib>=3.6.4
+Requires-Dist: svgen>=0.8.0
+Requires-Dist: websockets
 Requires-Dist: aiofiles
-Requires-Dist: psutil
 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.3
-    hash=fd0b9f87927033d8ee2eb5448d8aec76
+    hash=c354cb6439439285d244ad2bdcc32cc8
     =====================================
 -->
 
-# runtimepy ([5.15.7](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.15.8](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)