synodic-client 0.0.1.dev48__tar.gz → 0.0.1.dev50__tar.gz

{synodic_client-0.0.1.dev48 → synodic_client-0.0.1.dev50}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: synodic_client
-Version: 0.0.1.dev48
+Version: 0.0.1.dev50
 Author-Email: Synodic Software <contact@synodic.software>
 License: LGPL-3.0-or-later
 Project-URL: homepage, https://github.com/synodic/synodic-client
@@ -8,7 +8,7 @@ Project-URL: repository, https://github.com/synodic/synodic-client
 Requires-Python: <3.15,>=3.14
 Requires-Dist: pyside6>=6.10.2
 Requires-Dist: packaging>=26.0
-Requires-Dist: porringer>=0.2.1.dev73
+Requires-Dist: porringer>=0.2.1.dev74
 Requires-Dist: qasync>=0.28.0
 Requires-Dist: velopack>=0.0.1444.dev49733
 Requires-Dist: typer>=0.24.1

{synodic_client-0.0.1.dev48 → synodic_client-0.0.1.dev50}/pyproject.toml

@@ -10,12 +10,12 @@ requires-python = ">=3.14, <3.15"
 dependencies = [
     "pyside6>=6.10.2",
     "packaging>=26.0",
-    "porringer>=0.2.1.dev73",
+    "porringer>=0.2.1.dev74",
     "qasync>=0.28.0",
     "velopack>=0.0.1444.dev49733",
     "typer>=0.24.1",
 ]
-version = "0.0.1.dev48"
+version = "0.0.1.dev50"
 
 [project.license]
 text = "LGPL-3.0-or-later"

{synodic_client-0.0.1.dev48 → synodic_client-0.0.1.dev50}/synodic_client/__init__.py

@@ -3,13 +3,13 @@
 import importlib.metadata
 
 from synodic_client.client import Client
-from synodic_client.updater import (
+from synodic_client.schema import (
     UpdateChannel,
     UpdateConfig,
     UpdateInfo,
-    Updater,
     UpdateState,
 )
+from synodic_client.updater import Updater
 
 try:
     __version__ = importlib.metadata.version('synodic_client')

{synodic_client-0.0.1.dev48 → synodic_client-0.0.1.dev50}/synodic_client/application/bootstrap.py

@@ -17,10 +17,9 @@ import sys
 
 from synodic_client.config import set_dev_mode
 from synodic_client.logging import configure_logging
+from synodic_client.protocol import extract_uri_from_args
 from synodic_client.updater import initialize_velopack
 
-_PROTOCOL_SCHEME = 'synodic'
-
 # Parse --dev flag early so logging uses the right filename.
 _dev_mode = '--dev' in sys.argv[1:]
 set_dev_mode(_dev_mode)
@@ -36,5 +35,4 @@ if not _dev_mode:
 # Heavy imports happen here — PySide6, porringer, etc.
 from synodic_client.application.qt import application
 
-_uri = next((a for a in sys.argv[1:] if a.lower().startswith(f'{_PROTOCOL_SCHEME}://')), None)
-application(uri=_uri, dev_mode=_dev_mode)
+application(uri=extract_uri_from_args(), dev_mode=_dev_mode)

{synodic_client-0.0.1.dev48 → synodic_client-0.0.1.dev50}/synodic_client/application/data.py

@@ -14,7 +14,6 @@ from __future__ import annotations
 
 import asyncio
 import logging
-from dataclasses import dataclass, field
 
 from porringer.api import API
 from porringer.backend.command.core.discovery import DiscoveredPlugins
@@ -22,36 +21,11 @@ from porringer.core.plugin_schema.plugin_manager import PluginManager
 from porringer.schema import (
     CheckParameters,
     CheckResult,
-    DirectoryValidationResult,
-    ManifestDirectory,
-    PluginInfo,
 )
 
-logger = logging.getLogger(__name__)
-
-
-@dataclass(slots=True)
-class Snapshot:
-    """Immutable bundle of data produced by a single refresh cycle.
-
-    All fields are populated by :meth:`DataCoordinator.refresh` and
-    remain stable until the next refresh.
-    """
+from synodic_client.application.schema import Snapshot
 
-    plugins: list[PluginInfo] = field(default_factory=list)
-    """All discovered plugins with install status and version info."""
-
-    directories: list[ManifestDirectory] = field(default_factory=list)
-    """Cached project directories (un-validated)."""
-
-    validated_directories: list[DirectoryValidationResult] = field(default_factory=list)
-    """Cached directories with ``exists`` / ``has_manifest`` validation."""
-
-    discovered: DiscoveredPlugins | None = None
-    """Full plugin discovery result including runtime context."""
-
-    plugin_managers: dict[str, PluginManager] = field(default_factory=dict)
-    """Project-environment plugins implementing the ``PluginManager`` protocol."""
+logger = logging.getLogger(__name__)
 
 
 class DataCoordinator:

{synodic_client-0.0.1.dev48 → synodic_client-0.0.1.dev50}/synodic_client/application/init.py

@@ -23,7 +23,11 @@ from synodic_client.startup import register_startup, remove_startup
 
 logger = logging.getLogger(__name__)
 
-_preamble_done = False
+
+class _PreambleState:
+    """Module-level mutable state (avoids ``global`` statements)."""
+
+    done: bool = False
 
 
 def run_startup_preamble(exe_path: str | None = None) -> None:
@@ -39,10 +43,9 @@ def run_startup_preamble(exe_path: str | None = None) -> None:
         exe_path: Absolute path to the application executable.  Defaults
             to ``sys.executable`` when not supplied.
     """
-    global _preamble_done  # noqa: PLW0603
-    if _preamble_done:
+    if _PreambleState.done:
         return
-    _preamble_done = True
+    _PreambleState.done = True
 
     if exe_path is None:
         exe_path = sys.executable

{synodic_client-0.0.1.dev48 → synodic_client-0.0.1.dev50}/synodic_client/application/qt.py

@@ -24,6 +24,7 @@ from synodic_client.application.uri import parse_uri
 from synodic_client.client import Client
 from synodic_client.config import set_dev_mode
 from synodic_client.logging import configure_logging
+from synodic_client.protocol import extract_uri_from_args
 from synodic_client.resolution import (
     ResolvedConfig,
     resolve_config,
@@ -187,8 +188,5 @@ def application(*, uri: str | None = None, dev_mode: bool = False) -> None:
         loop.run_forever()
 
 
-_PROTOCOL_SCHEME = 'synodic'
-
 if __name__ == '__main__':
-    _uri = next((a for a in sys.argv[1:] if a.lower().startswith(f'{_PROTOCOL_SCHEME}://')), None)
-    application(uri=_uri)
+    application(uri=extract_uri_from_args())

synodic_client-0.0.1.dev50/synodic_client/application/schema.py

@@ -0,0 +1,53 @@
+"""Application-layer data models.
+
+Contains data structures shared across application modules — the
+``DataCoordinator`` snapshot and the tool-update result summary.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from porringer.backend.command.core.discovery import DiscoveredPlugins
+from porringer.core.plugin_schema.plugin_manager import PluginManager
+from porringer.schema import (
+    DirectoryValidationResult,
+    ManifestDirectory,
+    PluginInfo,
+)
+
+
+@dataclass(slots=True)
+class Snapshot:
+    """Immutable bundle of data produced by a single refresh cycle.
+
+    All fields are populated by :meth:`DataCoordinator.refresh` and
+    remain stable until the next refresh.
+    """
+
+    plugins: list[PluginInfo] = field(default_factory=list)
+    """All discovered plugins with install status and version info."""
+
+    directories: list[ManifestDirectory] = field(default_factory=list)
+    """Cached project directories (un-validated)."""
+
+    validated_directories: list[DirectoryValidationResult] = field(default_factory=list)
+    """Cached directories with ``exists`` / ``has_manifest`` validation."""
+
+    discovered: DiscoveredPlugins | None = None
+    """Full plugin discovery result including runtime context."""
+
+    plugin_managers: dict[str, PluginManager] = field(default_factory=dict)
+    """Project-environment plugins implementing the ``PluginManager`` protocol."""
+
+
+@dataclass(slots=True)
+class ToolUpdateResult:
+    """Summary of a tool-update run across cached manifests."""
+
+    manifests_processed: int = 0
+    updated: int = 0
+    already_latest: int = 0
+    failed: int = 0
+    updated_packages: set[str] = field(default_factory=set)
+    """Package names that were successfully upgraded."""

{synodic_client-0.0.1.dev48 → synodic_client-0.0.1.dev50}/synodic_client/application/screen/__init__.py

@@ -6,9 +6,15 @@ execution log panel live here to avoid circular imports.
 
 from __future__ import annotations
 
+from datetime import UTC, datetime
+
 from porringer.schema import SetupAction, SkipReason
 from porringer.schema.plugin import PluginKind
 
+_SECONDS_PER_MINUTE = 60
+_MINUTES_PER_HOUR = 60
+_HOURS_PER_DAY = 24
+
 ACTION_KIND_LABELS: dict[PluginKind | None, str] = {
     PluginKind.PACKAGE: 'Package',
     PluginKind.TOOL: 'Tool',
@@ -57,15 +63,45 @@ def skip_reason_label(reason: SkipReason | None) -> str:
     return SKIP_REASON_LABELS.get(reason, reason.name.replace('_', ' ').capitalize())
 
 
-def format_cli_command(action: SetupAction) -> str:
+def format_cli_command(action: SetupAction, *, suppress_description: bool = False) -> str:
     """Return a human-readable CLI command string for *action*.
 
     Prefers ``cli_command``, falls back to ``command``, then synthesises
     an ``installer install <package>`` string for package actions, and
     finally returns the action description as a last resort.
+
+    When *suppress_description* is ``True`` the final description
+    fallback returns an empty string instead.
     """
     if parts := (action.cli_command or action.command):
         return ' '.join(parts)
     if action.kind == PluginKind.PACKAGE and action.package:
         return f'{action.installer or "pip"} install {action.package}'
-    return action.description
+    return '' if suppress_description else action.description
+
+
+def _format_relative_time(iso_timestamp: str) -> str:
+    """Format an ISO 8601 timestamp as a human-readable relative time.
+
+    Returns strings like ``'just now'``, ``'5m ago'``, ``'2h ago'``,
+    ``'3d ago'``.  Returns an empty string if the timestamp cannot be
+    parsed.
+    """
+    try:
+        dt = datetime.fromisoformat(iso_timestamp)
+        if dt.tzinfo is None:
+            dt = dt.replace(tzinfo=UTC)
+        delta = datetime.now(UTC) - dt
+        seconds = max(int(delta.total_seconds()), 0)
+        if seconds < _SECONDS_PER_MINUTE:
+            return 'just now'
+        minutes = seconds // _SECONDS_PER_MINUTE
+        if minutes < _MINUTES_PER_HOUR:
+            return f'{minutes}m ago'
+        hours = minutes // _MINUTES_PER_HOUR
+        if hours < _HOURS_PER_DAY:
+            return f'{hours}h ago'
+        days = hours // _HOURS_PER_DAY
+        return f'{days}d ago'
+    except ValueError, TypeError:
+        return ''

{synodic_client-0.0.1.dev48 → synodic_client-0.0.1.dev50}/synodic_client/application/screen/action_card.py

@@ -16,8 +16,8 @@ import logging
 from porringer.backend.command.core.action_builder import PHASE_ORDER
 from porringer.schema import SetupAction, SetupActionResult, SkipReason
 from porringer.schema.plugin import PluginKind
-from PySide6.QtCore import QRect, Qt, QTimer, Signal
-from PySide6.QtGui import QColor, QPainter, QPen
+from PySide6.QtCore import Qt, QTimer, Signal
+from PySide6.QtGui import QColor
 from PySide6.QtWidgets import (
     QApplication,
     QCheckBox,
@@ -30,6 +30,7 @@ from PySide6.QtWidgets import (
 )
 
 from synodic_client.application.screen import ACTION_KIND_LABELS, format_cli_command, skip_reason_label
+from synodic_client.application.screen.spinner import SpinnerCanvas
 from synodic_client.application.theme import (
     ACTION_CARD_COMMAND_STYLE,
     ACTION_CARD_DESC_STYLE,
@@ -66,9 +67,6 @@ _UPDATE_AVAILABLE_COLOR = QColor('#d7ba7d')
 #: Timer interval for per-card inline spinner (ms).
 _SPINNER_INTERVAL = 50
 
-#: Arc span for per-card spinner (degrees × 16 for Qt drawArc).
-_SPINNER_ARC = 90
-
 
 #: Sort priority derived from porringer's execution phase order so the
 #: display order always matches the order actions actually execute.
@@ -101,62 +99,6 @@ def action_sort_key(action: SetupAction) -> int:
     return _KIND_ORDER.get(action.kind, len(PHASE_ORDER))
 
 
-def _format_command(action: SetupAction) -> str:
-    """Return a short CLI command string for display.
-
-    Wraps :func:`~synodic_client.application.screen.format_cli_command`
-    but returns an empty string instead of the description fallback so
-    cards only show an explicit command line.
-    """
-    text = format_cli_command(action)
-    return '' if text == action.description else text
-
-
-# ---------------------------------------------------------------------------
-# _CardSpinner — tiny per-card inline spinner
-# ---------------------------------------------------------------------------
-
-
-class _CardSpinner(QWidget):
-    """Tiny spinning arc used inside an :class:`ActionCard` while checking.
-
-    The spinner replaces the status text label during the dry-run check
-    phase and is hidden once the result arrives.
-    """
-
-    def __init__(self, parent: QWidget | None = None) -> None:
-        super().__init__(parent)
-        self._angle = 0
-        self.setFixedSize(ACTION_CARD_SPINNER_SIZE, ACTION_CARD_SPINNER_SIZE)
-
-    def paintEvent(self, _event: object) -> None:
-        """Draw the muted track and animated highlight arc."""
-        painter = QPainter(self)
-        painter.setRenderHint(QPainter.RenderHint.Antialiasing)
-
-        m = ACTION_CARD_SPINNER_PEN // 2 + 1
-        rect = QRect(m, m, self.width() - 2 * m, self.height() - 2 * m)
-
-        # Track circle
-        track_pen = QPen(self.palette().mid(), ACTION_CARD_SPINNER_PEN)
-        track_pen.setCapStyle(Qt.PenCapStyle.RoundCap)
-        painter.setPen(track_pen)
-        painter.drawEllipse(rect)
-
-        # Highlight arc
-        hl_pen = QPen(self.palette().highlight(), ACTION_CARD_SPINNER_PEN)
-        hl_pen.setCapStyle(Qt.PenCapStyle.RoundCap)
-        painter.setPen(hl_pen)
-        painter.drawArc(rect, self._angle * 16, _SPINNER_ARC * 16)
-
-        painter.end()
-
-    def tick(self) -> None:
-        """Advance the arc and repaint."""
-        self._angle = (self._angle - 10) % 360
-        self.update()
-
-
 # ---------------------------------------------------------------------------
 # ActionCard — a single action row
 # ---------------------------------------------------------------------------
@@ -297,7 +239,11 @@ class ActionCard(QFrame):
         top.addWidget(self._version_label)
 
         # Inline spinner (replaces status text while checking)
-        self._spinner_canvas = _CardSpinner(self)
+        self._spinner_canvas = SpinnerCanvas(
+            size=ACTION_CARD_SPINNER_SIZE,
+            pen_width=ACTION_CARD_SPINNER_PEN,
+            parent=self,
+        )
         self._spinner_canvas.hide()
         self._spinner_timer = QTimer(self)
         self._spinner_timer.setInterval(_SPINNER_INTERVAL)
@@ -418,7 +364,7 @@ class ActionCard(QFrame):
             self._desc_label.hide()
 
         # CLI command (always visible when present)
-        cmd_text = _format_command(action)
+        cmd_text = format_cli_command(action, suppress_description=True)
         if cmd_text:
             self._command_label.setText(cmd_text)
             self._command_row.show()
@@ -461,7 +407,7 @@ class ActionCard(QFrame):
         """
         if self._is_skeleton:
             return
-        cmd_text = _format_command(action)
+        cmd_text = format_cli_command(action, suppress_description=True)
         if cmd_text:
             self._command_label.setText(cmd_text)
             self._command_row.show()