ok-script 2.0.0b4__tar.gz → 2.0.0b5__tar.gz

{ok_script-2.0.0b4/ok_script.egg-info → ok_script-2.0.0b5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ok-script
-Version: 2.0.0b4
+Version: 2.0.0b5
 Summary: Automation with Computer Vision for Python
 Author-email: ok-oldking <firedcto@gmail.com>
 Project-URL: Homepage, https://github.com/ok-oldking/ok-script

{ok_script-2.0.0b4 → ok_script-2.0.0b5}/ok/ui/qt/MainWindow.py

@@ -6,7 +6,8 @@ from PySide6.QtCore import QCoreApplication, QEvent, QSize, Qt, QTimer
 from PySide6.QtGui import QColor, QScreen
 from PySide6.QtWidgets import QMenu, QSystemTrayIcon, QApplication
 from qfluentwidgets import qconfig, FluentIcon, NavigationItemPosition, MessageBox, InfoBar, \
-    InfoBarPosition, MessageBoxBase, FluentWindow, NavigationDisplayMode, isDarkTheme, Theme
+    InfoBarPosition, MessageBoxBase, FluentWindow, NavigationDisplayMode, isDarkTheme, Theme, \
+    DotInfoBadge, InfoBadgePosition
 from qfluentwidgets.components.widgets.scroll_bar import ScrollBarHandleDisplayMode
 from qfluentwidgets.common.style_sheet import updateStyleSheet
 
@@ -47,6 +48,10 @@ NAVIGATION_EXPAND_MAX_WIDTH = 240
 NAVIGATION_EXPAND_FIT_PADDING = 23
 
 
+def update_check_delay_ms():
+    return 10_000 if "PYAPPIFY_PYTHON_TEST" in os.environ else 30_000
+
+
 class MainWindow(FluentWindow):
 
     def __init__(self, app, config, ok_config, icon, title, version, debug=False, about=None, exit_event=None,
@@ -210,6 +215,11 @@ class MainWindow(FluentWindow):
         self.about_tab = AboutTab(config)
         self.addSubInterface(self.about_tab, FluentIcon.QUESTION, self.tr('About'),
                              position=NavigationItemPosition.BOTTOM)
+        self.about_update_badge = None
+        self.update_check_timer = None
+        if self.about_tab.update_card is not None:
+            self.about_tab.update_card.update_available_changed.connect(self._set_about_update_available)
+            self.about_tab.update_card.check_started.connect(self._cancel_scheduled_update_check)
 
         dev = self.tr('Debug')
         profile = config.get('profile', "")
@@ -243,6 +253,31 @@ class MainWindow(FluentWindow):
 
         logger.info('main window __init__ done')
 
+    def _set_about_update_available(self, available):
+        if available and self.about_update_badge is None:
+            about_navigation_item = self.navigationInterface.widget(self.about_tab.objectName())
+            self.about_update_badge = DotInfoBadge.error(
+                self, target=about_navigation_item, position=InfoBadgePosition.NAVIGATION_ITEM
+            )
+        if self.about_update_badge is not None:
+            self.about_update_badge.setVisible(available)
+
+    def _schedule_update_check(self):
+        if self.about_tab.update_card is None:
+            return
+        if self.update_check_timer is None:
+            self.update_check_timer = QTimer(self)
+            self.update_check_timer.setSingleShot(True)
+            self.update_check_timer.timeout.connect(self.about_tab.check_for_updates)
+        update_delay = update_check_delay_ms()
+        logger.info(f'schedule pyappify update check in {update_delay}ms')
+        self.update_check_timer.start(update_delay)
+
+    def _cancel_scheduled_update_check(self):
+        if self.update_check_timer is not None and self.update_check_timer.isActive():
+            logger.info('cancel scheduled pyappify update check because a check has started')
+            self.update_check_timer.stop()
+
     @staticmethod
     def _get_dwm_accent_color():
         """Return the DWM accent color as a compatibility fallback."""
@@ -513,6 +548,7 @@ class MainWindow(FluentWindow):
         if first_show:
             QTimer.singleShot(0, self.bring_to_front)
             QTimer.singleShot(250, self.show_startup_version_change_notice)
+            self._schedule_update_check()
 
     def set_window_size(self, width, height, min_width, min_height):
         screen = QScreen.availableGeometry(self.screen())

{ok_script-2.0.0b4 → ok_script-2.0.0b5}/ok/ui/qt/about/AboutTab.py

@@ -1,32 +1,56 @@
 from PySide6.QtCore import Qt
 from PySide6.QtWidgets import QGridLayout, QWidget, QSizePolicy
-from qfluentwidgets import BodyLabel, SettingCardGroup
+from qfluentwidgets import BodyLabel
 
 from ok.ui.qt.about.ProjectCard import ProjectCard
 from ok.ui.qt.about.VersionCard import VersionCard
+from ok.ui.qt.about.UpdateCard import ChangeLogView, UpdateCard
 from ok.ui.qt.util.app import get_localized_app_config
 from ok.ui.qt.util.pyappify_startup import get_startup_version_change
 from ok.ui.qt.widget.Tab import Tab
 from ok.util.file import get_path_relative_to_exe
+from ok.util.logger import Logger
+
+
+logger = Logger.get_logger(__name__)
 
 
 class AboutTab(Tab):
-    def __init__(self, config):
+    def __init__(self, config, pyappify_module=None):
         super().__init__()
+        if pyappify_module is None:
+            import pyappify as pyappify_module
         self.version_card = VersionCard(config, get_path_relative_to_exe(config.get('gui_icon')),
                                         config.get('gui_title'), config.get('version'),
                                         config.get('debug'), self)
         # The About page uses the same section rhythm as the rest of the app.
         self.add_widget(self.version_card)
 
-        if version_change := get_startup_version_change():
-            update_note_label = BodyLabel()
-            update_note_label.setText(version_change.content)
-            update_note_label.setWordWrap(True)
-            update_note_label.setTextInteractionFlags(Qt.TextInteractionFlag.TextSelectableByMouse)
+        self.update_card = None
+        if callable(getattr(pyappify_module, 'get_version_list', None)):
+            self.update_card = UpdateCard(config.get('version'), pyappify_module, self)
+            self.add_card(self.tr("App update"), self.update_card)
+        else:
+            logger.warning(
+                "pyappify.get_version_list is unavailable; update controls are disabled. "
+                f"Loaded module: {getattr(pyappify_module, '__file__', type(pyappify_module).__name__)!r}"
+            )
+
+        if version_change := get_startup_version_change(pyappify_module):
+            update_note_label = ChangeLogView(version_change.content)
             update_note_label.setContentsMargins(0, 0, 0, 0)
             self.add_card(self._startup_version_change_title(version_change), update_note_label)
 
+        if about := config.get('about'):
+            about_label = BodyLabel()
+            about_label.setText(about)
+            about_label.setWordWrap(True)
+            about_label.setOpenExternalLinks(True)
+            about_label.setTextInteractionFlags(Qt.TextBrowserInteraction)
+            about_label.setContentsMargins(0, 0, 0, 0)
+
+            self.add_card(self.tr("Disclaimer"), about_label)
+
         projects = [
             {"name": self.tr("ok-py Automation Tool"), "url": "https://github.com/ok-oldking/ok-py"},
             {"name": self.tr("ok-script App Template"), "url": "https://github.com/ok-oldking/ok-script-app"},
@@ -49,10 +73,6 @@ class AboutTab(Tab):
         filtered_projects = [p for p in projects if normalize_url(p['url']) != current_github_norm]
 
         if filtered_projects:
-            self.group = SettingCardGroup(self.tr("Other Projects"), self)
-            
-            self.group.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Fixed)
-            
             grid_widget = QWidget()
             grid_widget.setSizePolicy(grid_widget.sizePolicy().horizontalPolicy(), QSizePolicy.Fixed)
             
@@ -66,22 +86,14 @@ class AboutTab(Tab):
                 card = ProjectCard(project['name'], project['url'], grid_widget)
                 grid_layout.addWidget(card, i // 2, i % 2)
 
-            self.group.addSettingCard(grid_widget)
-            self.group.setContentsMargins(0, 0, 0, 0)
-            self.add_widget(self.group)
-
-        if about := config.get('about'):
-            about_label = BodyLabel()
-            about_label.setText(about)
-            about_label.setWordWrap(True)
-            about_label.setOpenExternalLinks(True)
-            about_label.setTextInteractionFlags(Qt.TextBrowserInteraction)
-            about_label.setContentsMargins(0, 0, 0, 0)
-
-            self.add_card(None, about_label)
+            self.group = self.add_card(self.tr("Other Projects"), grid_widget)
 
         self.vBoxLayout.addStretch(1)
 
+    def check_for_updates(self):
+        if self.update_card is not None:
+            self.update_card.check_for_updates()
+
     def _startup_version_change_title(self, version_change):
         if version_change.action == "update":
             title = self.tr("Update success {from_version} -> {to_version}")

ok_script-2.0.0b5/ok/ui/qt/about/UpdateCard.py

@@ -0,0 +1,313 @@
+import os
+import threading
+
+from PySide6.QtCore import QEvent, Signal, Qt
+from PySide6.QtGui import QFontMetrics, QIcon, QPixmap
+from PySide6.QtWidgets import QHBoxLayout, QSizePolicy, QVBoxLayout, QWidget
+from qfluentwidgets import BodyLabel, CheckBox, ComboBox, FluentIcon, IndeterminateProgressRing, \
+    PrimaryPushButton, PushButton
+
+from ok.util.logger import Logger
+
+
+logger = Logger.get_logger(__name__)
+
+
+def _is_numeric_version(version):
+    try:
+        return bool(version) and all(part.isdigit() for part in version.lstrip("v").split("."))
+    except AttributeError:
+        return False
+
+
+class ChangeLogView(BodyLabel):
+    """A non-interactive, word-wrapped changelog that follows its text height."""
+
+    def __init__(self, text="", parent=None):
+        super().__init__(parent)
+        self.setText(text)
+        self.setWordWrap(True)
+        self.setTextFormat(Qt.TextFormat.PlainText)
+        self.setTextInteractionFlags(Qt.TextInteractionFlag.NoTextInteraction)
+        self.setAlignment(Qt.AlignmentFlag.AlignLeft | Qt.AlignmentFlag.AlignTop)
+        size_policy = QSizePolicy(QSizePolicy.Policy.Expanding, QSizePolicy.Policy.Minimum)
+        size_policy.setHeightForWidth(True)
+        self.setSizePolicy(size_policy)
+
+    def setPlainText(self, text):
+        self.setText(text)
+
+    def toPlainText(self):
+        return self.text()
+
+
+class UpdateCard(QWidget):
+    """Version picker and release-note viewer backed by the PyAppify launcher API."""
+
+    update_available_changed = Signal(bool)
+    check_started = Signal()
+    _versions_loaded = Signal(object)
+    _update_finished = Signal(object)
+    VERSION_COMBO_MIN_WIDTH = 100
+    VERSION_COMBO_MAX_WIDTH = 240
+
+    def __init__(self, current_version, pyappify_module, parent=None):
+        super().__init__(parent)
+        self.current_version = current_version or getattr(pyappify_module, "app_version", None) or ""
+        if "PYAPPIFY_PYTHON_TEST" in os.environ and not _is_numeric_version(self.current_version):
+            logger.info(f"using v0.0.0 for nonnumeric test version {self.current_version!r}")
+            self.current_version = "v0.0.0"
+        self.pyappify_module = pyappify_module
+        self.versions = []
+        self._busy = False
+        logger.info(
+            f"initialized current_version={self.current_version!r}, "
+            f"pyappify_module={getattr(pyappify_module, '__file__', type(pyappify_module).__name__)!r}, "
+            f"pyappify_app_version={getattr(pyappify_module, 'app_version', None)!r}, "
+            f"test_mode={'PYAPPIFY_PYTHON_TEST' in os.environ}"
+        )
+
+        self.version_combo = ComboBox(self)
+        self.version_combo.setFixedWidth(self.VERSION_COMBO_MIN_WIDTH)
+        self.version_combo.currentIndexChanged.connect(self._selection_changed)
+
+        self.test_version_checkbox = CheckBox(self.tr("Check Test Version"), self)
+        self.test_version_checkbox.setChecked(False)
+        self.check_button = PushButton(FluentIcon.SYNC, self.tr("Check for updates"), self)
+        loading_icon_pixmap = QPixmap(16, 16)
+        loading_icon_pixmap.fill(Qt.GlobalColor.transparent)
+        self._loading_placeholder_icon = QIcon(loading_icon_pixmap)
+        self.check_progress = IndeterminateProgressRing(self.check_button, start=False)
+        self.check_progress.setFixedSize(16, 16)
+        self.check_progress.setStrokeWidth(2)
+        self.check_progress.hide()
+        self.check_button.setMinimumWidth(self.check_button.sizeHint().width())
+        self.check_button.installEventFilter(self)
+        self.check_button.clicked.connect(self.check_for_updates)
+        self.update_button = PrimaryPushButton(FluentIcon.UPDATE, self.tr("Update"), self)
+        self.update_button.clicked.connect(self.update_to_selected_version)
+        self.update_button.setEnabled(False)
+
+        self.controls_layout = QHBoxLayout()
+        self.controls_layout.setContentsMargins(0, 0, 0, 0)
+        self.version_label = BodyLabel(self.tr("Version"), self)
+        self.status_label = BodyLabel(self.tr("Click to check for updates"), self)
+        self.controls_layout.addWidget(self.version_label)
+        self.controls_layout.addWidget(self.version_combo)
+        self.controls_layout.addWidget(self.status_label)
+        self.controls_layout.addStretch(1)
+        self.controls_layout.addWidget(self.test_version_checkbox)
+        self.controls_layout.addWidget(self.check_button)
+        self.controls_layout.addWidget(self.update_button)
+        self._set_version_controls_visible(False)
+
+        self.notes_edit = ChangeLogView("", self)
+        self.notes_edit.hide()
+
+        layout = QVBoxLayout(self)
+        layout.setContentsMargins(0, 0, 0, 0)
+        layout.setSpacing(12)
+        layout.addLayout(self.controls_layout)
+        layout.addWidget(self.notes_edit)
+
+        self._versions_loaded.connect(self._apply_versions)
+        self._update_finished.connect(self._apply_update_result)
+
+    def check_for_updates(self):
+        if self._busy:
+            return
+        get_versions = getattr(self.pyappify_module, "get_version_list", None)
+        if not callable(get_versions):
+            self._show_error(self.tr("Update checking is not supported by this PyAppify version."))
+            return
+        self._set_busy(True, checking=True)
+        self.check_started.emit()
+        self._set_status(self.tr("Checking for updates…"))
+        release_only = not self.test_version_checkbox.isChecked()
+        self._run_in_background(
+            lambda: get_versions(release_only=release_only),
+            self._versions_loaded,
+            f"pyappify.get_version_list(release_only={release_only})",
+        )
+
+    def update_to_selected_version(self):
+        if self._busy or self.version_combo.currentIndex() < 0:
+            return
+        update_to_version = getattr(self.pyappify_module, "update_to_version", None)
+        if not callable(update_to_version):
+            self._show_error(self.tr("Updating is not supported by this PyAppify version."))
+            return
+        version = self.version_combo.currentText()
+        self._set_busy(True)
+        self._set_status(self.tr("Starting change to {version}…").format(version=version))
+        self._run_in_background(
+            lambda: update_to_version(version),
+            self._update_finished,
+            f"pyappify.update_to_version({version!r})",
+        )
+
+    def _run_in_background(self, operation, signal, operation_name):
+        def run():
+            logger.info(f"calling {operation_name}")
+            try:
+                result = operation()
+                logger.info(f"{operation_name} result={result!r}")
+                signal.emit((True, result))
+            except Exception as error:
+                logger.error(f"{operation_name} failed: {error}", error)
+                signal.emit((False, str(error)))
+
+        threading.Thread(target=run, daemon=True, name="pyappify-update").start()
+
+    def _apply_versions(self, result):
+        self._set_busy(False, refresh_selection=False)
+        successful, value = result
+        if not successful:
+            self.versions = []
+            self.version_combo.clear()
+            self._set_version_controls_visible(False)
+            self.update_available_changed.emit(False)
+            self._show_error(self.tr("Failed to check for updates: {error}").format(error=value))
+            return
+
+        self.versions = [item for item in value if isinstance(item, dict) and item.get("version")]
+        self.version_combo.blockSignals(True)
+        self.version_combo.clear()
+        self.version_combo.addItems([str(item["version"]) for item in self.versions])
+        self.version_combo.blockSignals(False)
+        self._resize_version_combo()
+        logger.info(
+            f"loaded {len(self.versions)} valid versions into selector: "
+            f"{[item['version'] for item in self.versions]!r}"
+        )
+
+        newest_update = next(
+            (index for index, item in enumerate(self.versions)
+             if self._compare_versions(str(item["version"]), self.current_version) > 0),
+            None,
+        )
+        self.update_available_changed.emit(newest_update is not None)
+        logger.info(
+            f"update_available={newest_update is not None}, current_version={self.current_version!r}, "
+            f"newest_update_index={newest_update!r}"
+        )
+        if not self.versions:
+            self._set_version_controls_visible(False)
+            self._set_notes("")
+            self._set_status(self.tr("No versions are available."))
+            self.update_button.setEnabled(False)
+            return
+        self._set_version_controls_visible(True)
+        self._set_status("" if newest_update is not None else self.tr("No updates available."))
+        self.version_combo.setCurrentIndex(0)
+        self._selection_changed()
+
+    def _selection_changed(self, _index=None):
+        index = self.version_combo.currentIndex()
+        if index < 0 or index >= len(self.versions):
+            self.update_button.setEnabled(False)
+            return
+        selected = self.versions[index]
+        target = str(selected["version"])
+        direction = self._compare_versions(target, self.current_version)
+        logger.debug(
+            f"selected version={target!r}, current_version={self.current_version!r}, direction={direction}"
+        )
+        self.update_button.setEnabled(direction != 0 and not self._busy)
+        self.update_button.setText(self.tr("Update") if direction > 0 else self.tr("Downgrade"))
+
+        if direction == 0:
+            self.update_button.setText(self.tr("Current version"))
+
+        calculate_notes = getattr(self.pyappify_module, "calculate_update_notes", None)
+        if not callable(calculate_notes):
+            self._set_notes("")
+            self._set_status(self.tr("Update-note calculation is not supported."), error=True)
+            return
+        try:
+            notes = calculate_notes(self.versions, self.current_version, target)
+            self._set_notes(
+                "\n".join(f"• {note}" for note in notes) or self.tr("No release notes.")
+            )
+        except Exception as error:
+            logger.error(f"pyappify.calculate_update_notes failed: {error}", error)
+            self._set_notes("")
+            self._set_status(self.tr("Failed to calculate update notes: {error}").format(error=error), error=True)
+
+    def _resize_version_combo(self):
+        font_metrics = QFontMetrics(self.version_combo.font())
+        text_width = max(
+            (font_metrics.horizontalAdvance(str(item["version"])) for item in self.versions),
+            default=0,
+        )
+        content_width = text_width + 48
+        width = max(self.VERSION_COMBO_MIN_WIDTH, min(self.VERSION_COMBO_MAX_WIDTH, content_width))
+        self.version_combo.setFixedWidth(width)
+
+    def _set_version_controls_visible(self, visible):
+        self.version_label.setVisible(visible)
+        self.version_combo.setVisible(visible)
+
+    def _set_notes(self, text):
+        self.notes_edit.setPlainText(text)
+        self.notes_edit.setVisible(bool(text))
+
+    def _set_check_loading(self, loading):
+        if loading:
+            self.check_button.setIcon(self._loading_placeholder_icon)
+            self.check_progress.show()
+            self.check_progress.start()
+        else:
+            self.check_progress.stop()
+            self.check_progress.hide()
+            self.check_button.setIcon(FluentIcon.SYNC)
+        self._position_check_progress()
+
+    def _position_check_progress(self):
+        minimum_width = self.check_button.minimumSizeHint().width()
+        x = 12 + max(0, (self.check_button.width() - minimum_width) // 2)
+        self.check_progress.move(x, (self.check_button.height() - self.check_progress.height()) // 2)
+
+    def eventFilter(self, watched, event):
+        if watched is self.check_button and event.type() == QEvent.Type.Resize:
+            self._position_check_progress()
+        return super().eventFilter(watched, event)
+
+    def _apply_update_result(self, result):
+        self._set_busy(False)
+        successful, value = result
+        if successful:
+            self._set_status(self.tr("Update request accepted. The app will restart to apply it."))
+        else:
+            self._show_error(self.tr("Failed to change version: {error}").format(error=value))
+
+    def _set_busy(self, busy, checking=False, refresh_selection=True):
+        self._busy = busy
+        self.check_button.setEnabled(not busy)
+        self._set_check_loading(busy and checking)
+        self.test_version_checkbox.setEnabled(not busy)
+        self.version_combo.setEnabled(not busy)
+        if busy:
+            self.update_button.setEnabled(False)
+        elif refresh_selection:
+            self._selection_changed()
+
+    def _show_error(self, message):
+        self._set_busy(False, refresh_selection=False)
+        self._set_notes("")
+        self._set_status(message, error=True)
+
+    def _set_status(self, message, error=False):
+        self.status_label.setText(message)
+        self.status_label.setStyleSheet("color: #d13438;" if error else "")
+
+    def _compare_versions(self, left, right):
+        if left == right:
+            return 0
+        is_greater = getattr(self.pyappify_module, "is_greater_version", None)
+        if callable(is_greater):
+            if is_greater(left, right):
+                return 1
+            if is_greater(right, left):
+                return -1
+        return 0

ok_script-2.0.0b5/ok/ui/qt/about/VersionCard.py

@@ -0,0 +1,16 @@
+from qfluentwidgets import SettingCard
+
+from ok.ui.qt.about.LinksBar import LinksBar
+
+
+class VersionCard(SettingCard):
+    """ Sample card """
+
+    def __init__(self, config, icon, title, version, debug, parent=None):
+        super().__init__(icon, title, f'{version} {self.get_type(debug)}')
+        links_bar = LinksBar(config)
+        self.iconLabel.setFixedSize(36, 36)
+        self.hBoxLayout.addWidget(links_bar)
+
+    def get_type(self, debug=None):
+        return self.tr('Debug') if debug else self.tr('Release')

{ok_script-2.0.0b4 → ok_script-2.0.0b5}/ok/ui/qt/common/design_system.py

@@ -11,7 +11,7 @@ from PySide6.QtWidgets import QLayout, QWidget
 class DesignToken:
     """The app's 8-point-grid-derived layout and sizing tokens."""
 
-    PAGE_MARGIN = 24
+    PAGE_MARGIN = 16
     PAGE_SPACING = 12
 
     SECTION_SPACING = 12