wapyt 0.2.0.dev1__tar.gz → 0.2.0.dev2__tar.gz

{wapyt-0.2.0.dev1 → wapyt-0.2.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wapyt
-Version: 0.2.0.dev1
+Version: 0.2.0.dev2
 Summary: DHTMLX-free pyTincture widgetset: layouts, forms, tables, trees, chat, terminal, menus, Kanban and more, declared in Python and rendered in the browser.
 License: MIT
 Project-URL: homepage, https://github.com/WAwesome-AI/wa_pytincture_widgetset
@@ -38,6 +38,7 @@ Description-Content-Type: text/markdown
 - `Popup` and tooltips: An anchored popover for pickers, help and small forms; styled, keyboard-reachable tooltips that replace native `title` text across the widgets.
 - `ProgressBar` / `progress_html`: Determinate or indeterminate bars with active/done/error/paused states, as a live widget or static markup.
 - `Pagination`: First/previous/next/last, a page box or numbered buttons, a page-size selector and a "1–50 of 1,234" summary; copes with totals the server could not count.
+- `MediaPlayer`: Video and audio with a queue — the picture in place, an audio bar that can dock to the foot of the window, or a compact inline player for a chat message; HLS through bundled hls.js, WebVTT subtitles, items whose URL is resolved only when reached, exclusive groups, keyboard and OS media keys, buttons of the app's own in the bar (`MediaAction`, `on_action`: "add to playlist", "save"), and any media source: files from disk, a CDN, cookies, Bearer headers (`MediaItem(headers=…)`), expiring signed URLs (`refresh()`), live streams (`live=True`) and a Quality menu.
 
 ## Runtime Architecture
 - Layouts and widgets are declared in Python but render as DOM nodes through the JavaScript bundles under `wapyt/assets/`. Each helper (e.g., `Layout.add_chat`) forwards config dictionaries directly to the matching JS constructor.

{wapyt-0.2.0.dev1 → wapyt-0.2.0.dev2}/README.md

@@ -26,6 +26,7 @@
 - `Popup` and tooltips: An anchored popover for pickers, help and small forms; styled, keyboard-reachable tooltips that replace native `title` text across the widgets.
 - `ProgressBar` / `progress_html`: Determinate or indeterminate bars with active/done/error/paused states, as a live widget or static markup.
 - `Pagination`: First/previous/next/last, a page box or numbered buttons, a page-size selector and a "1–50 of 1,234" summary; copes with totals the server could not count.
+- `MediaPlayer`: Video and audio with a queue — the picture in place, an audio bar that can dock to the foot of the window, or a compact inline player for a chat message; HLS through bundled hls.js, WebVTT subtitles, items whose URL is resolved only when reached, exclusive groups, keyboard and OS media keys, buttons of the app's own in the bar (`MediaAction`, `on_action`: "add to playlist", "save"), and any media source: files from disk, a CDN, cookies, Bearer headers (`MediaItem(headers=…)`), expiring signed URLs (`refresh()`), live streams (`live=True`) and a Quality menu.
 
 ## Runtime Architecture
 - Layouts and widgets are declared in Python but render as DOM nodes through the JavaScript bundles under `wapyt/assets/`. Each helper (e.g., `Layout.add_chat`) forwards config dictionaries directly to the matching JS constructor.

{wapyt-0.2.0.dev1 → wapyt-0.2.0.dev2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "wapyt"
-version = "0.2.0.dev1"
+version = "0.2.0.dev2"
 description = "DHTMLX-free pyTincture widgetset: layouts, forms, tables, trees, chat, terminal, menus, Kanban and more, declared in Python and rendered in the browser."
 readme = "README.md"
 license = { text = "MIT" }

wapyt-0.2.0.dev2/tests/test_mediaplayer.py

@@ -0,0 +1,127 @@
+"""CPython tests for the MediaPlayer config (no browser needed)."""
+from __future__ import annotations
+
+import pytest
+
+import wapyt
+from wapyt import MediaItem, MediaPlayerConfig, MediaTextTrack
+from wapyt.mediaplayer.mediaplayer import resolve_patch
+
+
+def test_exported_with_a_layout_helper():
+    from wapyt.layout.layout import Layout
+    assert {"MediaPlayer", "MediaPlayerConfig", "MediaItem", "MediaTextTrack"} <= set(wapyt.__all__)
+    assert hasattr(Layout, "add_mediaplayer")
+
+
+def test_defaults_are_minimal():
+    assert MediaPlayerConfig().to_dict() == {"mode": "auto"}
+    assert MediaItem("/a.mp4").to_dict() == {"src": "/a.mp4"}
+    assert MediaTextTrack("/a.vtt").to_dict() == {"src": "/a.vtt"}
+
+
+def test_an_item_without_src_is_allowed():
+    # Resolved when it becomes current (the "resolve" event).
+    assert MediaItem(title="Later", data={"id": 7}).to_dict() == {"title": "Later", "data": {"id": 7}}
+
+
+def test_options_are_camel_cased():
+    payload = MediaPlayerConfig(
+        items=[MediaItem("/a.m3u8", title="A", subtitle="S", album="Al", poster="/p.jpg", type="hls",
+                         kind="video", start=12.5, data={"id": 1},
+                         text_tracks=[MediaTextTrack("/a.vtt", "English", "en", kind="captions", default=True)])],
+        mode="audio", autoplay=True, controls=False, muted=True, volume=0.5, rate=1.5, repeat="all",
+        shuffle=True, dock="bottom", group="chat", keyboard=False, media_session=False, queue_line=False,
+        show_shuffle=False, show_repeat=False, time_update_interval=0, preload="none",
+        cross_origin="anonymous", hls_config={"maxBufferLength": 30}, height=64, empty_text="—",
+        aria_label="Music",
+    ).to_dict()
+    assert payload["items"] == [{"src": "/a.m3u8", "title": "A", "subtitle": "S", "album": "Al", "poster": "/p.jpg",
+                                 "type": "hls", "kind": "video", "start": 12.5, "data": {"id": 1},
+                                 "textTracks": [{"src": "/a.vtt", "label": "English", "language": "en",
+                                                 "kind": "captions", "default": True}]}]
+    for key, value in {"mode": "audio", "autoplay": True, "controls": False, "muted": True, "volume": 0.5,
+                       "rate": 1.5, "repeat": "all", "shuffle": True, "dock": "bottom", "group": "chat",
+                       "keyboard": False, "mediaSession": False, "queueLine": False, "showShuffle": False,
+                       "showRepeat": False, "timeUpdateInterval": 0, "preload": "none",
+                       "crossOrigin": "anonymous", "hlsConfig": {"maxBufferLength": 30}, "height": 64,
+                       "emptyText": "—", "ariaLabel": "Music"}.items():
+        assert payload[key] == value, key
+
+
+def test_dict_items_pass_through():
+    assert MediaPlayerConfig(items=[{"src": "/x.mp3"}]).to_dict()["items"] == [{"src": "/x.mp3"}]
+
+
+@pytest.mark.parametrize("bad", [dict(mode="theatre"), dict(repeat="twice"), dict(dock="top"), dict(preload="all"),
+                                 dict(cross_origin="yes"), dict(volume=1.5), dict(rate=8),
+                                 dict(time_update_interval=-1),
+                                 dict(items=[MediaItem("/a.mp4")], start_index=1)])
+def test_invalid_configs(bad):
+    with pytest.raises(ValueError):
+        MediaPlayerConfig(**bad).to_dict()
+
+
+@pytest.mark.parametrize("bad", [dict(kind="podcast"), dict(start=-1), dict(data={1, 2})])
+def test_invalid_items(bad):
+    with pytest.raises(ValueError):
+        MediaItem("/a.mp4", **bad).to_dict()
+
+
+def test_invalid_text_tracks():
+    with pytest.raises(ValueError):
+        MediaTextTrack("/a.vtt", kind="karaoke").to_dict()
+    with pytest.raises(ValueError):
+        MediaTextTrack("").to_dict()
+
+
+def test_resolve_patch_shape():
+    assert resolve_patch("/s.m3u8", type="hls") == {"src": "/s.m3u8", "type": "hls"}
+    assert resolve_patch(error="gone") == {"error": "gone"}
+    assert resolve_patch("/a", text_tracks=[MediaTextTrack("/a.vtt", "En")]) == {
+        "src": "/a", "textTracks": [{"src": "/a.vtt", "label": "En"}]}
+    with pytest.raises(ValueError):
+        resolve_patch("/a", kind="slideshow")
+
+
+def test_assets_are_in_the_manifest_in_order():
+    import json
+    from pathlib import Path
+    manifest = json.loads((Path(wapyt.__file__).parent / "pytincture-assets.json").read_text())
+    paths = [a["path"] for a in manifest["assets"]]
+    assert paths.index("wapyt/assets/vendor-hlsjs.light.min.js") < paths.index("wapyt/assets/mediaplayer.js")
+
+
+def test_actions_are_the_apps_own_buttons():
+    from wapyt import MediaAction
+    payload = MediaPlayerConfig(actions=[
+        MediaAction("playlist", "mdi-playlist-plus", "Add to playlist"),
+        MediaAction("like", "mdi-heart-outline", "Like", pressed=False, disabled=True),
+    ]).to_dict()
+    assert payload["actions"] == [
+        {"id": "playlist", "icon": "mdi-playlist-plus", "label": "Add to playlist"},
+        {"id": "like", "icon": "mdi-heart-outline", "label": "Like", "pressed": False, "disabled": True},
+    ]
+    assert MediaAction("x").to_dict() == {"id": "x", "icon": "mdi-dots-horizontal", "label": "x"}
+    with pytest.raises(ValueError):
+        MediaAction("").to_dict()
+    with pytest.raises(ValueError):
+        MediaPlayerConfig(actions=[MediaAction("a"), MediaAction("a")]).to_dict()
+    assert "actions" not in MediaPlayerConfig().to_dict()
+
+
+def test_headers_and_live_for_any_media_server():
+    item = MediaItem("/live/channel.m3u8", headers={"Authorization": "Bearer abc", "X-Api-Key": "k"}, live=True)
+    assert item.to_dict() == {"src": "/live/channel.m3u8", "headers": {"Authorization": "Bearer abc", "X-Api-Key": "k"}, "live": True}
+    for bad in ({"Bad Name": "x"}, {"X": "two\r\nlines"}, {"X": 3}):
+        with pytest.raises(ValueError):
+            MediaItem("/a.m3u8", headers=bad).to_dict()
+    assert resolve_patch("/s.m3u8", headers={"Authorization": "Bearer t"}, live=False) == {
+        "src": "/s.m3u8", "headers": {"Authorization": "Bearer t"}, "live": False}
+    with pytest.raises(ValueError):
+        resolve_patch("/s.m3u8", headers={"A": "b\nc"})
+
+
+def test_quality_menu_can_be_turned_off():
+    assert MediaPlayerConfig(show_quality=False).to_dict() == {"mode": "auto", "showQuality": False}
+    assert "showQuality" not in MediaPlayerConfig().to_dict()

wapyt-0.2.0.dev2/tests/test_source_warnings.py

@@ -0,0 +1,18 @@
+"""Every wapyt module compiles without warnings (no invalid escapes and the like)."""
+from __future__ import annotations
+
+import pathlib
+import warnings
+
+import pytest
+
+ROOT = pathlib.Path(__file__).resolve().parents[1] / "wapyt"
+
+
+@pytest.mark.parametrize("path", sorted(ROOT.rglob("*.py")), ids=lambda p: str(p.relative_to(ROOT)))
+def test_compiles_without_warnings(path):
+    # An invalid escape such as "\;" in a normal string is a SyntaxWarning
+    # today (on every import, in every app) and an error in a future Python.
+    with warnings.catch_warnings():
+        warnings.simplefilter("error")
+        compile(path.read_text(encoding="utf-8"), str(path), "exec")

{wapyt-0.2.0.dev1 → wapyt-0.2.0.dev2}/wapyt/__init__.py

@@ -7,7 +7,7 @@ import re as _re
 __widgetset__ = "wapyt"
 # A plain string literal: pytincture reads it by parsing this file, and it must
 # match pyproject.toml and the asset manifest (CI and the release workflow check).
-__version__ = "0.2.0.dev1"
+__version__ = "0.2.0.dev2"
 # The numeric release part only, so pre-releases ("0.2.0.dev0", "0.2.0rc1")
 # do not break `int()`.
 __version_tuple__ = tuple(int(part) for part in _re.match(r"\d+(?:\.\d+)*", __version__).group(0).split("."))
@@ -24,6 +24,7 @@ from .sidebar.sidebar_config import SidebarConfig, SidebarHeading, SidebarItem,
 from .modal.modal import ModalWindow, ModalConfig
 from .window.window import Window, WindowConfig
 from .chart import Chart, ChartConfig, ChartDataset
+from .mediaplayer import MediaAction, MediaItem, MediaPlayer, MediaPlayerConfig, MediaTextTrack
 from .scheduler import Scheduler, SchedulerConfig, ScheduleItem
 from .form.form import Form
 from .datatable.datatable import DataTable
@@ -89,6 +90,11 @@ __all__ = [
     "Chart",
     "ChartConfig",
     "ChartDataset",
+    "MediaPlayer",
+    "MediaPlayerConfig",
+    "MediaItem",
+    "MediaTextTrack",
+    "MediaAction",
     "Scheduler",
     "SchedulerConfig",
     "ScheduleItem",