runtimepy 5.14.2__py3-none-any.whl → 5.15.1__py3-none-any.whl

runtimepy/__init__.py

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

runtimepy/channel/__init__.py

@@ -29,10 +29,7 @@ from runtimepy.primitives.int import Uint32 as _Uint32
 from runtimepy.primitives.int import Uint64 as _Uint64
 from runtimepy.primitives.types import AnyPrimitiveType as _AnyPrimitiveType
 from runtimepy.registry.item import RegistryItem as _RegistryItem
-
-Literal = int | float | bool
-Default = _Optional[Literal]
-Controls = dict[str, Literal | dict[str, Literal]]
+from runtimepy.ui.controls import Controls, Default
 
 
 class Channel(_RegistryItem, _EnumMixin, _Generic[_T]):

runtimepy/channel/environment/__init__.py

@@ -3,10 +3,12 @@ A module implementing a channel environment.
 """
 
 # built-in
+from contextlib import ExitStack as _ExitStack
 from typing import Iterator as _Iterator
+from typing import Optional
+from typing import cast as _cast
 
 # internal
-from runtimepy.channel import Default as _Default
 from runtimepy.channel.environment.array import (
     ArrayChannelEnvironment as _ArrayChannelEnvironment,
 )
@@ -19,6 +21,23 @@ from runtimepy.channel.environment.file import (
 from runtimepy.channel.environment.telemetry import (
     TelemetryChannelEnvironment as _TelemetryChannelEnvironment,
 )
+from runtimepy.codec.protocol import Protocol as _Protocol
+from runtimepy.codec.protocol.base import FieldSpec as _FieldSpec
+from runtimepy.primitives import AnyPrimitive
+from runtimepy.ui.controls import Controls, Default, bit_slider
+
+
+def regular_channel_controls(
+    primitive: AnyPrimitive, commandable: bool
+) -> Optional[Controls]:
+    """Get channel controls for a regular primitive."""
+
+    controls = None
+
+    if commandable and primitive.kind.is_integer and primitive.kind.bits <= 32:
+        controls = bit_slider(primitive.kind.bits, primitive.kind.signed)
+
+    return controls
 
 
 class ChannelEnvironment(
@@ -29,13 +48,85 @@ class ChannelEnvironment(
 ):
     """A class integrating channel and enumeration registries."""
 
+    def register_protocol(
+        self, protocol: _Protocol, commandable: bool
+    ) -> None:
+        """Register protocol elements as named channels and fields."""
+
+        # Register any new enumerations.
+        self.enums.register_from_other(protocol.enum_registry)
+
+        # need to handle defaults
+
+        for item in protocol.build:
+            # Handle regular primitive fields.
+            if isinstance(item, _FieldSpec):
+                if item.is_array():
+                    assert item.array_length is not None
+                    with self.names_pushed(item.name):
+                        for idx in range(item.array_length):
+                            primitive = protocol.get_primitive(
+                                item.name, index=idx
+                            )
+                            self.channel(
+                                str(idx),
+                                kind=primitive,
+                                commandable=commandable,
+                                enum=item.enum,
+                                controls=regular_channel_controls(
+                                    primitive, commandable
+                                ),
+                            )
+                else:
+                    primitive = protocol.get_primitive(item.name)
+                    self.channel(
+                        item.name,
+                        kind=primitive,
+                        commandable=commandable,
+                        enum=item.enum,
+                        controls=regular_channel_controls(
+                            primitive, commandable
+                        ),
+                    )
+
+            # Handle nested protocols.
+            elif isinstance(item[0], str):
+                name = item[0]
+                candidates = protocol.serializables[name]
+                if isinstance(candidates[0], _Protocol):
+                    with self.names_pushed(name):
+                        for idx, candidate in enumerate(candidates):
+                            with _ExitStack() as stack:
+                                # Enter array-index namespace if applicable.
+                                if len(candidates) > 1:
+                                    stack.enter_context(
+                                        self.names_pushed(str(idx))
+                                    )
+
+                                self.register_protocol(
+                                    _cast(_Protocol, candidate), commandable
+                                )
+
+            # Handle bit fields.
+            elif isinstance(item[0], int):
+                fields = protocol.get_fields(item[0])
+                for field in fields.fields.values():
+                    field.commandable = commandable
+                    # add sliders for non enum non bool (check enum fields too)
+                self.add_fields(
+                    item[1],
+                    fields,
+                    commandable=commandable,
+                    controls=bit_slider(fields.raw.kind.bits, False),
+                )
+
     def search_names(
         self, pattern: str, exact: bool = False
     ) -> _Iterator[str]:
         """Search for names belonging to this environment."""
         yield from self.channels.names.search(pattern, exact=exact)
 
-    def set_default(self, key: str, default: _Default) -> None:
+    def set_default(self, key: str, default: Default) -> None:
         """Set a new default value for a channel."""
 
         chan, _ = self[key]

runtimepy/channel/environment/create.py

@@ -28,6 +28,7 @@ from runtimepy.enum.types import EnumTypelike as _EnumTypelike
 from runtimepy.mapping import EnumMappingData as _EnumMappingData
 from runtimepy.primitives import ChannelScaling, Primitive
 from runtimepy.primitives import Primitivelike as _Primitivelike
+from runtimepy.primitives.field.fields import BitFields as _BitFields
 from runtimepy.registry.name import RegistryKey as _RegistryKey
 
 
@@ -74,10 +75,22 @@ class CreateChannelEnvironment(_BaseChannelEnvironment):
 
         # Keep track of any new enum channels.
         if enum is not None:
-            self.channel_enums[result] = self.enums[enum]
+            runtime = self.enums[enum]
+            self.channel_enums[result] = runtime
+            if runtime.default:
+                self[name] = runtime.default
 
         return self[name]
 
+    def add_fields(
+        self, name: str, fields: _BitFields, **channel_kwargs
+    ) -> None:
+        """Add bit fields to this channel environment."""
+
+        self.channel(name, kind=fields.raw, **channel_kwargs)
+        with self.names_pushed(name):
+            self.fields.add(fields, namespace=self._namespace, track=True)
+
     def int_channel(
         self,
         name: str,
@@ -171,6 +184,7 @@ class CreateChannelEnvironment(_BaseChannelEnvironment):
         items: _EnumMappingData = None,
         namespace: _Namespace = None,
         primitive: str = DEFAULT_ENUM_PRIMITIVE,
+        **kwargs,
     ) -> _RuntimeEnum:
         """Create a new enum from the environment."""
 
@@ -179,6 +193,7 @@ class CreateChannelEnvironment(_BaseChannelEnvironment):
             kind=kind,
             items=items,
             primitive=primitive,
+            **kwargs,
         )
         assert result is not None, f"Can't create enum '{name}'!"
         return result

runtimepy/channel/environment/sample.py

@@ -33,6 +33,7 @@ def sample_int_enum(
             "nine": 9,
             "ten": 10,
         },
+        default="three",
     )
 
 
@@ -99,6 +100,7 @@ def sample_fields(env: ChannelEnvironment, enum: str = "SampleEnum") -> None:
                 1,
                 commandable=True,
                 description="Sample bit flag.",
+                default=True,
             )
         )
         env.add_field(
@@ -109,13 +111,19 @@ def sample_fields(env: ChannelEnvironment, enum: str = "SampleEnum") -> None:
                 2,
                 enum=enum if enum else None,
                 commandable=True,
+                default="three" if enum else 3,
                 description="Sample bit field.",
             )
         )
         env.add_field(
             BitField(
-                env.namespace(name="field2"), prim, 4, 4, commandable=True
-            )
+                env.namespace(name="field2"),
+                prim,
+                4,
+                4,
+                default=0,
+                commandable=True,
+            ).set_slider()
         )
 
 

runtimepy/channel/registry.py

@@ -16,7 +16,6 @@ from vcorelib.io.types import JsonObject as _JsonObject
 # internal
 from runtimepy.channel import AnyChannel as _AnyChannel
 from runtimepy.channel import Channel as _Channel
-from runtimepy.channel import Default as _Default
 from runtimepy.channel.event.header import PrimitiveEventHeader
 from runtimepy.codec.protocol import Protocol
 from runtimepy.mapping import DEFAULT_PATTERN
@@ -29,7 +28,7 @@ from runtimepy.primitives.types.base import PythonPrimitive
 from runtimepy.registry import Registry as _Registry
 from runtimepy.registry.name import NameRegistry as _NameRegistry
 from runtimepy.registry.name import RegistryKey as _RegistryKey
-from runtimepy.ui.controls import Controlslike, normalize_controls
+from runtimepy.ui.controls import Controlslike, Default, normalize_controls
 
 
 class ChannelNameRegistry(_NameRegistry):
@@ -92,7 +91,7 @@ class ChannelRegistry(_Registry[_Channel[_Any]]):
         enum: _RegistryKey = None,
         scaling: ChannelScaling = None,
         description: str = None,
-        default: _Default = None,
+        default: Default = None,
         controls: Controlslike = None,
         **kwargs,
     ) -> _Optional[_AnyChannel]:

runtimepy/codec/protocol/base.py

@@ -47,6 +47,10 @@ class FieldSpec(NamedTuple):
     enum: _Optional[_RegistryKey] = None
     array_length: _Optional[int] = None
 
+    def is_array(self) -> bool:
+        """Determine if this instance is an array."""
+        return self.array_length is not None and self.array_length > 1
+
     def asdict(self) -> _JsonObject:
         """Obtain a dictionary representing this instance."""
 
@@ -91,14 +95,14 @@ class ProtocolBase(PrimitiveArray):
         self.alias = alias
 
         # Register the byte-order enumeration if it's not present.
-        self._enum_registry = enum_registry
-        if not self._enum_registry.get("ByteOrder"):
-            _ByteOrder.register_enum(self._enum_registry)
+        self.enum_registry = enum_registry
+        if not self.enum_registry.get("ByteOrder"):
+            _ByteOrder.register_enum(self.enum_registry)
 
         # Each instance gets its own array.
         if not isinstance(byte_order, _ByteOrder):
             byte_order = _ByteOrder(
-                self._enum_registry["ByteOrder"].get_int(byte_order)
+                self.enum_registry["ByteOrder"].get_int(byte_order)
             )
 
         super().__init__(byte_order=byte_order)
@@ -108,14 +112,14 @@ class ProtocolBase(PrimitiveArray):
         self.names = names
 
         if fields is None:
-            fields = BitFieldsManager(self.names, self._enum_registry)
+            fields = BitFieldsManager(self.names, self.enum_registry)
         self._fields = fields
 
         self._regular_fields: dict[str, list[_AnyPrimitive]] = {}
         self._enum_fields: dict[str, _RuntimeEnum] = {}
 
         # Keep track of the order that the protocol was created.
-        self._build: ProtocolBuild = []
+        self.build: ProtocolBuild = []
 
         # Keep track of named serializables.
         self.serializables: SerializableMap = {}
@@ -154,10 +158,10 @@ class ProtocolBase(PrimitiveArray):
         """Create another protocol instance from this one."""
 
         return self.__class__(
-            self._enum_registry,
+            self.enum_registry,
             names=self.names,
             fields=_copy(self._fields),
-            build=self._build,
+            build=self.build,
             byte_order=self.byte_order,
             identifier=self.id,
             identifier_primitive=self.id_primitive.kind.name,
@@ -183,7 +187,7 @@ class ProtocolBase(PrimitiveArray):
         self.register_name(name)
 
         instances = self.add_to_end(serializable, array_length=array_length)
-        self._build.append((name, len(instances)))
+        self.build.append((name, len(instances)))
 
         assert name not in self.serializables, name
         self.serializables[name] = instances
@@ -209,8 +213,9 @@ class ProtocolBase(PrimitiveArray):
 
         self.register_name(name)
 
+        runtime_enum = None
         if enum is not None:
-            runtime_enum = self._enum_registry[enum]
+            runtime_enum = self.enum_registry[enum]
             self._enum_fields[name] = runtime_enum
 
             # Allow the primitive type to be overridden when passed as a
@@ -221,13 +226,20 @@ class ProtocolBase(PrimitiveArray):
         assert kind is not None
         inst = _normalize_instance(kind)
 
+        # Set enum defaults.
+        if runtime_enum is not None and runtime_enum.default:
+            inst.value = runtime_enum.get_int(runtime_enum.default)
+
         assert name not in self._regular_fields, name
         self._regular_fields[name] = self.add(inst, array_length=array_length)
 
         if track:
-            self._build.append(
+            self.build.append(
                 FieldSpec(
-                    name, inst.kind.name, enum, array_length=array_length
+                    name,
+                    inst.kind.name,
+                    enum,
+                    array_length=array_length,
                 )
             )
 
@@ -240,7 +252,7 @@ class ProtocolBase(PrimitiveArray):
         if index is None:
             index = self._fields.add(fields)
 
-        self._build.append((index, name))
+        self.build.append((index, name))
         self.add_field(name, kind=fields.raw, track=False)
 
     @contextmanager
@@ -253,6 +265,14 @@ class ProtocolBase(PrimitiveArray):
         yield new
         self._add_bit_fields(name, new)
 
+    def get_primitive(self, name: str, index: int = 0) -> _AnyPrimitive:
+        """Get an underlying primitive instance."""
+        return self._regular_fields[name][index]
+
+    def get_fields(self, index: int) -> _BitFields:
+        """Get a bit-fields instance from its build identifier."""
+        return self._fields.fields[index]
+
     def value(
         self, name: str, resolve_enum: bool = True, index: int = 0
     ) -> ProtocolPrimitive:
@@ -261,7 +281,7 @@ class ProtocolBase(PrimitiveArray):
         val: ProtocolPrimitive = 0
 
         if name in self._regular_fields:
-            val = self._regular_fields[name][index].value
+            val = self.get_primitive(name, index=index).value
 
             # Resolve the enum value.
             if resolve_enum and name in self._enum_fields:

runtimepy/codec/protocol/json.py

@@ -74,7 +74,7 @@ class JsonProtocol(ProtocolBase):
         json_obj.update(
             {
                 name: _cast(_JsonValue, val.asdict())
-                for name, val in self._enum_registry.items.items()
+                for name, val in self.enum_registry.items.items()
                 if val.id in enum_ids and name not in json_obj
             }
         )
@@ -83,7 +83,7 @@ class JsonProtocol(ProtocolBase):
         build: list[
             _Union[tuple[int, str], _JsonObject, str, tuple[str, int]]
         ] = []
-        for item in self._build:
+        for item in self.build:
             if isinstance(item, FieldSpec):
                 build.append(item.asdict())
             else:
@@ -120,7 +120,9 @@ class JsonProtocol(ProtocolBase):
             if isinstance(item, dict):
                 build.append(
                     FieldSpec(
-                        item["name"], item["kind"], enum=item.get("enum")
+                        item["name"],
+                        item["kind"],
+                        enum=item.get("enum"),
                     )
                 )
             else:

runtimepy/codec/system/__init__.py

@@ -14,6 +14,7 @@ from vcorelib.namespace import CPP_DELIM, Namespace
 from runtimepy.codec.protocol import Protocol
 from runtimepy.enum import RuntimeEnum
 from runtimepy.enum.registry import DEFAULT_ENUM_PRIMITIVE, RuntimeIntEnum
+from runtimepy.mixins.logging import LogLevel
 from runtimepy.primitives.byte_order import (
     DEFAULT_BYTE_ORDER,
     ByteOrder,
@@ -65,7 +66,7 @@ class TypeSystem(LoggerMixin):
         self.root_namespace = global_namespace
 
         # Register enums.
-        for enum in [ByteOrder]:
+        for enum in [ByteOrder, LogLevel]:
             self.runtime_int_enum(enum)
 
         self.root_namespace = global_namespace.child(*namespace)
@@ -103,12 +104,15 @@ class TypeSystem(LoggerMixin):
         items: dict[str, int],
         *namespace: str,
         primitive: str = DEFAULT_ENUM_PRIMITIVE,
+        default: Union[str, bool, int] = None,
     ) -> None:
         """Register an enumeration."""
 
         name = self._name(name, *namespace, check_available=True)
 
-        enum = self._enums.enum(name, "int", items=items, primitive=primitive)
+        enum = self._enums.enum(
+            name, "int", items=items, primitive=primitive, default=default
+        )
         assert enum is not None
         self._register_primitive(name, enum.primitive)
 

runtimepy/control/source.py

@@ -62,7 +62,7 @@ class PrimitiveSource(RuntimeStruct, Generic[T]):
             )
 
 
-class DoubleSource(PrimitiveSource[Double]):
+class DoubleSource(PrimitiveSource[Double]):  # pylint:disable=abstract-method
     """A simple double output source."""
 
     kind = Double

runtimepy/data/404.md

@@ -0,0 +1,16 @@
+# Resource Not Found (404)
+
+---
+
+<span id="target-label">target: <a id="target"></a></span>
+<script>
+const target = new URLSearchParams(window.location.search).get("target");
+if (target) {
+  document.getElementById("target").href = target;
+  document.getElementById("target").innerHTML = target;
+} else {
+  document.getElementById("target-label").style.display = "none";
+}
+</script>
+
+home: [/](/)

runtimepy/data/base.yaml

@@ -9,6 +9,9 @@ config:
   # Default redirects.
   http_redirects:
     "/": "/index.html"
+
+    # wait for #326
+    # "/index.html": "/mux.html"
     "/index.html": "/app.html"
 
   # Serve these applications by default at these paths.

runtimepy/data/css/bootstrap_extra.css

@@ -1,23 +1,3 @@
-.flex-column-scroll-bodge {
-  height: 100%;
-  flex-wrap: nowrap;
-  overflow-y: scroll;
-  flex-shrink: 0;
-}
-
-.scroll {
-  overflow: scroll;
-}
-
-.tab-content-bodge {
-  width: 100%;
-  height: 100%;
-}
-
-.button-bodge {
-  text-align: left;
-}
-
 .collapsing {
   transition: none !important;
 }
@@ -35,24 +15,9 @@
   max-width: 80%;
 }
 
-.table {
-  margin-bottom: 0;
-  width: auto;
-}
-
-.table-container {
-  overflow-x: scroll;
-  min-height: fit-content;
-}
-
 .channel-column {
-  overflow-y: scroll;
-  overflow-x: hidden;
-  flex-grow: 0;
-  flex-shrink: 0;
-
   /* Don't allow plot area to become too hidden. */
-  max-width: 75%;
+  max-width: min-content;
 }
 
 .channel-value {
@@ -75,36 +40,86 @@ select.form-select:hover {
 }
 
 textarea.text-logs {
-  min-height: 10em !important;
-  padding-top: 0 !important;
-  padding-bottom: 0 !important;
-
-  border-top: 0;
+  min-height: 6em !important;
+  font-size: 14px;
+  background-image: linear-gradient(var(--bs-secondary-bg), var(--bs-tertiary-bg), var(--bs-secondary-bg));
 }
 
 .vertical-divider {
-  flex-basis: 0.75em;
-  flex-grow: 0;
-  flex-shrink: 0;
+  flex-basis: 1.0em;
+}
+
+.text-code {
+  color: var(--bs-code-color) !important;
 }
 
 pre {
   color: var(--bs-code-color);
 }
 
+input:hover {
+  background-color: var(--bs-tertiary-bg);
+}
+
+input[type=range] {
+  touch-action: none;
+}
+
+input[type=checkbox]:hover {
+  cursor: pointer;
+}
+
 .vertical-divider:hover {
   cursor: col-resize;
   background-color: var(--bs-highlight-bg) !important;
 }
 
+td, th {
+  background: 0 !important;
+}
+
 button:hover {
   background-color: var(--bs-tertiary-bg);
 }
 
+select:hover {
+  background-color: var(--bs-tertiary-bg);
+}
+
 .channel-value-input {
   width: 6em;
 }
 
+.bg-gradient-secondary-to-bottom {
+  background-image: linear-gradient(to bottom right, rgba(var(--bs-secondary-bg-rgb), 0), var(--bs-secondary-bg));
+}
+
+.bg-gradient-tertiary-to-bottom {
+  background-image: linear-gradient(to bottom, rgba(var(--bs-tertiary-bg-rgb), 0), var(--bs-tertiary-bg));
+}
+
+.bg-gradient-secondary-to-top {
+  background-image: linear-gradient(to top right, rgba(var(--bs-secondary-bg-rgb), 0), var(--bs-secondary-bg));
+}
+
+.bg-gradient-tertiary-to-top {
+  background-image: linear-gradient(to top, rgba(var(--bs-tertiary-bg-rgb), 0), var(--bs-tertiary-bg));
+}
+
+.bg-gradient-tertiary-top-bottom {
+  background-image: linear-gradient(to bottom, 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);
+}
+.border-end-info-subtle {
+  border-right: var(--bs-border-width) var(--bs-border-style) var(--bs-info-border-subtle);
+}
+button.border-end-info-subtle:hover {
+  border-right: var(--bs-border-width) var(--bs-border-style) var(--bs-info-border-subtle);
+}
+
 /* Prefer 'CascadiaCode' and 'CascadiaMono' at the highest priority. */
 :root, [data-bs-theme=dark], [data-bs-theme=light] {
   --bs-font-sans-serif: CascadiaCode, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", "Liberation Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";