Device node: a device's ports are wired in flows
- flow/nodes/device.py: `device` node with params `device` and `config`;
provides the device's `in` ports, requires its `out` ports without
waking anything, never run (Node.passive), down "Offline" from presence
- DeviceDef.io and DevicePort go; GET /devices/{id} computes `io` and
`bindings` from the device nodes of published flows, in a fixed order,
cached by FlowStore.revision; the credential's scope comes from them
- issues `unknown_device` and `device_port` (wired twice; against a report
the wrong direction or dtype, or unlisted as advisory), rechecked when a
device is created or deleted; ValidationIssue.advisory is a field
- a device publishing on a bound port is credited to its node by the
server; the panel endpoint kind is gone from `_endpoints` and the canvas
- a rebuild that moves a device's bindings sends `dashboard_changed` with
an empty name, which the firmware refetches on
- startup moves each device's `io` rows into device nodes in the flows
declaring their messages, draft and published, one commit; rows no
flow declares are logged and left out
- frontend: Device node settings (device, Publishes, Follows, a port
picker from a report), palette shortcuts per reported port, DeviceDetail
lists bindings with "Use in flow" in place of the I/O editor
- docs: devices, flow editor, node types, issues, API
This commit is contained in:
@@ -27,7 +27,7 @@ from datetime import UTC, datetime
|
||||
from functools import lru_cache
|
||||
from typing import Any, Literal, Protocol
|
||||
|
||||
from pydantic import BaseModel, computed_field
|
||||
from pydantic import BaseModel, model_validator
|
||||
|
||||
from fluksio.flow import logs
|
||||
from fluksio.flow.artifacts import is_reference
|
||||
@@ -63,6 +63,8 @@ class ValidationIssue(BaseModel):
|
||||
"missing_source",
|
||||
"node_unhealthy",
|
||||
"ignored_device",
|
||||
"unknown_device",
|
||||
"device_port",
|
||||
]
|
||||
message: str
|
||||
flow: str = ""
|
||||
@@ -70,12 +72,15 @@ class ValidationIssue(BaseModel):
|
||||
node: str | None = None
|
||||
port: str | None = None
|
||||
message_name: str | None = None
|
||||
#: Worth saying, but not a fault — the UI says so in a softer tone. Set
|
||||
#: by the code for most, by the issue itself where one code covers both.
|
||||
advisory: bool = False
|
||||
|
||||
@computed_field # type: ignore[prop-decorator]
|
||||
@property
|
||||
def advisory(self) -> bool:
|
||||
"""Worth saying, but not a fault — the UI says so in a softer tone."""
|
||||
return self.code in ADVISORY_ISSUES
|
||||
@model_validator(mode="after")
|
||||
def _advisory_by_code(self) -> ValidationIssue:
|
||||
if self.code in ADVISORY_ISSUES:
|
||||
self.advisory = True
|
||||
return self
|
||||
|
||||
|
||||
class ValueSource(BaseModel):
|
||||
@@ -229,7 +234,8 @@ def _derive(
|
||||
for node in nodes:
|
||||
for msg in node.provides:
|
||||
produces.setdefault(msg, []).append(node)
|
||||
for msg in node.requires:
|
||||
# A passive node is never run, so nothing published wakes it.
|
||||
for msg in () if node.passive else node.requires:
|
||||
consumes.setdefault(msg, []).append(node)
|
||||
by_id[node.id] = node
|
||||
|
||||
@@ -557,7 +563,8 @@ class Pipeline:
|
||||
)
|
||||
|
||||
for node in nodes:
|
||||
for msg_name, spec in node.requires.items():
|
||||
# A passive node never runs, so it waits for nothing.
|
||||
for msg_name, spec in () if node.passive else node.requires.items():
|
||||
if msg_name in produces:
|
||||
# A message a node both reads and writes carries state
|
||||
# between its runs. If the node is the only one writing it,
|
||||
@@ -1369,6 +1376,11 @@ class Pipeline:
|
||||
# not spend the synchronous claim it needs once it may run.
|
||||
if self._gate_blocks(n) or in_degree[n] != 0:
|
||||
continue
|
||||
if n.passive:
|
||||
# Something outside publishes for it; a run is not it.
|
||||
complete(n)
|
||||
progressed = True
|
||||
continue
|
||||
if fresh is not None and untouched(n):
|
||||
# Ahead of the readiness check, so an unchanged node
|
||||
# spends neither a delivery stamp nor a synchronous
|
||||
|
||||
Reference in New Issue
Block a user