runtimepy 5.15.2__py3-none-any.whl → 5.15.3__py3-none-any.whl

runtimepy/__init__.py

@@ -1,7 +1,7 @@
 # =====================================
 # generator=datazen
 # version=3.2.3
-# hash=839ec3c3fa52de16f775789c0d38bf3e
+# hash=f5155e85b2694b012648fdbe9c12b1cd
 # =====================================
 
 """
@@ -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.3"
 
 # runtimepy-specific content.
 METRICS_NAME = "metrics"

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/data/dummy_load.yaml

@@ -107,3 +107,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/data/schemas/ConnectionArbiterConfig.yaml

@@ -26,6 +26,16 @@ properties:
     items:
       $ref: package://runtimepy/schemas/StructConfig.yaml
 
+  commands:
+    type: array
+    items:
+      type: array
+      minItems: 2
+      maxItems: 2
+      items:
+        - type: string
+        - type: string
+
   tasks:
     type: array
     items:

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,8 @@ 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._init()
 
     def _init(self) -> None:
@@ -318,6 +321,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/net/arbiter/config/__init__.py

@@ -245,5 +245,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/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/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.dist-info → runtimepy-5.15.3.dist-info}/METADATA

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

@@ -1,4 +1,4 @@
-runtimepy/__init__.py,sha256=flvkr-56G2rUSF5MWiJFKowe_0LjNtJbpWzAdUU_B3M,391
+runtimepy/__init__.py,sha256=p2KGfCnic5ku-9e4b4_crfVty8m2X40WLOHJiBsFOuo,391
 runtimepy/__main__.py,sha256=IKioH2xOtsXwrwb9zABDQEJvuAX--Lnh84TeSz0XSs0,332
 runtimepy/app.py,sha256=Er1ZKKrG9U0FV0gQg_GYF9xDb89HgYnVzS5SjxGa2Tg,970
 runtimepy/dev_requirements.txt,sha256=VZhW6bJ5YbwaoN4d_XxZFuN5BbDLaG7ngKrGnugVPRw,245
@@ -17,7 +17,7 @@ runtimepy/channel/environment/create.py,sha256=UVO_R5rM6xLjpAh3j3wwix-0V3uJMAno2
 runtimepy/channel/environment/file.py,sha256=PV05KZ3-CvftbKUM8acQmawOMeGGCcMrEESEBuymykg,6949
 runtimepy/channel/environment/sample.py,sha256=6926v0ZssvfeWX_C8MSbUfYjE4sr3jt0CLVSJ_2Cl3U,5316
 runtimepy/channel/environment/telemetry.py,sha256=3A7Xcp-4eHJWz_oR1SnI6rsl4o8wiSUaiMHrnK1IaQ8,5338
-runtimepy/channel/environment/command/__init__.py,sha256=mymqk5roA-7evUovXlD2dmWaprSzrPb_3ae6bA9oEZ0,8162
+runtimepy/channel/environment/command/__init__.py,sha256=PRuIp29QYkTDHF95HL55G6ogQDkVbq0M3SnNre4JXpI,9150
 runtimepy/channel/environment/command/parser.py,sha256=cMOsEsXnfFlATiWTNSxlgvc_XoICsJlcZigFJlQ47tk,1804
 runtimepy/channel/environment/command/processor.py,sha256=NiiWRdwBHOFEisjqNOW5oawprxcpR25ONNABoZpELdg,7122
 runtimepy/channel/environment/command/result.py,sha256=Ko5lK4d04Z266WuCi2sHQItbUHJFYv7qUdrDi-OVKOU,624
@@ -45,7 +45,7 @@ runtimepy/control/env/__init__.py,sha256=RHJqysY7Pv4VDs2SGk0X-qc5xp_SrQ_oxb5Deug
 runtimepy/data/404.md,sha256=_yzjvp2GeMc5OBvZX2zDbX-Ns6T7HCO9esRbS5PmkXU,397
 runtimepy/data/base.yaml,sha256=PEsvcMV1qFb1Gr6Cx2SgmR6ScfPyuu3yTdnvSBTVSdA,453
 runtimepy/data/browser.yaml,sha256=oc5KEV1C1uAJ4MkhNo4hyVVfJtZvHelRNqzNvD313Ow,79
-runtimepy/data/dummy_load.yaml,sha256=oAuccgvM3lDoN5RZBo4UECiegxzOgpllBfXXwZ5odCw,2071
+runtimepy/data/dummy_load.yaml,sha256=gx3B-rGXj5iEcs7iUssy7aZxRvUNz0Q73whSlNwY1tU,2171
 runtimepy/data/factories.yaml,sha256=CdpnjK2glj8HewI2tFSNvCSUdcNPeVD_tFbGy2QBSQg,1952
 runtimepy/data/favicon.ico,sha256=boxAGaHbUjMFrOO2TZpsO0nIRC-LUgwHVQYOiG1YQnM,362870
 runtimepy/data/sample_telemetry.yaml,sha256=OpdFurkvtWJGaNl9LMlU2rKo15AaVVr-U_hoZfsbp-Y,695
@@ -96,7 +96,7 @@ runtimepy/data/schemas/Channel.yaml,sha256=9OQ3mOtPOlcWugvObpWKoAdFW0WvR9mSEzfdD
 runtimepy/data/schemas/ChannelCommand.yaml,sha256=h7-n5WjNwWgteZ8U5YpaBRncR_Uiqaa_wVfuTWQFrTY,257
 runtimepy/data/schemas/ChannelRegistry.yaml,sha256=f51YngVC8zDM3HwRMicKBOyoqjJ9EWsx3GWD0EkHCZk,136
 runtimepy/data/schemas/ClientConnectionConfig.yaml,sha256=XUWkOiCOw175harOsDRV3TXJja-EAKnipYDQFf_XC4Q,187
-runtimepy/data/schemas/ConnectionArbiterConfig.yaml,sha256=WorY7ttxvQA78TYuFoNHw41hc9johxvgO72dusfLSqE,2133
+runtimepy/data/schemas/ConnectionArbiterConfig.yaml,sha256=tjqtu270LVhlBzP1Y-EdJqTSlC7yYLylaLzrW3Q1l-w,2286
 runtimepy/data/schemas/EnumRegistry.yaml,sha256=BfLzEEUsHj6Fg_0JyGmgbNJ7F-auuLs5tAhJjSc86uU,145
 runtimepy/data/schemas/FindFile.yaml,sha256=dSPCDQy4FQZLMgOjtbR0-o2sZECvN_tvGa3LXNd1-wc,934
 runtimepy/data/schemas/PeerProcessConfig.yaml,sha256=RNVGG1NV9-Goa7aLE0ah7QNwKOTEoJj6EZDXTW-TALM,190
@@ -167,14 +167,14 @@ runtimepy/net/ssl.py,sha256=dj9uECPKDT5k-5vlR5I3Z7Go3WWZhbaJ9nb0rC3kJvg,854
 runtimepy/net/util.py,sha256=XTQQ-Ql_ImhVd1_O8nSeDX9MY8xJwRBggvliSLCrsc8,5913
 runtimepy/net/apps/__init__.py,sha256=vjo7e19QXtJwe6V6B-QGvYiJveYobnYIfpkKZrnS17w,710
 runtimepy/net/arbiter/__init__.py,sha256=ptKF995rYKvkm4Mya92vA5QEDqcFq5NRD0IYGqZ6_do,740
-runtimepy/net/arbiter/base.py,sha256=q9mQ3vjVjlzjGrDcTq8gengsEV2AnCUx8IK_40h6uxg,15011
+runtimepy/net/arbiter/base.py,sha256=IBM6m7BxPLHmHqndU2tbEbgo3VxevWnqBdGfJQlMg4Q,15195
 runtimepy/net/arbiter/info.py,sha256=QcBB1LQELXPs-Ud-GVq3aDBL4mpSMDcjjLtuKgojiU8,10962
 runtimepy/net/arbiter/result.py,sha256=PHZo5qj4SI08ZeWPFk_8OZ1umI6L0dp5nJpjjS8QUpM,2871
 runtimepy/net/arbiter/task.py,sha256=APcc5QioAG8uueIzxJU-vktIn8Ys3yJd_CFlRWb6Ieo,795
 runtimepy/net/arbiter/udp.py,sha256=-ecHJs-utcsiTfr5wSb73hUUuYFBeRVT_D1znYp5q6A,893
 runtimepy/net/arbiter/websocket.py,sha256=vYTDA7sXMUTTqW3i1zTWUdaxGKxfrQcQoVSYZtmCvfQ,1524
-runtimepy/net/arbiter/config/__init__.py,sha256=NnsVUllwHGAOVhQYAhFIYq1Il5xQdP86bNPrqzwL0oQ,8678
-runtimepy/net/arbiter/config/codec.py,sha256=TQj8UXEb1EvhiCqRdyq5BkeubMytEZAs9B4E5ZYsEuY,2511
+runtimepy/net/arbiter/config/__init__.py,sha256=D13gU5jLLP36fkPKKpXd2VLRvvA-Rgb4SolWB5UeiKQ,8749
+runtimepy/net/arbiter/config/codec.py,sha256=JVutIe1AFVr3NN7GS4rZayxZR05LWzQZRqzEuJpEJd8,2635
 runtimepy/net/arbiter/config/util.py,sha256=MezLSil5mEwioI5kxDOZa9y118st1_t0El8DYH6hFU8,1254
 runtimepy/net/arbiter/factory/__init__.py,sha256=jC1szUYucH4Us3jbb0mhFgnklHlorya5DYGGw2pqfe4,334
 runtimepy/net/arbiter/factory/connection.py,sha256=uSwnvIWGJcDd2ReK-s9lBx-NcRQ1JH_7VbwkWjE_8zA,3690
@@ -198,7 +198,7 @@ runtimepy/net/http/request_target.py,sha256=EfcOozUeXqOuQaMXH9cErfJqUkG0A5v9HEK4
 runtimepy/net/http/response.py,sha256=fD0R_BUgmNwdwKQtXvYfTYM7DyJlwsGmlNVi5HkCOhU,3409
 runtimepy/net/http/state.py,sha256=qCMN8aWfCRfU9XP-cIhSOo2RqfljTjbQRCflfcy2bfY,1626
 runtimepy/net/http/version.py,sha256=mp6rgIM7-VUVKLCA0Uw96CmBkL0ET860lDVVEewpZ7w,1098
-runtimepy/net/server/__init__.py,sha256=5KalIcOWv8lYm8747pq2rzGwpLz713XdHuQIKbWJsXc,11649
+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
@@ -306,9 +306,9 @@ runtimepy/tui/task.py,sha256=nUZo9fuOC-k1Wpqdzkv9v1tQirCI28fZVgcC13Ijvus,1093
 runtimepy/tui/channels/__init__.py,sha256=evDaiIn-YS9uGhdo8ZGtP9VK1ek6sr_P1nJ9JuSET0o,4536
 runtimepy/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 runtimepy/ui/controls.py,sha256=L55Af-4vGq6ZHewdoA7C_mAYq35WXl8NzOdcsmQIo7M,1868
-runtimepy-5.15.2.dist-info/licenses/LICENSE,sha256=yKBRwbO-cOPBrlpsZmJkkSa33DfY31aE8t7lZ0DwlUo,1071
-runtimepy-5.15.2.dist-info/METADATA,sha256=6UbqbnIRB9WTeD5cDcSUfCqcqlxEEC6o5CQgPSBAohM,9268
-runtimepy-5.15.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-runtimepy-5.15.2.dist-info/entry_points.txt,sha256=-btVBkYv7ybcopqZ_pRky-bEzu3vhbaG3W3Z7ERBiFE,51
-runtimepy-5.15.2.dist-info/top_level.txt,sha256=0jPmh6yqHyyJJDwEID-LpQly-9kQ3WRMjH7Lix8peLg,10
-runtimepy-5.15.2.dist-info/RECORD,,
+runtimepy-5.15.3.dist-info/licenses/LICENSE,sha256=yKBRwbO-cOPBrlpsZmJkkSa33DfY31aE8t7lZ0DwlUo,1071
+runtimepy-5.15.3.dist-info/METADATA,sha256=r94cxl_YOL9LR18H30DZwOmNbIQ3S-EcTzvbBhCssRo,9268
+runtimepy-5.15.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+runtimepy-5.15.3.dist-info/entry_points.txt,sha256=-btVBkYv7ybcopqZ_pRky-bEzu3vhbaG3W3Z7ERBiFE,51
+runtimepy-5.15.3.dist-info/top_level.txt,sha256=0jPmh6yqHyyJJDwEID-LpQly-9kQ3WRMjH7Lix8peLg,10
+runtimepy-5.15.3.dist-info/RECORD,,