plesty-server 0.2.1__py3-none-any.whl

plesty/server/__init__.py

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: 2026 Yunshuang Yuan
+# SPDX-License-Identifier: LGPL-3.0-or-later
+
+"""Server plesty module."""
+
+from typing import Any
+
+from plesty.lib.utils.config import module_config
+
+__all__ = [
+    "load_config",
+]
+
+
+def load_config() -> dict[str, Any]:
+    """Load the packaged module configuration (constants and running defaults).
+
+    Returns:
+        The parsed ``config.yaml`` shipped with this module.
+    """
+    config: dict[str, Any] = module_config(__name__)
+    return config

plesty/server/__main__.py

@@ -0,0 +1,9 @@
+# SPDX-FileCopyrightText: 2026 Yunshuang Yuan
+# SPDX-License-Identifier: LGPL-3.0-or-later
+
+"""``python -m plesty.server`` — the ``plesty-server`` command line."""
+
+from plesty.server.cli.main import main
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

plesty/server/assets/console.qss

@@ -0,0 +1,321 @@
+/* SPDX-FileCopyrightText: 2026 Yunshuang Yuan
+ * SPDX-License-Identifier: LGPL-3.0-or-later
+ *
+ * Qt stylesheet of the plesty-server console. The double-braced placeholders are
+ * substituted from plesty-lib's palette.json (plesty.net design tokens) at
+ * load time — colours are the platform's, the layout is ours; the two font
+ * tokens are filled with families the host actually has (see view.app).
+ */
+
+QWidget {
+  background: {{night}};
+  color: {{text}};
+  font-family: {{ui_font}};
+  font-size: 13px;
+}
+
+QMainWindow, QDialog {
+  background: {{night}};
+}
+
+/* ── Menu bar and menus ─────────────────────────────────────────────────── */
+
+QMenuBar {
+  background: {{night2}};
+  border-bottom: 1px solid {{line}};
+  padding: 2px 6px;
+}
+
+QMenuBar::item {
+  background: transparent;
+  padding: 4px 10px;
+  border-radius: 6px;
+}
+
+QMenuBar::item:selected {
+  background: {{surface3}};
+  color: {{text_bright}};
+}
+
+QMenu {
+  background: {{surface2}};
+  border: 1px solid {{line_strong}};
+  border-radius: 8px;
+  padding: 4px;
+}
+
+QMenu::item {
+  padding: 5px 24px 5px 14px;
+  border-radius: 5px;
+}
+
+QMenu::item:selected {
+  background: {{selection}};
+  color: {{text_bright}};
+}
+
+QMenu::item:disabled {
+  color: {{faint}};
+}
+
+QMenu::separator {
+  height: 1px;
+  background: {{line}};
+  margin: 4px 8px;
+}
+
+/* ── Cards: the device table and the detail pane ────────────────────────── */
+
+#card {
+  background: {{surface}};
+  border: 1px solid {{line}};
+  border-radius: 10px;
+}
+
+#cardTitle {
+  background: transparent;
+  color: {{text}};
+  font-size: 12px;
+  font-weight: 600;
+  letter-spacing: 0.02em;
+  padding: 2px 4px;
+}
+
+#cardCaption {
+  background: transparent;
+  color: {{muted}};
+  font-family: {{mono_font}};
+  font-size: 11px;
+}
+
+QTableWidget, QTableView {
+  background: {{surface}};
+  alternate-background-color: {{surface2}};
+  border: none;
+  gridline-color: {{line}};
+  selection-background-color: {{selection}};
+  selection-color: {{text_bright}};
+}
+
+QHeaderView::section {
+  background: {{surface2}};
+  color: {{muted}};
+  border: none;
+  border-bottom: 1px solid {{line_strong}};
+  padding: 5px 8px;
+  font-size: 11px;
+  font-weight: 600;
+  letter-spacing: 0.04em;
+}
+
+QTableWidget::item {
+  padding: 4px 8px;
+}
+
+/* State chip text colours — the window-chrome language of plesty.net. */
+#stateChip {
+  font-size: 12px;
+  font-weight: 600;
+}
+
+QLabel[tone="running"] { color: {{mint}}; }
+QLabel[tone="starting"] { color: {{amber}}; }
+QLabel[tone="exited"] { color: {{rose}}; }
+QLabel[tone="stopped"] { color: {{slate}}; }
+QLabel[tone="done"] { color: {{mint}}; }
+QLabel[tone="failed"] { color: {{rose}}; }
+
+/* ── Log panes ──────────────────────────────────────────────────────────── */
+
+QPlainTextEdit, QTextEdit {
+  background: {{plot_bg}};
+  color: {{text}};
+  border: 1px solid {{line}};
+  border-radius: 8px;
+  font-family: {{mono_font}};
+  font-size: 11px;
+  padding: 6px;
+  selection-background-color: {{selection}};
+}
+
+QTabWidget::pane {
+  border: none;
+  background: transparent;
+}
+
+QTabBar::tab {
+  background: transparent;
+  color: {{muted}};
+  padding: 6px 14px;
+  border-bottom: 2px solid transparent;
+}
+
+QTabBar::tab:selected {
+  color: {{cyan}};
+  border-bottom: 2px solid {{cyan}};
+}
+
+QTabBar::tab:hover {
+  color: {{text_bright}};
+}
+
+/* ── Controls ───────────────────────────────────────────────────────────── */
+
+QPushButton {
+  background: {{surface2}};
+  color: {{text}};
+  border: 1px solid {{line_strong}};
+  border-radius: 7px;
+  padding: 5px 14px;
+}
+
+QPushButton:hover {
+  background: {{surface3}};
+  color: {{text_bright}};
+}
+
+QPushButton:pressed {
+  background: {{selection}};
+}
+
+QPushButton:disabled {
+  color: {{faint}};
+  border-color: {{line}};
+}
+
+QPushButton#primary {
+  background: {{blue}};
+  border-color: {{blue}};
+  color: {{text_bright}};
+}
+
+QPushButton#primary:hover {
+  background: {{cyan}};
+  border-color: {{cyan}};
+  color: {{night}};
+}
+
+QPushButton#danger {
+  border-color: {{rose}};
+  color: {{rose}};
+}
+
+/* Card-header buttons: compact, quiet until hovered. */
+QPushButton#toolButton, QPushButton#primary, QPushButton#danger {
+  padding: 3px 10px;
+  font-size: 12px;
+}
+
+QPushButton#toolButton {
+  background: transparent;
+}
+
+QPushButton#toolButton:hover {
+  background: {{surface3}};
+}
+
+QPushButton#primary:disabled, QPushButton#danger:disabled {
+  background: transparent;
+  border-color: {{line}};
+  color: {{faint}};
+}
+
+QLineEdit, QComboBox, QSpinBox, QPlainTextEdit#editor {
+  background: {{surface2}};
+  border: 1px solid {{line_strong}};
+  border-radius: 6px;
+  padding: 4px 8px;
+  selection-background-color: {{selection}};
+}
+
+QLineEdit:focus, QComboBox:focus, QSpinBox:focus {
+  border-color: {{cyan}};
+}
+
+QComboBox QAbstractItemView {
+  background: {{surface2}};
+  border: 1px solid {{line_strong}};
+  selection-background-color: {{selection}};
+}
+
+QCheckBox::indicator {
+  width: 14px;
+  height: 14px;
+  border: 1px solid {{line_strong}};
+  border-radius: 4px;
+  background: {{surface2}};
+}
+
+QCheckBox::indicator:checked {
+  background: {{cyan}};
+  border-color: {{cyan}};
+}
+
+QGroupBox {
+  border: 1px solid {{line}};
+  border-radius: 8px;
+  margin-top: 14px;
+  padding: 10px 8px 6px 8px;
+}
+
+QGroupBox::title {
+  subcontrol-origin: margin;
+  left: 10px;
+  padding: 0 4px;
+  color: {{muted}};
+  font-size: 11px;
+  font-weight: 600;
+}
+
+QStatusBar {
+  background: {{night2}};
+  border-top: 1px solid {{line}};
+  color: {{muted}};
+  font-family: {{mono_font}};
+  font-size: 11px;
+}
+
+QSplitter::handle {
+  background: {{night}};
+}
+
+QSplitter::handle:hover {
+  background: {{cyan}};
+}
+
+QScrollBar:vertical {
+  background: transparent;
+  width: 10px;
+  margin: 0;
+}
+
+QScrollBar::handle:vertical {
+  background: {{line_strong}};
+  border-radius: 5px;
+  min-height: 24px;
+}
+
+QScrollBar::add-line:vertical, QScrollBar::sub-line:vertical {
+  height: 0;
+}
+
+QScrollBar:horizontal {
+  background: transparent;
+  height: 10px;
+}
+
+QScrollBar::handle:horizontal {
+  background: {{line_strong}};
+  border-radius: 5px;
+}
+
+QScrollBar::add-line:horizontal, QScrollBar::sub-line:horizontal {
+  width: 0;
+}
+
+QToolTip {
+  background: {{surface3}};
+  color: {{text}};
+  border: 1px solid {{line_strong}};
+  padding: 4px 6px;
+}

plesty/server/assets/env.example

@@ -0,0 +1,12 @@
+# Credentials and addresses for this device instance. Read by the device
+# server and the field test (plesty.lib.utils.EnvSettings); the fleet's
+# `env:` and the process environment win over this file.
+#
+# This file stays on the bench: an address carries a serial number.
+
+# The instrument this instance talks to — a VISA resource, a serial port, a
+# vendor id; or `mock` for the module's simulator.
+DEVICE_ADDRESS=
+
+# Shared location every field-test run is also copied to (optional).
+PLESTY_REPORT_ARCHIVE=

plesty/server/assets/fleet.example.yaml

@@ -0,0 +1,44 @@
+# fleet.yaml — the device servers this bench runs.
+#
+#   plesty-server fleet up        install what is missing, start every autostart device
+#   plesty-server fleet run       same, then keep them up (headless bench mode)
+#   plesty-server fleet down      stop them
+#   plesty-server fleet status    who is running, on which port
+#
+# One entry per device instance. The key is the instance name: it names the
+# venv, the log file and the process record, so it must be unique per bench.
+
+version: 1
+
+# Where venvs, logs and process state live. Optional; defaults to
+# $PLESTY_SERVER_HOME, then ~/.plesty/server.
+# home: ~/.plesty/server
+
+# hub-registry catalogue used by `plesty-server search`. Optional.
+# index_url: https://hub.plesty.net/api/modules/
+
+devices:
+  # A Thorlabs PM100D power meter served on port 5555.
+  pm100d:
+    package: plesty-pm100d        # distribution name of the device module
+    # Source. A released module is installed from PyPI at `version`; until a
+    # module has a release, `git:` installs it from its repository (the form
+    # the hub catalogue advertises), `ref:` picks a branch/tag/commit and
+    # defaults to the tag v<version> when a version is given.
+    git: https://gitlab.com/plesty/hub/devices/thorlab/plesty-pm100d.git
+    # version: 0.2.1              # pinned release; omit to take the newest at install time
+    args: [--tcp-port, "5555", --address, "USB0::0x1313::0x8078::P0000000::INSTR"]
+    env:
+      # Anything the module reads from .env can go here instead — plesty-lib
+      # takes the process environment first. Never put credentials in a
+      # fleet file that leaves the bench.
+      PLESTY_REPORT_ARCHIVE: /shares/plesty/reports
+    autostart: true
+
+  # A second instance of the same package, on another port, not started
+  # automatically — `plesty-server start pm100d-spare` when needed.
+  pm100d-spare:
+    package: plesty-pm100d
+    git: https://gitlab.com/plesty/hub/devices/thorlab/plesty-pm100d.git
+    args: [--tcp-port, "5556", --mock]
+    autostart: false

plesty/server/assets/plesty-mark.svg

@@ -0,0 +1,54 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="177" height="177" viewBox="0 0 177 177" role="img" aria-labelledby="title desc">
+  <title id="title">Plesty mark</title>
+  <desc id="desc">A dark glass-style Plesty mark with coupled blue waveguide curves and a mint module.</desc>
+  <defs>
+    <linearGradient id="markGradientLeft" x1="94" y1="24" x2="94" y2="154" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#67e8f9"/>
+      <stop offset="0.52" stop-color="#3b82f6"/>
+      <stop offset="1" stop-color="#8b5cf6"/>
+    </linearGradient>
+    <linearGradient id="markGradientRight" x1="94" y1="24" x2="94" y2="154" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#67e8f9"/>
+      <stop offset="0.52" stop-color="#3b82f6"/>
+      <stop offset="1" stop-color="#8b5cf6"/>
+    </linearGradient>
+    <linearGradient id="mintGradient" x1="25" y1="89" x2="67" y2="126" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#34d399"/>
+      <stop offset="1" stop-color="#22d3ee"/>
+    </linearGradient>
+    <filter id="mintGlow" x="-80%" y="-80%" width="260%" height="260%" color-interpolation-filters="sRGB">
+      <feGaussianBlur in="SourceGraphic" stdDeviation="7" result="blur"/>
+      <feColorMatrix
+        in="blur"
+        type="matrix"
+        values="0 0 0 0 0.20
+                0 0 0 0 0.83
+                0 0 0 0 0.60
+                0 0 0 0.95 0"
+        result="coloredBlur"
+      />
+      <feMerge>
+        <feMergeNode in="coloredBlur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+    <filter id="whiteBorderGlow" x="-8%" y="-24%" width="116%" height="148%" color-interpolation-filters="sRGB">
+      <feGaussianBlur in="SourceGraphic" stdDeviation="3.5" result="blur"/>
+      <feMerge>
+        <feMergeNode in="blur"/>
+        <feMergeNode in="SourceGraphic"/>
+      </feMerge>
+    </filter>
+  </defs>
+
+  <rect width="177" height="177" fill="none"/>
+
+  <g>
+    <rect x="10" y="6" width="165" height="165" rx="0" fill="#0d1024" opacity="0.92"/>
+    <path d="M62 30 C94 40 108.5 66 108.5 89 C108.5 112 94 138 62 151" fill="none" stroke="url(#markGradientLeft)" stroke-width="34" stroke-linecap="butt" stroke-linejoin="round"/>
+    <path d="M155 30 C123 40 108.5 66 108.5 89 C108.5 112 123 138 155 151" fill="none" stroke="url(#markGradientRight)" stroke-width="34" stroke-linecap="butt" stroke-linejoin="round"/>
+    <rect x="26" y="91" width="36" height="36" transform="rotate(-22 44 109)" fill="#34d399" opacity="0.72" filter="url(#mintGlow)"/>
+    <rect x="26" y="91" width="36" height="36" transform="rotate(-22 44 109)" fill="url(#mintGradient)"/>
+  </g>
+  <rect x="9" y="5" width="166" height="166" rx="7" fill="none" stroke="#ffffff" stroke-opacity="0.72" stroke-width="2" filter="url(#whiteBorderGlow)"/>
+</svg>

plesty/server/cli/__init__.py

@@ -0,0 +1,14 @@
+# SPDX-FileCopyrightText: 2026 Yunshuang Yuan
+# SPDX-License-Identifier: LGPL-3.0-or-later
+
+"""Command-line entry point ``plesty-server``.
+
+The headless face of the bench: ``install``/``start``/``stop``/``status``/
+``log``/``field-test`` for one device and ``fleet up|down|status`` for a
+whole ``fleet.yaml``. Commands drive the :class:`~plesty.server.presenter.Bench`
+presenter — the same code paths the GUI takes, minus the view.
+"""
+
+from plesty.server.cli.main import app
+
+__all__ = ["app"]