adbsshdeck 0.1.1__py3-none-any.whl

devicedeck/session.py

@@ -0,0 +1,52 @@
+"""Unified connection profile (WinSCP-style protocol + Moba-style session types)."""
+
+from dataclasses import dataclass
+from enum import Enum
+from typing import Optional, Tuple
+
+
+class ConnectionKind(str, Enum):
+    ANDROID_ADB = "adb"
+    SSH_SFTP = "ssh"  # SFTP files + ssh terminal
+    FTP = "ftp"
+    SERIAL = "serial"
+
+
+@dataclass
+class SessionProfile:
+    kind: ConnectionKind
+    adb_serial: str = ""
+    # SSH / SFTP
+    ssh_host: str = ""
+    ssh_user: str = ""
+    ssh_port: int = 22
+    ssh_password: str = ""
+    # FTP
+    ftp_host: str = ""
+    ftp_port: int = 21
+    ftp_user: str = ""
+    ftp_password: str = ""
+    # Serial
+    serial_port: str = ""
+    serial_baud: str = "115200"
+
+
+def parse_user_at_host(text: str) -> Tuple[str, str]:
+    """Split user@host into (user, host). If no @, returns ("", stripped host)."""
+    t = (text or "").strip()
+    if not t:
+        return "", ""
+    if "@" in t:
+        u, h = t.split("@", 1)
+        return u.strip(), h.strip()
+    return "", t
+
+
+def ssh_command_args(profile: SessionProfile) -> list:
+    """Build `ssh` argv for interactive terminal (OpenSSH client)."""
+    host = (profile.ssh_host or "").strip()
+    user = (profile.ssh_user or "").strip()
+    if not host:
+        return ["ssh"]
+    target = f"{user}@{host}" if user else host
+    return ["ssh", "-p", str(int(profile.ssh_port or 22)), target]

devicedeck/ui/__init__.py

@@ -0,0 +1 @@
+# UI package

devicedeck/ui/app_icon.py

@@ -0,0 +1,46 @@
+"""Application window icon — multi-resolution for crisp taskbar and title bars."""
+
+from PyQt5.QtCore import Qt
+from PyQt5.QtGui import QColor, QIcon, QPainter, QPixmap
+
+
+def _render_icon_pixmap(size: int) -> QPixmap:
+    """Rounded tile with a simple device glyph, scaled to ``size``."""
+    s = max(16, int(size))
+    pm = QPixmap(s, s)
+    pm.fill(Qt.transparent)
+    p = QPainter(pm)
+    p.setRenderHint(QPainter.Antialiasing, True)
+    p.setRenderHint(QPainter.SmoothPixmapTransform, True)
+    p.setPen(Qt.NoPen)
+
+    m = max(1, s // 10)
+    r = max(2, s // 5)
+    p.setBrush(QColor("#2563eb"))
+    p.drawRoundedRect(m, m, s - 2 * m, s - 2 * m, r, r)
+
+    inner_l = s // 4
+    inner_t = s // 5
+    inner_w = s - 2 * inner_l
+    inner_h = int(s * 0.55)
+    p.setBrush(QColor("#e2e8f0"))
+    p.drawRoundedRect(inner_l, inner_t, inner_w, inner_h, max(1, s // 32), max(1, s // 32))
+
+    p.setBrush(QColor("#2563eb"))
+    ex = s // 2 - s // 10
+    ey = inner_t + inner_h - s // 12
+    ew = max(2, s // 5)
+    eh = max(2, s // 12)
+    p.drawEllipse(ex, ey, ew, eh)
+
+    p.end()
+    return pm
+
+
+def create_app_icon() -> QIcon:
+    """Icons for taskbar, alt-tab, and window title — several sizes for HiDPI."""
+    icon = QIcon()
+    for size in (16, 20, 24, 32, 40, 48, 64, 96, 128, 256):
+        pm = _render_icon_pixmap(size)
+        icon.addPixmap(pm)
+    return icon

devicedeck/ui/combo_utils.py

@@ -0,0 +1,45 @@
+from PyQt5.QtCore import Qt
+from PyQt5.QtGui import QColor, QPainter, QPen
+from PyQt5.QtWidgets import QComboBox
+
+
+class ExpandAllComboBox(QComboBox):
+    """Combobox that expands to show all options in one popup using native look."""
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.setSizeAdjustPolicy(QComboBox.AdjustToContents)
+
+    def showPopup(self) -> None:
+        rows = max(1, self.count())
+        self.setMaxVisibleItems(rows)
+        view = self.view()
+        # Use font metrics for predictable performance when opening popup.
+        row_h = max(self.fontMetrics().height() + 10, 24)
+        frame = view.frameWidth() * 2
+        popup_h = rows * row_h + frame + 2
+        fm = self.fontMetrics()
+        max_w = self.width()
+        for i in range(self.count()):
+            text_w = fm.horizontalAdvance(self.itemText(i)) + 56
+            if text_w > max_w:
+                max_w = text_w
+        view.setMinimumWidth(max_w)
+        view.setMinimumHeight(popup_h)
+        view.setMaximumHeight(popup_h)
+        super().showPopup()
+
+    def paintEvent(self, event) -> None:
+        super().paintEvent(event)
+        # Draw a high-contrast chevron so dropdown arrow stays visible in all themes.
+        p = QPainter(self)
+        p.setRenderHint(QPainter.Antialiasing, True)
+        c = self.palette().color(self.foregroundRole())
+        if not self.isEnabled():
+            c = QColor(c.red(), c.green(), c.blue(), 130)
+        p.setPen(QPen(c, 1.8, Qt.SolidLine, Qt.RoundCap, Qt.RoundJoin))
+        x = self.rect().right() - 12
+        y = self.rect().center().y()
+        p.drawLine(x - 4, y - 2, x, y + 2)
+        p.drawLine(x, y + 2, x + 4, y - 2)
+        p.end()

devicedeck/ui/first_run_dialog.py

@@ -0,0 +1,107 @@
+"""Shown once on a fresh install before ~/.devicedeck.json exists."""
+
+from pathlib import Path
+
+from PyQt5.QtCore import Qt
+from PyQt5.QtWidgets import (
+    QApplication,
+    QDialog,
+    QDialogButtonBox,
+    QFileDialog,
+    QFormLayout,
+    QGroupBox,
+    QHBoxLayout,
+    QLabel,
+    QLineEdit,
+    QMessageBox,
+    QPushButton,
+    QRadioButton,
+    QVBoxLayout,
+)
+
+from ..config import AppConfig
+
+
+class FirstRunDialog(QDialog):
+    def __init__(self, config: AppConfig, parent=None):
+        super().__init__(parent)
+        self._config = config
+        self.setWindowTitle("Welcome — set up DeviceDeck")
+        self.setModal(True)
+        app = QApplication.instance()
+        if app is not None:
+            self.setWindowIcon(app.windowIcon())
+        self.resize(520, 420)
+        self._build_ui()
+
+    def _build_ui(self) -> None:
+        root = QVBoxLayout(self)
+        intro = QLabel(
+            "<p><b>First run on this computer.</b></p>"
+            "<p>Choose a theme and optional tool paths. You can change everything later under "
+            "<b>File → Preferences</b>.</p>"
+        )
+        intro.setWordWrap(True)
+        intro.setOpenExternalLinks(False)
+        root.addWidget(intro)
+
+        theme_box = QGroupBox("Theme")
+        tb = QVBoxLayout(theme_box)
+        self._radio_light = QRadioButton("Light")
+        self._radio_dark = QRadioButton("Dark")
+        self._radio_light.setChecked(not bool(getattr(self._config, "dark_theme", False)))
+        self._radio_dark.setChecked(bool(getattr(self._config, "dark_theme", False)))
+        tb.addWidget(self._radio_light)
+        tb.addWidget(self._radio_dark)
+        root.addWidget(theme_box)
+
+        paths = QGroupBox("Tools (optional — leave empty to use PATH)")
+        pf = QFormLayout(paths)
+        row_adb = QHBoxLayout()
+        self.adb_edit = QLineEdit(self._config.adb_path)
+        self.adb_edit.setPlaceholderText("adb")
+        btn_adb = QPushButton("Browse…")
+        btn_adb.clicked.connect(self._browse_adb)
+        row_adb.addWidget(self.adb_edit, 1)
+        row_adb.addWidget(btn_adb)
+        pf.addRow("ADB:", row_adb)
+
+        row_sc = QHBoxLayout()
+        self.scrcpy_edit = QLineEdit(self._config.scrcpy_path)
+        self.scrcpy_edit.setPlaceholderText("scrcpy")
+        btn_sc = QPushButton("Browse…")
+        btn_sc.clicked.connect(self._browse_scrcpy)
+        row_sc.addWidget(self.scrcpy_edit, 1)
+        row_sc.addWidget(btn_sc)
+        pf.addRow("scrcpy:", row_sc)
+        root.addWidget(paths)
+
+        root.addStretch(1)
+
+        buttons = QDialogButtonBox(QDialogButtonBox.Ok)
+        buttons.accepted.connect(self._save)
+        ok = buttons.button(QDialogButtonBox.Ok)
+        if ok is not None:
+            ok.setText("Continue")
+        root.addWidget(buttons)
+
+    def _browse_adb(self) -> None:
+        path, _ = QFileDialog.getOpenFileName(self, "Select adb", str(Path.home()))
+        if path:
+            self.adb_edit.setText(path)
+
+    def _browse_scrcpy(self) -> None:
+        path, _ = QFileDialog.getOpenFileName(self, "Select scrcpy", str(Path.home()))
+        if path:
+            self.scrcpy_edit.setText(path)
+
+    def _save(self) -> None:
+        self._config.dark_theme = self._radio_dark.isChecked()
+        self._config.adb_path = self.adb_edit.text().strip()
+        self._config.scrcpy_path = self.scrcpy_edit.text().strip()
+        try:
+            self._config.save()
+        except OSError as exc:
+            QMessageBox.warning(self, "Could not save", str(exc))
+            return
+        self.accept()

devicedeck/ui/icon_utils.py

@@ -0,0 +1,144 @@
+"""Icons for bookmarks and local shell buttons (clear, recognizable glyphs)."""
+
+from PyQt5.QtCore import QPoint, Qt
+from PyQt5.QtGui import QColor, QFont, QIcon, QPainter, QPixmap
+from PyQt5.QtWidgets import QStyle, QWidget
+
+
+def icon_windows_cmd_console() -> QIcon:
+    """Dark console tile with >_ — distinct from PowerShell."""
+    pm = QPixmap(22, 22)
+    pm.fill(Qt.transparent)
+    p = QPainter(pm)
+    p.setRenderHint(QPainter.Antialiasing, True)
+    p.setPen(Qt.NoPen)
+    p.setBrush(QColor("#1e293b"))
+    p.drawRoundedRect(2, 2, 18, 18, 4, 4)
+    p.setPen(QColor("#94a3b8"))
+    p.drawRoundedRect(2, 2, 18, 18, 4, 4)
+    p.setPen(QColor("#f1f5f9"))
+    p.setFont(QFont("Consolas", 8, QFont.Bold))
+    p.drawText(4, 15, ">_")
+    p.end()
+    return QIcon(pm)
+
+
+def icon_windows_powershell() -> QIcon:
+    """PowerShell blue tile with PS monogram."""
+    pm = QPixmap(22, 22)
+    pm.fill(Qt.transparent)
+    p = QPainter(pm)
+    p.setRenderHint(QPainter.Antialiasing, True)
+    p.setPen(Qt.NoPen)
+    p.setBrush(QColor("#012456"))
+    p.drawRoundedRect(2, 2, 18, 18, 4, 4)
+    p.setPen(QColor("#38bdf8"))
+    p.drawRoundedRect(2, 2, 18, 18, 4, 4)
+    p.setPen(QColor("#f8fafc"))
+    p.setFont(QFont("Segoe UI", 7, QFont.Bold))
+    p.drawText(5, 14, "PS")
+    p.end()
+    return QIcon(pm)
+
+
+def icon_media_play_green() -> QIcon:
+    pm = QPixmap(22, 22)
+    pm.fill(Qt.transparent)
+    p = QPainter(pm)
+    p.setRenderHint(QPainter.Antialiasing, True)
+    p.setPen(Qt.NoPen)
+    p.setBrush(QColor("#16a34a"))
+    p.drawRoundedRect(2, 2, 18, 18, 4, 4)
+    p.setBrush(QColor("#f8fafc"))
+    p.drawPolygon(QPoint(8, 6), QPoint(8, 16), QPoint(16, 11))
+    p.end()
+    return QIcon(pm)
+
+
+def icon_media_stop_red() -> QIcon:
+    pm = QPixmap(22, 22)
+    pm.fill(Qt.transparent)
+    p = QPainter(pm)
+    p.setRenderHint(QPainter.Antialiasing, True)
+    p.setPen(Qt.NoPen)
+    p.setBrush(QColor("#dc2626"))
+    p.drawRoundedRect(2, 2, 18, 18, 4, 4)
+    p.setBrush(QColor("#f8fafc"))
+    p.drawRect(7, 7, 8, 8)
+    p.end()
+    return QIcon(pm)
+
+
+def icon_nav_up() -> QIcon:
+    pm = QPixmap(22, 22)
+    pm.fill(Qt.transparent)
+    p = QPainter(pm)
+    p.setRenderHint(QPainter.Antialiasing, True)
+    p.setPen(Qt.NoPen)
+    p.setBrush(QColor("#1e293b"))
+    p.drawRoundedRect(2, 2, 18, 18, 4, 4)
+    p.setPen(QColor("#93c5fd"))
+    p.setBrush(QColor("#93c5fd"))
+    p.drawPolygon(QPoint(11, 6), QPoint(6, 12), QPoint(9, 12), QPoint(9, 16), QPoint(13, 16), QPoint(13, 12), QPoint(16, 12))
+    p.end()
+    return QIcon(pm)
+
+
+def icon_home_folder() -> QIcon:
+    pm = QPixmap(22, 22)
+    pm.fill(Qt.transparent)
+    p = QPainter(pm)
+    p.setRenderHint(QPainter.Antialiasing, True)
+    p.setPen(Qt.NoPen)
+    p.setBrush(QColor("#1e293b"))
+    p.drawRoundedRect(2, 2, 18, 18, 4, 4)
+    p.setBrush(QColor("#f8fafc"))
+    p.drawPolygon(QPoint(4, 11), QPoint(11, 5), QPoint(18, 11))
+    p.drawRoundedRect(6, 10, 10, 7, 1, 1)
+    p.setBrush(QColor("#1e293b"))
+    p.drawRoundedRect(10, 12, 2, 5, 1, 1)
+    p.end()
+    return QIcon(pm)
+
+
+def icon_root_drive() -> QIcon:
+    pm = QPixmap(22, 22)
+    pm.fill(Qt.transparent)
+    p = QPainter(pm)
+    p.setRenderHint(QPainter.Antialiasing, True)
+    p.setPen(Qt.NoPen)
+    p.setBrush(QColor("#334155"))
+    p.drawRoundedRect(3, 6, 16, 10, 3, 3)
+    p.setBrush(QColor("#22c55e"))
+    p.drawEllipse(15, 12, 3, 3)
+    p.end()
+    return QIcon(pm)
+
+
+def bookmark_icon_for_kind(kind: str, widget: QWidget) -> QIcon:
+    """Map bookmark kind to a platform-standard icon."""
+    st = widget.style()
+    k = (kind or "").lower()
+    if k == "ssh":
+        return st.standardIcon(QStyle.SP_DriveNetIcon)
+    if k == "adb":
+        return st.standardIcon(QStyle.SP_ComputerIcon)
+    if k == "local_cmd":
+        return icon_windows_cmd_console()
+    if k == "local_pwsh":
+        return icon_windows_powershell()
+    if k == "serial":
+        return st.standardIcon(QStyle.SP_MessageBoxInformation)
+    if k in ("sftp", "ftp"):
+        return st.standardIcon(QStyle.SP_FileDialogStart)
+    return st.standardIcon(QStyle.SP_FileIcon)
+
+
+def bookmark_icon_from_entry(bm: dict, widget: QWidget) -> QIcon:
+    """Optional per-bookmark override: bm['icon'] = 'ssh'|'adb'|..."""
+    if isinstance(bm, dict):
+        override = (bm.get("icon") or "").strip().lower()
+        if override:
+            return bookmark_icon_for_kind(override, widget)
+        return bookmark_icon_for_kind(str(bm.get("kind", "")), widget)
+    return bookmark_icon_for_kind("", widget)