runtimepy 5.15.2__tar.gz → 5.15.4__tar.gz

{runtimepy-5.15.2/runtimepy.egg-info → runtimepy-5.15.4}/PKG-INFO

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

@@ -2,11 +2,11 @@
     =====================================
     generator=datazen
     version=3.2.3
-    hash=f1c75c9b812e8ff29fdda46f58009aef
+    hash=99eea1986d2105483ebb2fe566128f5f
     =====================================
 -->
 
-# runtimepy ([5.15.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.15.4](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.2 → runtimepy-5.15.4}/pyproject.toml

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

{runtimepy-5.15.2 → runtimepy-5.15.4}/runtimepy/__init__.py

@@ -1,7 +1,7 @@
 # =====================================
 # generator=datazen
 # version=3.2.3
-# hash=839ec3c3fa52de16f775789c0d38bf3e
+# hash=b0f0463a508c9a1312a071f5c0b06f3b
 # =====================================
 
 """
@@ -10,7 +10,7 @@ Useful defaults and other package metadata.
 
 DESCRIPTION = "A framework for implementing Python services."
 PKG_NAME = "runtimepy"
-VERSION = "5.15.2"
+VERSION = "5.15.4"
 
 # runtimepy-specific content.
 METRICS_NAME = "metrics"

{runtimepy-5.15.2 → runtimepy-5.15.4}/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.2 → runtimepy-5.15.4}/runtimepy/channel/environment/command/__init__.py

@@ -12,7 +12,9 @@ from typing import Any, Iterator, Optional, cast
 
 # third-party
 from vcorelib import DEFAULT_ENCODING
+from vcorelib.dict import GenericStrDict
 from vcorelib.io import ARBITER, JsonObject
+from vcorelib.io.bus import BUS
 from vcorelib.logging import DEFAULT_TIME_FORMAT, LoggerMixin
 from vcorelib.math import default_time_ns, nano_str
 from vcorelib.names import name_search
@@ -25,6 +27,7 @@ from runtimepy.channel.environment.command.processor import (
     CommandHook,
     EnvironmentMap,
 )
+from runtimepy.channel.environment.command.result import CommandResult
 from runtimepy.channel.registry import ParsedEvent
 from runtimepy.mapping import DEFAULT_PATTERN
 
@@ -243,6 +246,38 @@ GLOBAL = GlobalEnvironment()
 ENVIRONMENTS = GLOBAL
 
 
+def global_command(env: str, value: str) -> Optional[CommandResult]:
+    """Handle a global command."""
+
+    result = None
+    if env in GLOBAL:
+        result = GLOBAL[env].command(value)
+    else:
+        GLOBAL.logger.error(
+            "Couldn't run command env='%s' value='%s'.", env, value
+        )
+    return result
+
+
+def global_commands(*cmds: tuple[str, str]) -> None:
+    """Handle a global command."""
+    for env, value in cmds:
+        global_command(env, value)
+
+
+async def global_command_bus(payload: GenericStrDict) -> None:
+    """Handle a bus message."""
+
+    if "env" in payload and "value" in payload:
+        global_command(payload["env"], payload["value"])
+    elif "cmds" in payload:
+        global_commands(*payload["cmds"])
+
+
+BUS.register_ro("command", global_command_bus)
+BUS.register_ro("cmd", global_command_bus)
+
+
 def clear_env() -> None:
     """Reset the global environment mapping."""
     GLOBAL.clear()

{runtimepy-5.15.2 → runtimepy-5.15.4}/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.2 → runtimepy-5.15.4}/runtimepy/data/dummy_load.yaml

@@ -9,6 +9,9 @@ tasks:
       a: 1
       b: 2
       c: 3
+      views:
+        - [zero, "\\.0\\."]
+        - [one, "\\.1\\."]
     markdown: |
       # This is a Test
 
@@ -29,6 +32,9 @@ tasks:
   - name: wave3
     factory: sinusoid
     period_s: 0.03
+    config:
+      views:
+        - [trig, sin cos]
     markdown: |
       # Markdown for wave3
 
@@ -50,6 +56,10 @@ clients:
     defer: true
     kwargs:
       remote_addr: [localhost, "$udp_json"]
+    views:
+      - [metrics, metrics]
+      - [transmit, tx]
+      - [receive, rx]
     markdown: |
       # `udp_json_client`
 
@@ -107,3 +117,7 @@ processes:
       app: runtimepy.sample.program.run
 
     program: runtimepy.sample.program.SampleProgram
+
+commands:
+  - [udp_json_client, "set log_level warning"]
+  - [proc1.peer, "set log_level warning"]

{runtimepy-5.15.2 → runtimepy-5.15.4}/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.2 → runtimepy-5.15.4}/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.2 → runtimepy-5.15.4}/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.2 → runtimepy-5.15.4}/runtimepy/data/schemas/ClientConnectionConfig.yaml

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

{runtimepy-5.15.2 → runtimepy-5.15.4}/runtimepy/data/schemas/ConnectionArbiterConfig.yaml

@@ -26,6 +26,9 @@ properties:
     items:
       $ref: package://runtimepy/schemas/StructConfig.yaml
 
+  commands:
+    $ref: package://runtimepy/schemas/TwoTupleArray.yaml
+
   tasks:
     type: array
     items:

{runtimepy-5.15.2 → runtimepy-5.15.4}/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.4/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.4/runtimepy/data/schemas/has_views.yaml

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

{runtimepy-5.15.2 → runtimepy-5.15.4}/runtimepy/net/arbiter/base.py

@@ -26,6 +26,7 @@ from vcorelib.namespace import NamespaceMixin as _NamespaceMixin
 from runtimepy.channel.environment.command import (
     clear_env,
     env_json_data,
+    global_commands,
     register_env,
 )
 from runtimepy.net.arbiter.housekeeping import housekeeping
@@ -145,6 +146,9 @@ class BaseConnectionArbiter(_NamespaceMixin, _LoggerMixin, TuiMixin):
         # A copy of named port mappings (loaded via external config).
         self._ports: dict[str, int] = {}
 
+        self._commands: list[tuple[str, str]] = []
+        self._views: dict[str, dict[str, str]] = {}
+
         self._init()
 
     def _init(self) -> None:
@@ -153,6 +157,9 @@ class BaseConnectionArbiter(_NamespaceMixin, _LoggerMixin, TuiMixin):
     def _register_connection(self, connection: _Connection, name: str) -> None:
         """Perform connection registration."""
 
+        if name in self._views:
+            connection.env.views.update(self._views[name])
+            del self._views[name]
         self._connections[name] = connection
         self.manager.queue.put_nowait(connection)
         connection.logger.info("Registered as '%s'.", name)
@@ -162,6 +169,7 @@ class BaseConnectionArbiter(_NamespaceMixin, _LoggerMixin, TuiMixin):
         connection: _Union[_Connection, _Awaitable[_Connection]],
         *names: str,
         delim: str = None,
+        views: dict[str, str] = None,
     ) -> bool:
         """Attempt to register a connection object."""
 
@@ -170,6 +178,9 @@ class BaseConnectionArbiter(_NamespaceMixin, _LoggerMixin, TuiMixin):
         with self.names_pushed(*names):
             name = self.namespace(delim=delim)
 
+        if views:
+            self._views[name] = views
+
         if (
             name not in self._connections
             and name not in self._deferred_connections
@@ -318,6 +329,11 @@ class BaseConnectionArbiter(_NamespaceMixin, _LoggerMixin, TuiMixin):
 
             # Run initialization methods.
             result = await self._run_apps_list(self._inits, info)
+
+            # Run commands.
+            await _asyncio.sleep(0)
+            global_commands(*self._commands)
+
             if result == 0:
                 # Get application methods.
                 apps = self._apps

{runtimepy-5.15.2 → runtimepy-5.15.4}/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,8 @@ 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"),
             ), f"Couldn't register client '{name}' ({factory})!"
 
         # Register servers.
@@ -245,5 +246,8 @@ class ConfigConnectionArbiter(_ImportConnectionArbiter):
             assert "root" not in config.config, config.config
             config.config["root"] = root
 
+        # Register commands.
+        self._commands = config.commands
+
 
 ConfigConnectionArbiter.add_search_package(PKG_NAME)

{runtimepy-5.15.2 → runtimepy-5.15.4}/runtimepy/net/arbiter/config/codec.py

@@ -71,6 +71,11 @@ class ConnectionArbiterConfig(_RuntimepyDictCodec):
 
         self.directory = _Path(str(data.get("directory", ".")))
 
+        self.commands: list[tuple[str, str]] = data.get(  # type: ignore
+            "commands",
+            [],
+        )
+
     def asdict(self) -> _JsonObject:
         """Obtain a dictionary representing this instance."""
         return self.data

{runtimepy-5.15.2 → runtimepy-5.15.4}/runtimepy/net/arbiter/factory/connection.py

@@ -89,12 +89,17 @@ class FactoryConnectionArbiter(_BaseConnectionArbiter):
         if factory in self._conn_factories:
             factory_inst = self._conn_factories[factory]
 
+            views = kwargs.pop("views", {})
+
             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,
             )
 
         return result

{runtimepy-5.15.2 → runtimepy-5.15.4}/runtimepy/net/server/__init__.py

@@ -18,7 +18,7 @@ from vcorelib.paths import Pathlike, find_file, normalize
 
 # internal
 from runtimepy import DEFAULT_EXT, PKG_NAME
-from runtimepy.channel.environment.command import GLOBAL
+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
@@ -270,17 +270,22 @@ class RuntimepyServerConnection(HttpConnection):
         response_data["success"] = False
         response_data["message"] = "No command executed."
 
-        if not args or args[0] not in GLOBAL:
+        def cmd_usage() -> None:
+            """Set usage information for the response."""
             response_data["usage"] = (
                 "/<environment (arg0)>/<arg1>[/.../<argN>]"
             )
             response_data["environments"] = list(GLOBAL)
 
-        # Run command.
+        if args:
+            result = global_command(args[0], " ".join(args[1:]))
+            if result is None:
+                cmd_usage()
+            else:
+                response_data["success"] = result.success
+                response_data["message"] = str(result)
         else:
-            result = GLOBAL[args[0]].command(" ".join(args[1:]))
-            response_data["success"] = result.success
-            response_data["message"] = str(result)
+            cmd_usage()
 
         # Send response.
         encode_json(stream, response, response_data)

{runtimepy-5.15.2 → runtimepy-5.15.4}/runtimepy/net/server/app/env/widgets.py

@@ -80,6 +80,21 @@ 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"),
+        id="filter-view",
+        title="Canonical channel filters.",
+    ).add_class("border-end-0", "w-100")
+    div(tag="option", value="", text="-", parent=select)
+    for text, value in command.env.views.items():
+        div(tag="option", value=value, text=text, parent=select)
+    if not command.env.views:
+        select.booleans.add("disabled")
+
+
 def channel_table_header(
     parent: Element, command: ChannelCommandProcessor
 ) -> None:
@@ -105,7 +120,7 @@ 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"),
         description="Channel name filter.",
         pattern=".* ! @ $",
         label="filter",
@@ -114,17 +129,18 @@ 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")
     )
 
-    # Add a selection menu for custom commands.
+    # Add a selection menu for custom commands. (need a data source for this)
     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:

{runtimepy-5.15.2 → runtimepy-5.15.4}/runtimepy/struct/__init__.py

@@ -45,6 +45,7 @@ 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)

{runtimepy-5.15.2 → runtimepy-5.15.4}/runtimepy/task/basic/periodic.py

@@ -72,6 +72,7 @@ class PeriodicTask(
         self.metrics = metrics
 
         ChannelEnvironmentMixin.__init__(self, env=env)
+        self.env.views.update(self.config.get("views", {}))  # type: ignore
         self.setup_level_channel(self.env)
         self.command = ChannelCommandProcessor(self.env, self.logger)
         self.register_task_metrics(self.metrics)

{runtimepy-5.15.2 → runtimepy-5.15.4/runtimepy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: runtimepy
-Version: 5.15.2
+Version: 5.15.4
 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: vcorelib>=3.6.3
+Requires-Dist: websockets
 Requires-Dist: svgen>=0.8.0
 Requires-Dist: aiofiles
 Requires-Dist: psutil
-Requires-Dist: vcorelib>=3.6.3
-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.3
-    hash=f1c75c9b812e8ff29fdda46f58009aef
+    hash=99eea1986d2105483ebb2fe566128f5f
     =====================================
 -->
 
-# runtimepy ([5.15.2](https://pypi.org/project/runtimepy/))
+# runtimepy ([5.15.4](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.2 → runtimepy-5.15.4}/runtimepy.egg-info/SOURCES.txt

@@ -114,12 +114,14 @@ runtimepy/data/schemas/RuntimeEnum.yaml
 runtimepy/data/schemas/ServerConnectionConfig.yaml
 runtimepy/data/schemas/StructConfig.yaml
 runtimepy/data/schemas/TaskConfig.yaml
+runtimepy/data/schemas/TwoTupleArray.yaml
 runtimepy/data/schemas/channel_controls.yaml
 runtimepy/data/schemas/has_config.yaml
 runtimepy/data/schemas/has_factory.yaml
 runtimepy/data/schemas/has_markdown.yaml
 runtimepy/data/schemas/has_name.yaml
 runtimepy/data/schemas/has_request_flag.yaml
+runtimepy/data/schemas/has_views.yaml
 runtimepy/data/static/css/bootstrap-icons.min.css
 runtimepy/data/static/css/bootstrap.min.css
 runtimepy/data/static/css/fonts/bootstrap-icons.woff