runtimepy 5.15.5__py3-none-any.whl → 5.15.6__py3-none-any.whl

runtimepy/__init__.py

@@ -1,7 +1,7 @@
 # =====================================
 # generator=datazen
 # version=3.2.3
-# hash=8ce7abe0f8c0e64d9afc0b5e4de6e2ad
+# hash=08c1dda8bd5fefe13af6a8eb49063498
 # =====================================
 
 """
@@ -10,7 +10,7 @@ Useful defaults and other package metadata.
 
 DESCRIPTION = "A framework for implementing Python services."
 PKG_NAME = "runtimepy"
-VERSION = "5.15.5"
+VERSION = "5.15.6"
 
 # runtimepy-specific content.
 METRICS_NAME = "metrics"

runtimepy/net/server/markdown.py

@@ -4,10 +4,12 @@ A module implementing web server markdown interfaces.
 
 # built-in
 from io import StringIO
+import mimetypes
 from pathlib import Path
 from typing import Iterable, cast
 
 # third-party
+from svgen.element.html import div
 from vcorelib.io.file_writer import IndentedFileWriter
 from vcorelib.math.time import byte_count_str
 from vcorelib.paths import rel
@@ -17,6 +19,58 @@ LOGO_MARKDOWN = "[![logo](/static/png/chip-circle-bootstrap/128x128.png)](/)"
 DIR_FILE = "dir.html"
 
 
+def file_preview(path: Path, link: Path) -> str:
+    """Get possible preview text for a file."""
+
+    preview = ""
+
+    if path.is_file():
+        mime, _ = mimetypes.guess_type(path, strict=False)
+        if mime and mime.startswith("image"):
+            preview = div(tag="img", src=f"/{link}", alt=str(link)).encode_str(
+                newlines=False
+            )
+
+    return preview
+
+
+def write_markdown_dir(
+    writer: IndentedFileWriter, path: Path, base: Path
+) -> None:
+    """Write markdown contents for a single directory."""
+
+    curr_dir = rel(path, base=base)
+
+    line = f"### `{base.name}/{curr_dir}`"
+
+    # Link to go up a directory.
+    if curr_dir != Path():
+        line += f" ([..](/{curr_dir.parent}/{DIR_FILE}))"
+
+    writer.write(line)
+    writer.empty()
+
+    writer.write("| name | size | preview |")
+    writer.write("|------|------|---------|")
+
+    for item in sorted(path.iterdir()):
+        curr = rel(item, base=base)
+
+        name = f"`{curr.name}`"
+        if item.is_dir():
+            name = f"**{name}**"
+
+        stats = _stats(item)
+        assert stats
+        size_str = byte_count_str(stats.st_size) if item.is_file() else ""
+
+        writer.write(
+            f"| [{name}](/{curr}) | {size_str} | {file_preview(item, curr)} |"
+        )
+
+    writer.empty()
+
+
 def markdown_for_dir(
     paths_bases: Iterable[tuple[Path, Path]],
     extra_links: dict[str, Iterable[str]] = None,
@@ -40,31 +94,7 @@ def markdown_for_dir(
         writer.empty()
 
         for path, base in paths_bases:
-            curr_dir = rel(path, base=base)
-            writer.write(f"### `{base.name}/{curr_dir}`")
-            writer.empty()
-
-            # Link to go up a directory.
-            if curr_dir != Path():
-                writer.write(f"* [..](/{curr_dir.parent}/{DIR_FILE})")
-
-            writer.write("| name | size |")
-            writer.write("|------|------|")
-            for item in sorted(path.iterdir()):
-                curr = rel(item, base=base)
-
-                name = f"`{curr.name}`"
-                if item.is_dir():
-                    name = f"**{name}**"
-
-                stats = _stats(item)
-                assert stats
-                size_str = (
-                    byte_count_str(stats.st_size) if item.is_file() else ""
-                )
-                writer.write(f"| [{name}](/{curr}) | {size_str} |")
-
-            writer.empty()
+            write_markdown_dir(writer, path, base)
 
         result: str = cast(StringIO, writer.stream).getvalue()
 

{runtimepy-5.15.5.dist-info → runtimepy-5.15.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtimepy
-Version: 5.15.5
+Version: 5.15.6
 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: psutil
-Requires-Dist: svgen>=0.8.0
 Requires-Dist: aiofiles
-Requires-Dist: vcorelib>=3.6.4
+Requires-Dist: svgen>=0.8.0
 Requires-Dist: websockets
+Requires-Dist: psutil
+Requires-Dist: vcorelib>=3.6.4
 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=fd0e57419cf9437a64c4f82cae3625f0
+    hash=0f8ffdbd46445346cb834d066f58e765
     =====================================
 -->
 
-# runtimepy ([5.15.5](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.15.6](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.5.dist-info → runtimepy-5.15.6.dist-info}/RECORD

@@ -1,4 +1,4 @@
-runtimepy/__init__.py,sha256=wVKBUb0d3kdEu2RAyDqlguPD6weDDr_KQAXrx0YQlCY,391
+runtimepy/__init__.py,sha256=qAS3P1hKgQCdNqiMTEqhiSnIM9BIwdZqBvOQfrZCBC4,391
 runtimepy/__main__.py,sha256=IKioH2xOtsXwrwb9zABDQEJvuAX--Lnh84TeSz0XSs0,332
 runtimepy/app.py,sha256=Er1ZKKrG9U0FV0gQg_GYF9xDb89HgYnVzS5SjxGa2Tg,970
 runtimepy/dev_requirements.txt,sha256=VZhW6bJ5YbwaoN4d_XxZFuN5BbDLaG7ngKrGnugVPRw,245
@@ -205,7 +205,7 @@ runtimepy/net/http/version.py,sha256=mp6rgIM7-VUVKLCA0Uw96CmBkL0ET860lDVVEewpZ7w
 runtimepy/net/server/__init__.py,sha256=ppfMgymYGRz13MvHvwXyy9WAos2wWgaZDf1TW8D1ILU,11813
 runtimepy/net/server/html.py,sha256=OB2K37kA7MHtcKqp0pZE1q_XgiyvfooigzS0-OQFCCM,1900
 runtimepy/net/server/json.py,sha256=AaMPw-G-7xX67mf1LvQAipNdwrnmbLDunVlkWf6iOz0,2526
-runtimepy/net/server/markdown.py,sha256=UIJ9R9WM5XodPs8WEevFNJ3LX9tMevhUe8QKKdeY4ak,2143
+runtimepy/net/server/markdown.py,sha256=KuPKYh7nj5oy70Ff8LRAXwr_Ga4r8_3KksvDfPfFqYM,2690
 runtimepy/net/server/mux.py,sha256=ejET7NpJzzJjkVwR8laSuZYR79DOT3XazmAIm6rENSE,598
 runtimepy/net/server/app/__init__.py,sha256=0eCcqYvmby_wQTGqAiGbGM5LCxKM2qpjuIT0gLHsoDU,3157
 runtimepy/net/server/app/base.py,sha256=46aOqZwRss_nh_WfEH1cMJ9GUVoLJjERd7cTRFu6mXE,1878
@@ -311,9 +311,9 @@ runtimepy/tui/channels/__init__.py,sha256=evDaiIn-YS9uGhdo8ZGtP9VK1ek6sr_P1nJ9Ju
 runtimepy/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 runtimepy/ui/button.py,sha256=8MXnhqmVvANwbbTA8gu3b8N4IIvRYicnwxFQD6SZy3U,2045
 runtimepy/ui/controls.py,sha256=L55Af-4vGq6ZHewdoA7C_mAYq35WXl8NzOdcsmQIo7M,1868
-runtimepy-5.15.5.dist-info/licenses/LICENSE,sha256=yKBRwbO-cOPBrlpsZmJkkSa33DfY31aE8t7lZ0DwlUo,1071
-runtimepy-5.15.5.dist-info/METADATA,sha256=zAY7eYIZrG229MNSE6k3wZUyz7nVDQ78DJPS4nlPFGA,9268
-runtimepy-5.15.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-runtimepy-5.15.5.dist-info/entry_points.txt,sha256=-btVBkYv7ybcopqZ_pRky-bEzu3vhbaG3W3Z7ERBiFE,51
-runtimepy-5.15.5.dist-info/top_level.txt,sha256=0jPmh6yqHyyJJDwEID-LpQly-9kQ3WRMjH7Lix8peLg,10
-runtimepy-5.15.5.dist-info/RECORD,,
+runtimepy-5.15.6.dist-info/licenses/LICENSE,sha256=yKBRwbO-cOPBrlpsZmJkkSa33DfY31aE8t7lZ0DwlUo,1071
+runtimepy-5.15.6.dist-info/METADATA,sha256=MoIujpmp5ifEdr-DxKZrNXyHuFSUoeS6iX0iIyqdW2w,9268
+runtimepy-5.15.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+runtimepy-5.15.6.dist-info/entry_points.txt,sha256=-btVBkYv7ybcopqZ_pRky-bEzu3vhbaG3W3Z7ERBiFE,51
+runtimepy-5.15.6.dist-info/top_level.txt,sha256=0jPmh6yqHyyJJDwEID-LpQly-9kQ3WRMjH7Lix8peLg,10
+runtimepy-5.15.6.dist-info/RECORD,,