runtimepy 5.15.3__tar.gz → 5.15.5__tar.gz

{runtimepy-5.15.3/runtimepy.egg-info → runtimepy-5.15.5}/PKG-INFO

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

@@ -2,11 +2,11 @@
     =====================================
     generator=datazen
     version=3.2.3
-    hash=ed2f5b3731ba189c4a3ec2f2252b622e
+    hash=fd0e57419cf9437a64c4f82cae3625f0
     =====================================
 -->
 
-# runtimepy ([5.15.3](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.15.5](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.3 → runtimepy-5.15.5}/pyproject.toml

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

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/__init__.py

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

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/channel/environment/base.py

@@ -54,6 +54,7 @@ class BaseChannelEnvironment(_NamespaceMixin, FinalizeMixin):
         fields: _Iterable[_BitFields] = None,
         namespace: Namespace = None,
         namespace_delim: str = DEFAULT_DELIM,
+        views: dict[str, str] = None,
     ) -> None:
         """Initialize this channel environment."""
 
@@ -105,6 +106,10 @@ class BaseChannelEnvironment(_NamespaceMixin, FinalizeMixin):
         if values is not None:
             self.apply(values)
 
+        if not views:
+            views = {}
+        self.views = views
+
     def __setitem__(self, key: _RegistryKey, value: ChannelValue) -> None:
         """Mapping-set interface."""
         return self.set(key, value)

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/channel/environment/command/processor.py

@@ -20,6 +20,7 @@ from runtimepy.channel.environment.command.result import SUCCESS, CommandResult
 from runtimepy.mixins.environment import ChannelEnvironmentMixin
 from runtimepy.primitives.bool import Bool
 from runtimepy.primitives.field import BitField
+from runtimepy.ui.button import ActionButton
 
 CommandHook = Callable[[Namespace, Optional[FieldOrChannel]], None]
 
@@ -33,7 +34,11 @@ class ChannelCommandProcessor(ChannelEnvironmentMixin):
     """A command processing interface for channel environments."""
 
     def __init__(
-        self, env: ChannelEnvironment, logger: LoggerType, **kwargs
+        self,
+        env: ChannelEnvironment,
+        logger: LoggerType,
+        buttons: list[ActionButton] = None,
+        **kwargs,
     ) -> None:
         """Initialize this instance."""
 
@@ -49,6 +54,11 @@ class ChannelCommandProcessor(ChannelEnvironmentMixin):
 
         self.parser.initialize()
 
+        # Action buttons.
+        if buttons is None:
+            buttons = []
+        self.buttons: list[ActionButton] = buttons
+
     def register_custom_commands(
         self, *custom_commands: CustomCommand
     ) -> None:

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/channel/environment/file.py

@@ -42,6 +42,8 @@ ENUMS_FILE = f"{ENUMS_KEY}.json"
 VALUES_FILE = f"{VALUES_KEY}.json"
 FIELDS_FILE = f"{FIELDS_KEY}.json"
 NAMES_FILE = f"{NAMES_KEY}.json"
+VIEWS_KEY = "views"
+# VIEWS_FILE = f"{VIEWS_KEY}.json"
 
 
 class FileChannelEnvironment(_BaseChannelEnvironment):
@@ -64,6 +66,7 @@ class FileChannelEnvironment(_BaseChannelEnvironment):
             VALUES_KEY: _cast(
                 _JsonObject, self.values(resolve_enum=resolve_enum)
             ),
+            VIEWS_KEY: _cast(_JsonObject, self.views),
         }
 
     def export(
@@ -143,6 +146,7 @@ class FileChannelEnvironment(_BaseChannelEnvironment):
             enums=enum_reg,
             values=_cast(_Optional[_ValueMap], data.get(VALUES_KEY)),
             fields=_fields_from_dict(data[FIELDS_KEY]),
+            views=_cast(dict[str, str], data.get(VIEWS_KEY, {})),
         )
 
         # Typically, externally loaded environments should be final at load

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/css/bootstrap_extra.css

@@ -110,6 +110,10 @@ select:hover {
   background-image: linear-gradient(to bottom, var(--bs-tertiary-bg), rgba(var(--bs-tertiary-bg-rgb), 0), var(--bs-tertiary-bg));
 }
 
+.bg-gradient-tertiary-left-right {
+  background-image: linear-gradient(to right, var(--bs-tertiary-bg), rgba(var(--bs-tertiary-bg-rgb), 0), var(--bs-tertiary-bg));
+}
+
 .border-start-info-subtle {
   border-left: var(--bs-border-width) var(--bs-border-style) var(--bs-info-border-subtle);
 }

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/css/main.css

@@ -74,3 +74,11 @@ body > :first-child {
 .overscroll-behavior-none {
   overscroll-behavior: none;
 }
+
+.channel-views-min-width {
+  min-width: 5.5em;
+}
+
+.channel-filter-min-width {
+  min-width: 5.5em;
+}

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/dummy_load.yaml

@@ -1,4 +1,42 @@
 ---
+# UDP JSON clients.
+clients:
+  - factory: udp_json
+    name: udp_json_client
+    defer: true
+    kwargs:
+      remote_addr: [localhost, "$udp_json"]
+    views:
+      - [metrics, metrics]
+      - [transmit, tx]
+      - [receive, rx]
+    buttons: &buttons
+      - icon: tux
+        key: test
+        payload: {}
+      - icon: tux
+        key: test
+        text: asdf
+        payload: {}
+      - icon: tux
+        key: test
+        payload: {}
+        outline: false
+      - icon: tux
+        key: test
+        text: asdf
+        payload: {}
+        outline: false
+    markdown: |
+      # `udp_json_client`
+
+      Connects to `udp_json_server`.
+
+  - factory: udp_json
+    name: udp_json_server
+    kwargs:
+      local_addr: [localhost, "$udp_json"]
+
 # Add some sample tasks.
 tasks:
   # Chaos.
@@ -9,6 +47,10 @@ tasks:
       a: 1
       b: 2
       c: 3
+      buttons: *buttons
+      views:
+        - [zero, "\\.0\\."]
+        - [one, "\\.1\\."]
     markdown: |
       # This is a Test
 
@@ -29,6 +71,9 @@ tasks:
   - name: wave3
     factory: sinusoid
     period_s: 0.03
+    config:
+      views:
+        - [trig, sin cos]
     markdown: |
       # Markdown for wave3
 
@@ -43,23 +88,6 @@ tasks:
   # Drive interactions with runtime entities that won't otherwise be polled.
   - {name: app, factory: SampleApp, period_s: 0.25}
 
-# UDP JSON clients.
-clients:
-  - factory: udp_json
-    name: udp_json_client
-    defer: true
-    kwargs:
-      remote_addr: [localhost, "$udp_json"]
-    markdown: |
-      # `udp_json_client`
-
-      Connects to `udp_json_server`.
-
-  - factory: udp_json
-    name: udp_json_server
-    kwargs:
-      local_addr: [localhost, "$udp_json"]
-
 # Add some sample structs.
 structs:
   - name: example.struct1
@@ -70,6 +98,8 @@ structs:
       b: 2
       c: 3
 
+      buttons: *buttons
+
       markdown: |
         # Docs for `example.struct1`
 

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/js/classes/ChannelTable.js

@@ -56,6 +56,10 @@ class ChannelTable {
 
         if (Number.isInteger(val)) {
           /* Handle integer formatting. */
+        } else if (typeof val == "boolean") {
+          /* Use glyphs for booleans. */
+          val = val ? '<i class="bi bi-circle-fill"></i>'
+                    : '<i class="bi bi-circle"></i>';
         } else {
           /* Handle floating-point numbers. */
           let checkFloat = Number.parseFloat(val);

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/js/classes/TabInterface.js

@@ -263,6 +263,19 @@ class TabInterface {
         this.updateChannelStyles(this.channelFilter.value);
       };
     }
+
+    /* Initialize channel view dropdown. */
+    let channelView = this.query("#filter-view");
+    if (channelView) {
+      channelView.onchange = () => {
+        if (!channelView.value || channelView.value == '-') {
+          this.channelFilter.value = "";
+        } else {
+          this.channelFilter.value = channelView.value;
+        }
+        this.updateChannelStyles(this.channelFilter.value);
+      };
+    }
   }
 
   setHandler(elem) {

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/js/classes/WorkerInterface.js

@@ -10,7 +10,7 @@ class WorkerInterface {
 
   command(data) { this.send({kind : "command", value : data}); }
 
-  bus(data) { this.worker.postMessage({bus : data}); }
+  bus(key, data) { this.worker.postMessage({key : key, bus : data}); }
 
   toWorker(data, param) { return this.send({"worker" : data}, param); }
 }

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/js/init.js

@@ -53,8 +53,10 @@ function isModifierKeyEvent(event) {
 }
 
 function ignoreFilterKeyEvent(event) {
-  // home end pg up pg down delete f keys
-  return isModifierKeyEvent(event) || event.key == "Tab";
+  return isModifierKeyEvent(event) || event.key == "Tab" ||
+         (event.key.startsWith("F") && event.key.length > 1) ||
+         event.key.startsWith("Del") || event.key == "Home" ||
+         event.key == "End" || event.key == "PageUp" || event.key == "PageDown";
 }
 
 function globalKeyEvent(event) {

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/js/sample.js

@@ -1,2 +1,2 @@
 console.log(`sample.js included (${tab.name})`);
-// tab.worker.bus({a: 1, b: 2, c: 3});
+// tab.worker.bus("test", {a: 1, b: 2, c: 3});

runtimepy-5.15.5/runtimepy/data/schemas/Button.yaml

@@ -0,0 +1,17 @@
+---
+type: object
+additionalProperties: false
+required: [key, payload]
+properties:
+  key:
+    type: string
+  payload:
+    type: object
+  text:
+    type: string
+  icon:
+    type: string
+  variant:
+    type: string
+  outline:
+    type: boolean

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/schemas/ClientConnectionConfig.yaml

@@ -3,6 +3,8 @@ includes:
   - has_factory.yaml
   - has_name.yaml
   - has_markdown.yaml
+  - has_views.yaml
+  - has_buttons.yaml
 
 properties:
   defer:

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/schemas/ConnectionArbiterConfig.yaml

@@ -27,14 +27,7 @@ properties:
       $ref: package://runtimepy/schemas/StructConfig.yaml
 
   commands:
-    type: array
-    items:
-      type: array
-      minItems: 2
-      maxItems: 2
-      items:
-        - type: string
-        - type: string
+    $ref: package://runtimepy/schemas/TwoTupleArray.yaml
 
   tasks:
     type: array

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/data/schemas/PeerProcessConfig.yaml

@@ -4,6 +4,7 @@ includes:
   - has_name.yaml
   - has_config.yaml
   - has_markdown.yaml
+  - has_views.yaml
 
 properties:
   program:

runtimepy-5.15.5/runtimepy/data/schemas/TwoTupleArray.yaml

@@ -0,0 +1,9 @@
+---
+type: array
+items:
+  type: array
+  minItems: 2
+  maxItems: 2
+  items:
+    - type: string
+    - type: string

runtimepy-5.15.5/runtimepy/data/schemas/has_buttons.yaml

@@ -0,0 +1,6 @@
+---
+properties:
+  buttons:
+    type: array
+    items:
+      $ref: package://runtimepy/schemas/Button.yaml

runtimepy-5.15.5/runtimepy/data/schemas/has_views.yaml

@@ -0,0 +1,4 @@
+---
+properties:
+  views:
+    $ref: package://runtimepy/schemas/TwoTupleArray.yaml

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/net/arbiter/base.py

@@ -47,6 +47,7 @@ from runtimepy.net.manager import ConnectionManager as _ConnectionManager
 from runtimepy.net.server import RuntimepyServerConnection
 from runtimepy.subprocess.peer import RuntimepyPeer as _RuntimepyPeer
 from runtimepy.tui.mixin import CursesWindow, TuiMixin
+from runtimepy.ui.button import ActionButton
 
 ServerTask = _Awaitable[None]
 RuntimeProcessTask = tuple[
@@ -147,6 +148,8 @@ class BaseConnectionArbiter(_NamespaceMixin, _LoggerMixin, TuiMixin):
         self._ports: dict[str, int] = {}
 
         self._commands: list[tuple[str, str]] = []
+        self._views: dict[str, dict[str, str]] = {}
+        self._buttons: dict[str, list[ActionButton]] = {}
 
         self._init()
 
@@ -156,6 +159,16 @@ class BaseConnectionArbiter(_NamespaceMixin, _LoggerMixin, TuiMixin):
     def _register_connection(self, connection: _Connection, name: str) -> None:
         """Perform connection registration."""
 
+        # Handle views.
+        if name in self._views:
+            connection.env.views.update(self._views[name])
+            del self._views[name]
+
+        # Handle buttons.
+        if name in self._buttons:
+            connection.command.buttons.extend(self._buttons[name])
+            del self._buttons[name]
+
         self._connections[name] = connection
         self.manager.queue.put_nowait(connection)
         connection.logger.info("Registered as '%s'.", name)
@@ -165,6 +178,8 @@ class BaseConnectionArbiter(_NamespaceMixin, _LoggerMixin, TuiMixin):
         connection: _Union[_Connection, _Awaitable[_Connection]],
         *names: str,
         delim: str = None,
+        views: dict[str, str] = None,
+        buttons: list[ActionButton] = None,
     ) -> bool:
         """Attempt to register a connection object."""
 
@@ -173,6 +188,11 @@ class BaseConnectionArbiter(_NamespaceMixin, _LoggerMixin, TuiMixin):
         with self.names_pushed(*names):
             name = self.namespace(delim=delim)
 
+        if views:
+            self._views[name] = views
+        if buttons:
+            self._buttons[name] = buttons
+
         if (
             name not in self._connections
             and name not in self._deferred_connections

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/net/arbiter/config/__init__.py

@@ -170,7 +170,6 @@ class ConfigConnectionArbiter(_ImportConnectionArbiter):
             kwargs = dict_resolve_env_vars(
                 client.get("kwargs", {}), env=self._ports  # type: ignore
             )
-            kwargs.setdefault("markdown", client.get("markdown"))
 
             assert await self.factory_client(
                 factory,
@@ -179,6 +178,9 @@ class ConfigConnectionArbiter(_ImportConnectionArbiter):
                 defer=client["defer"],
                 # Perform some known fixes for common keyword arguments.
                 **fix_kwargs(kwargs),
+                views=client.get("views"),
+                markdown=client.get("markdown"),
+                buttons=client.get("buttons", []),
             ), f"Couldn't register client '{name}' ({factory})!"
 
         # Register servers.

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/net/arbiter/factory/connection.py

@@ -16,6 +16,7 @@ from runtimepy.net.arbiter.base import (
 from runtimepy.net.arbiter.base import ServerTask as _ServerTask
 from runtimepy.net.connection import Connection as _Connection
 from runtimepy.net.manager import ConnectionManager as _ConnectionManager
+from runtimepy.ui.button import ActionButton
 
 
 class ConnectionFactory:
@@ -89,12 +90,19 @@ class FactoryConnectionArbiter(_BaseConnectionArbiter):
         if factory in self._conn_factories:
             factory_inst = self._conn_factories[factory]
 
+            views = kwargs.pop("views", {})
+            buttons = ActionButton.from_top_level(kwargs.pop("buttons", []))
+
             conn = factory_inst.client(name, *args, **kwargs)
             if not defer:
                 conn = await conn  # type: ignore
 
             result = self.register_connection(
-                conn, *self._conn_names[factory_inst], name
+                conn,
+                *self._conn_names[factory_inst],
+                name,
+                views=views,
+                buttons=buttons,
             )
 
         return result

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/net/server/app/env/tab/base.py

@@ -2,6 +2,9 @@
 A module implementing a channel-environment tab HTML interface.
 """
 
+# built-in
+from io import StringIO
+
 # third-party
 from vcorelib.io.markdown import MarkdownMixin
 from vcorelib.logging import LoggerMixin
@@ -39,3 +42,11 @@ class ChannelEnvironmentTabBase(Tab, LoggerMixin, MarkdownMixin):
         # Logging.
         LoggerMixin.__init__(self, logger=self.command.logger)
         self.log_limiter = RateLimiter.from_s(1.0)
+
+    def _action_markdown(self) -> str:
+        """Get action-button markdown."""
+
+        with StringIO() as stream:
+            for button in self.command.buttons:
+                button.element().encode(stream)
+            return stream.getvalue()

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/net/server/app/env/tab/html.py

@@ -289,6 +289,16 @@ class ChannelEnvironmentTabHtml(ChannelEnvironmentTabControls):
         )
         logs.booleans.add("readonly")
 
+        if self.command.buttons:
+            centered_markdown(
+                vert_container,
+                self._action_markdown(),
+                "border-start",
+                "border-bottom",
+                "border-end",
+                "bg-gradient-tertiary-left-right",
+            )
+
         self.channel_table(vert_container)
 
         centered_markdown(

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/net/server/app/env/widgets.py

@@ -80,6 +80,22 @@ def enum_dropdown(
 TABLE_BUTTON_CLASSES = ("border-top-0", "border-bottom-0")
 
 
+def views_dropdown(parent: Element, command: ChannelCommandProcessor) -> None:
+    """Dropdown menu for channel environment views."""
+
+    select = select_element(
+        parent=div(
+            tag="th", parent=parent, class_str="p-0 channel-views-min-width"
+        ),
+        id="filter-view",
+        title="Canonical channel filters.",
+    ).add_class("border-end-0", "w-100")
+    div(tag="option", value="", text="-", parent=select)
+    div(tag="option", value="^$", text="hide", parent=select)
+    for text, value in command.env.views.items():
+        div(tag="option", value=value, text=text, parent=select)
+
+
 def channel_table_header(
     parent: Element, command: ChannelCommandProcessor
 ) -> None:
@@ -105,7 +121,11 @@ def channel_table_header(
     ).add_class(*TABLE_BUTTON_CLASSES)
 
     _, label, box = input_box(
-        div(tag="th", parent=ctl_row, colspan="2", class_str="p-0"),
+        div(
+            tag="th",
+            parent=ctl_row,
+            class_str="p-0 border-end-0 channel-filter-min-width",
+        ),
         description="Channel name filter.",
         pattern=".* ! @ $",
         label="filter",
@@ -114,7 +134,9 @@ def channel_table_header(
         spellcheck="false",
     )
     label.add_class("border-top-0", "border-bottom-0")
-    box.add_class("border-top-0", "border-bottom-0")
+    box.add_class("border-top-0", "border-bottom-0", "border-end-0")
+
+    views_dropdown(ctl_row, command)
 
     cell = flex(
         parent=div(tag="th", parent=ctl_row, colspan="2", class_str="p-0")
@@ -124,7 +146,6 @@ def channel_table_header(
     select = select_element(
         parent=cell, id="custom-commands", title="Custom command selector."
     )
-    select.add_class("border-start-0")
 
     if command.custom_commands:
         for key in command.custom_commands:
@@ -141,12 +162,7 @@ def channel_table_header(
             tooltip="Send selected command (left dropdown).",
         ).add_class(*TABLE_BUTTON_CLASSES)
     else:
-        div(
-            tag="option",
-            parent=select,
-            value="noop",
-            text="no custom commands",
-        )
+        div(tag="option", parent=select, value="noop", text="-")
         select.booleans.add("disabled")
 
     # Button for 'reset all defaults' if this tab has more than one channel

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/net/server/websocket/__init__.py

@@ -96,7 +96,7 @@ class RuntimepyWebsocketConnection(WebsocketJsonMessageConnection):
 
             # Handle bus messages.
             if "bus" in inbox:
-                await BUS.send_ro("ui", inbox["bus"])
+                await BUS.send_ro(inbox["key"], inbox["bus"])
                 return
 
             # Handle frame messages.

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/requirements.txt

@@ -1,5 +1,5 @@
 aiofiles
-vcorelib>=3.6.3
+vcorelib>=3.6.4
 svgen>=0.8.0
 websockets
 psutil

{runtimepy-5.15.3 → runtimepy-5.15.5}/runtimepy/struct/__init__.py

@@ -21,6 +21,7 @@ from runtimepy.channel.environment.command.processor import (
 from runtimepy.mixins.async_command import AsyncCommandProcessingMixin
 from runtimepy.mixins.environment import ChannelEnvironmentMixin
 from runtimepy.mixins.logging import LoggerMixinLevelControl
+from runtimepy.ui.button import ActionButton
 
 
 class RuntimeStructBase(
@@ -45,10 +46,12 @@ class RuntimeStructBase(
         self.set_markdown(config=config, markdown=markdown, package=PKG_NAME)
         LoggerMixinLevelControl.__init__(self, logger=_getLogger(self.name))
         ChannelEnvironmentMixin.__init__(self)
+        self.env.views.update(config.get("views", {}))  # type: ignore
         if self.log_level_channel:
             self.setup_level_channel(self.env)
         self.command = ChannelCommandProcessor(self.env, self.logger)
         self.config = config
+        self.command.buttons.extend(ActionButton.from_top_level(self.config))
 
         async def poll(args: Namespace, __: Optional[FieldOrChannel]) -> None:
             """Handle a test command."""