ankigammon 1.0.6__py3-none-any.whl

ankigammon/gui/resources/down-arrow.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="12" height="8" viewBox="0 0 12 8">
+  <polygon points="6,8 0,0 12,0" fill="#cdd6f4" stroke="none"/>
+</svg>

ankigammon/gui/resources/style.qss

@@ -0,0 +1,402 @@
+/* Modern Dark Theme for AnkiGammon GUI - Inspired by Catppuccin Mocha */
+
+/* Main Window and Dialogs */
+QMainWindow, QDialog, QWidget {
+    background-color: #1e1e2e;
+    color: #cdd6f4;
+}
+
+/* Primary Buttons */
+QPushButton {
+    background-color: #89b4fa;
+    color: #1e1e2e;
+    border: none;
+    padding: 10px 18px;
+    border-radius: 6px;
+    font-weight: 600;
+    font-size: 13px;
+    min-height: 28px;
+}
+
+QPushButton:hover {
+    background-color: #a0c8fc;
+}
+
+QPushButton:pressed {
+    background-color: #74c7ec;
+}
+
+QPushButton:disabled {
+    background-color: #313244;
+    color: #6c7086;
+}
+
+/* Settings and Secondary Buttons */
+QPushButton#btn_settings {
+    background-color: transparent;
+    color: #cdd6f4;
+    border: 2px solid #45475a;
+}
+
+QPushButton#btn_settings:hover {
+    background-color: rgba(137, 180, 250, 0.12);
+    color: #f5e0dc;
+    border-color: #89b4fa;
+}
+
+QPushButton#btn_settings:pressed {
+    background-color: rgba(137, 180, 250, 0.18);
+    color: #f5e0dc;
+    border-color: #89b4fa;
+}
+
+/* Position List Widget */
+QListWidget {
+    background-color: #181825;
+    border: 2px solid #313244;
+    border-radius: 8px;
+    padding: 6px;
+    outline: none;
+}
+
+QListWidget::item {
+    padding: 12px 10px;
+    border-radius: 6px;
+    margin: 2px 0px;
+    color: #cdd6f4;
+}
+
+QListWidget::item:selected {
+    background-color: #89b4fa;
+    color: #1e1e2e;
+    font-weight: 600;
+}
+
+QListWidget::item:hover {
+    background-color: #313244;
+}
+
+QListWidget::item:selected:hover {
+    background-color: #a0c8fc;
+}
+
+/* Group Boxes */
+QGroupBox {
+    border: 2px solid #45475a;
+    border-radius: 8px;
+    margin-top: 16px;
+    font-weight: 700;
+    padding-top: 16px;
+    color: #f5e0dc;
+    font-size: 13px;
+}
+
+QGroupBox::title {
+    subcontrol-origin: margin;
+    subcontrol-position: top left;
+    padding: 4px 12px;
+    background-color: #1e1e2e;
+    border-radius: 4px;
+}
+
+/* Labels */
+QLabel {
+    color: #cdd6f4;
+    font-size: 13px;
+}
+
+QLabel#title {
+    color: #f5e0dc;
+    font-size: 16px;
+}
+
+/* Input Fields */
+QLineEdit, QComboBox {
+    padding: 8px 12px;
+    border: 2px solid #45475a;
+    border-radius: 6px;
+    background-color: #181825;
+    color: #cdd6f4;
+    selection-background-color: #89b4fa;
+    selection-color: #1e1e2e;
+    font-size: 13px;
+}
+
+QLineEdit:focus, QComboBox:focus {
+    border: 2px solid #89b4fa;
+    background-color: #1e1e2e;
+}
+
+QComboBox:hover {
+    border-color: #6c7086;
+}
+
+QComboBox:disabled {
+    background-color: #313244;
+    color: #6c7086;
+    border-color: #313244;
+}
+
+QComboBox::drop-down {
+    border: none;
+    padding-right: 8px;
+}
+
+QComboBox::down-arrow {
+    image: url(ankigammon/gui/resources/down-arrow.svg);
+    width: 12px;
+    height: 8px;
+}
+
+QComboBox:disabled::down-arrow {
+    opacity: 0.3;
+}
+
+QComboBox QAbstractItemView {
+    background-color: #181825;
+    border: 2px solid #45475a;
+    selection-background-color: #89b4fa;
+    selection-color: #1e1e2e;
+    color: #cdd6f4;
+    padding: 4px;
+}
+
+/* Checkboxes */
+QCheckBox {
+    spacing: 10px;
+    color: #cdd6f4;
+}
+
+QCheckBox::indicator {
+    width: 20px;
+    height: 20px;
+    border-radius: 4px;
+    border: 3px solid #45475a;
+    background-color: #181825;
+}
+
+QCheckBox::indicator:hover {
+    border-color: #89b4fa;
+}
+
+QCheckBox::indicator:checked {
+    background-color: #89b4fa;
+    border: 3px solid #45475a;
+}
+
+QCheckBox::indicator:checked:hover {
+    background-color: #a0c8fc;
+    border-color: #89b4fa;
+}
+
+/* Radio Buttons */
+QRadioButton {
+    spacing: 10px;
+    color: #cdd6f4;
+}
+
+QRadioButton::indicator {
+    width: 20px;
+    height: 20px;
+    border-radius: 10px;
+    border: 2px solid #45475a;
+    background-color: #181825;
+}
+
+QRadioButton::indicator:hover {
+    border-color: #89b4fa;
+}
+
+QRadioButton::indicator:checked {
+    background-color: #ffffff;
+    border: 5px solid #89b4fa;
+}
+
+/* Progress Bar */
+QProgressBar {
+    border: 2px solid #45475a;
+    border-radius: 6px;
+    text-align: center;
+    background-color: #181825;
+    color: #ffffff;
+    font-weight: 700;
+    height: 24px;
+}
+
+QProgressBar::chunk {
+    background-color: qlineargradient(x1:0, y1:0, x2:1, y2:0,
+                                      stop:0 #89b4fa, stop:1 #74c7ec);
+    border-radius: 4px;
+    margin: 2px;
+}
+
+/* Text Edit */
+QTextEdit {
+    background-color: #181825;
+    border: 2px solid #45475a;
+    border-radius: 6px;
+    padding: 10px;
+    color: #cdd6f4;
+    selection-background-color: #89b4fa;
+    selection-color: #1e1e2e;
+    font-family: 'Consolas', 'Monaco', monospace;
+    font-size: 12px;
+}
+
+/* Status Bar */
+QStatusBar {
+    background-color: #181825;
+    color: #a6adc8;
+    border-top: 1px solid #313244;
+}
+
+QStatusBar::item {
+    border: none;
+}
+
+/* Menu Bar */
+QMenuBar {
+    background-color: #181825;
+    color: #cdd6f4;
+    border-bottom: 2px solid #313244;
+    padding: 4px;
+}
+
+QMenuBar::item {
+    padding: 6px 14px;
+    border-radius: 4px;
+    background-color: transparent;
+}
+
+QMenuBar::item:selected {
+    background-color: #313244;
+    color: #f5e0dc;
+}
+
+QMenuBar::item:pressed {
+    background-color: #45475a;
+}
+
+/* Menus */
+QMenu {
+    background-color: #181825;
+    border: 2px solid #313244;
+    border-radius: 8px;
+    padding: 6px;
+}
+
+QMenu::item {
+    padding: 8px 32px 8px 16px;
+    border-radius: 4px;
+    color: #cdd6f4;
+}
+
+QMenu::item:selected {
+    background-color: #89b4fa;
+    color: #1e1e2e;
+}
+
+QMenu::separator {
+    height: 2px;
+    background-color: #313244;
+    margin: 6px 10px;
+}
+
+QMenu::icon {
+    padding-left: 10px;
+}
+
+/* Dialog Button Box */
+QDialogButtonBox QPushButton {
+    min-width: 90px;
+    padding: 8px 16px;
+}
+
+/* Scrollbars */
+QScrollBar:vertical {
+    border: none;
+    background-color: #181825;
+    width: 12px;
+    border-radius: 6px;
+}
+
+QScrollBar::handle:vertical {
+    background-color: #45475a;
+    border-radius: 6px;
+    min-height: 30px;
+}
+
+QScrollBar::handle:vertical:hover {
+    background-color: #585b70;
+}
+
+QScrollBar::add-line:vertical, QScrollBar::sub-line:vertical {
+    height: 0px;
+}
+
+QScrollBar:horizontal {
+    border: none;
+    background-color: #181825;
+    height: 12px;
+    border-radius: 6px;
+}
+
+QScrollBar::handle:horizontal {
+    background-color: #45475a;
+    border-radius: 6px;
+    min-width: 30px;
+}
+
+QScrollBar::handle:horizontal:hover {
+    background-color: #585b70;
+}
+
+QScrollBar::add-line:horizontal, QScrollBar::sub-line:horizontal {
+    width: 0px;
+}
+
+/* Tooltips */
+QToolTip {
+    background-color: #313244;
+    color: #cdd6f4;
+    border: 2px solid #45475a;
+    border-radius: 6px;
+    padding: 8px;
+    font-size: 12px;
+}
+
+/* Message Boxes */
+QMessageBox {
+    background-color: #1e1e2e;
+}
+
+QMessageBox QLabel {
+    color: #cdd6f4;
+}
+
+/* Tab Widgets (for future use) */
+QTabWidget::pane {
+    border: 2px solid #313244;
+    border-radius: 8px;
+    background-color: #181825;
+}
+
+QTabBar::tab {
+    background-color: #313244;
+    color: #a6adc8;
+    padding: 10px 20px;
+    border-top-left-radius: 6px;
+    border-top-right-radius: 6px;
+    margin-right: 2px;
+}
+
+QTabBar::tab:selected {
+    background-color: #89b4fa;
+    color: #1e1e2e;
+    font-weight: 600;
+}
+
+QTabBar::tab:hover {
+    background-color: #45475a;
+    color: #cdd6f4;
+}

ankigammon/gui/resources.py

@@ -0,0 +1,26 @@
+"""
+Resource path utilities for GUI.
+"""
+import sys
+from pathlib import Path
+
+
+def get_resource_path(relative_path: str) -> Path:
+    """
+    Get absolute path to resource, works for dev and PyInstaller.
+
+    Args:
+        relative_path: Relative path to resource (e.g., "gui/resources/icon.png")
+
+    Returns:
+        Path: Absolute path to resource
+    """
+    try:
+        # PyInstaller creates a temp folder and stores path in _MEIPASS
+        base_path = Path(sys._MEIPASS)
+    except AttributeError:
+        # Running in normal Python environment
+        # __file__ is in ankigammon/gui/resources.py, so parent.parent gets us to repo root
+        base_path = Path(__file__).parent.parent.parent
+
+    return base_path / relative_path

ankigammon/gui/update_checker.py

@@ -0,0 +1,259 @@
+"""Version update checker using GitHub Releases API."""
+
+import json
+import logging
+import sys
+from datetime import datetime, timedelta
+from pathlib import Path
+from typing import Optional, Dict
+from urllib.parse import urlparse
+
+from PySide6.QtCore import QThread, Signal
+
+logger = logging.getLogger(__name__)
+
+# GitHub repository info
+REPO_OWNER = "Deinonychus999"
+REPO_NAME = "AnkiGammon"
+GITHUB_API_URL = f"https://api.github.com/repos/{REPO_OWNER}/{REPO_NAME}/releases/latest"
+GITHUB_RELEASES_URL = f"https://github.com/{REPO_OWNER}/{REPO_NAME}/releases"
+
+
+class VersionChecker:
+    """Check for updates via GitHub Releases API."""
+
+    def __init__(self, timeout: int = 5):
+        """Initialize version checker.
+
+        Args:
+            timeout: Request timeout in seconds
+        """
+        self.timeout = timeout
+
+    def check_latest_version(self) -> Optional[Dict]:
+        """Fetch latest release from GitHub API.
+
+        Returns:
+            Dict with release info or None if failed:
+            {
+                'version': '1.0.6',
+                'name': 'Version 1.0.6',
+                'release_notes': '...',
+                'download_url': 'https://...',
+                'published_at': '2024-01-15T10:30:00Z'
+            }
+        """
+        try:
+            import requests
+        except ImportError:
+            logger.warning("requests library not available, cannot check for updates")
+            return None
+
+        try:
+            response = requests.get(
+                GITHUB_API_URL,
+                timeout=(self.timeout, self.timeout),
+                headers={'Accept': 'application/vnd.github+json'}
+            )
+            response.raise_for_status()
+
+            data = response.json()
+
+            # Skip pre-releases and drafts
+            if data.get('prerelease') or data.get('draft'):
+                logger.info("Skipping pre-release or draft")
+                return None
+
+            tag = data.get('tag_name', '').lstrip('v')
+
+            return {
+                'version': tag,
+                'name': data.get('name', tag),
+                'release_notes': data.get('body', ''),
+                'download_url': self._extract_download_url(data),
+                'published_at': data.get('published_at', ''),
+                'html_url': data.get('html_url', GITHUB_RELEASES_URL)
+            }
+        except Exception as e:
+            logger.warning(f"Failed to check for updates: {e}")
+            return None
+
+    def _extract_download_url(self, release_data: Dict) -> str:
+        """Extract appropriate download URL from release data.
+
+        Uses GitHub's /releases/latest/download/ URL pattern for direct downloads.
+        """
+        # Determine platform-specific filename
+        if sys.platform == 'win32':
+            # Windows: ankigammon-windows.zip
+            filename = 'ankigammon-windows.zip'
+        elif sys.platform == 'darwin':
+            # macOS: AnkiGammon-macOS.dmg
+            filename = 'AnkiGammon-macOS.dmg'
+        else:
+            # Linux: AnkiGammon-x86_64.AppImage
+            filename = 'AnkiGammon-x86_64.AppImage'
+
+        # Construct direct download URL using GitHub's /releases/latest/download/ pattern
+        download_url = f"https://github.com/{REPO_OWNER}/{REPO_NAME}/releases/latest/download/{filename}"
+
+        return download_url
+
+    def compare_versions(self, current: str, latest: str) -> bool:
+        """Check if latest version is newer than current.
+
+        Args:
+            current: Current version string (e.g., "1.0.6")
+            latest: Latest version string
+
+        Returns:
+            True if update is available
+        """
+        try:
+            from packaging.version import Version
+            return Version(latest) > Version(current)
+        except Exception as e:
+            logger.warning(f"Failed to compare versions: {e}")
+            return False
+
+
+class VersionCheckCache:
+    """Manages version check caching to avoid excessive API calls."""
+
+    def __init__(self, cache_dir: Optional[Path] = None):
+        """Initialize cache manager.
+
+        Args:
+            cache_dir: Directory for cache file (defaults to ~/.ankigammon)
+        """
+        if cache_dir is None:
+            cache_dir = Path.home() / '.ankigammon'
+        self.cache_file = cache_dir / 'version_check.json'
+        self.cache_dir = cache_dir
+        self.cache_dir.mkdir(parents=True, exist_ok=True)
+
+    def should_check(self, min_hours_between_checks: int = 24) -> bool:
+        """Check if enough time has passed since last check.
+
+        Args:
+            min_hours_between_checks: Minimum hours between checks
+
+        Returns:
+            True if should check now
+        """
+        if not self.cache_file.exists():
+            return True
+
+        try:
+            with open(self.cache_file, 'r') as f:
+                cache = json.load(f)
+
+            last_check = datetime.fromisoformat(cache.get('last_check', ''))
+            time_since_check = datetime.now() - last_check
+
+            return time_since_check > timedelta(hours=min_hours_between_checks)
+        except (json.JSONDecodeError, ValueError, KeyError, OSError):
+            return True  # If cache is corrupted, check anyway
+
+    def get_cached_update(self) -> Optional[Dict]:
+        """Get previously cached update info.
+
+        Returns:
+            Cached release info or None
+        """
+        if not self.cache_file.exists():
+            return None
+
+        try:
+            with open(self.cache_file, 'r') as f:
+                cache = json.load(f)
+            return cache.get('latest_release')
+        except (json.JSONDecodeError, KeyError, OSError):
+            return None
+
+    def save_check(self, release_info: Optional[Dict]):
+        """Save the result of a version check.
+
+        Args:
+            release_info: Release info dict or None
+        """
+        cache = {
+            'last_check': datetime.now().isoformat(),
+            'latest_release': release_info
+        }
+
+        try:
+            with open(self.cache_file, 'w') as f:
+                json.dump(cache, f, indent=2)
+        except OSError as e:
+            logger.warning(f"Failed to save version check cache: {e}")
+
+
+class VersionCheckerThread(QThread):
+    """Background thread for non-blocking version checking."""
+
+    # Signals
+    update_available = Signal(dict)  # Emitted when update found
+    check_complete = Signal()  # Emitted when check done
+    check_failed = Signal()  # Emitted when check failed (network error)
+
+    def __init__(self, current_version: str, force_check: bool = False):
+        """Initialize checker thread.
+
+        Args:
+            current_version: Current app version
+            force_check: If True, bypass cache and check immediately
+        """
+        super().__init__()
+        self.current_version = current_version
+        self.force_check = force_check
+        self.checker = VersionChecker()
+        self.cache = VersionCheckCache()
+
+    def run(self):
+        """Execute version check in background thread."""
+        try:
+            # Check if we should skip (unless forced)
+            if not self.force_check and not self.cache.should_check(min_hours_between_checks=24):
+                logger.info("Skipping version check (too recent)")
+                cached = self.cache.get_cached_update()
+                if cached:
+                    self._check_and_emit(cached)
+                self.check_complete.emit()
+                return
+
+            # Fetch from GitHub
+            logger.info("Checking for updates...")
+            latest = self.checker.check_latest_version()
+
+            if latest:
+                # Cache the result
+                self.cache.save_check(latest)
+                self._check_and_emit(latest)
+            else:
+                # Network failure - try cached value
+                logger.info("Network check failed, using cache")
+                cached = self.cache.get_cached_update()
+                if cached:
+                    self._check_and_emit(cached)
+                elif self.force_check:
+                    # Manual check with no network and no cache = fail
+                    self._check_failed = True
+                    self.check_failed.emit()
+
+            self.check_complete.emit()
+        except Exception as e:
+            logger.error(f"Version check thread error: {e}")
+            self.check_complete.emit()
+
+    def _check_and_emit(self, release_info: Dict):
+        """Check if update is available and emit signal.
+
+        Args:
+            release_info: Release information dict
+        """
+        if self.checker.compare_versions(self.current_version, release_info['version']):
+            logger.info(f"Update available: {release_info['version']}")
+            self.update_available.emit(release_info)
+        else:
+            logger.info(f"Already up to date ({self.current_version})")

ankigammon/gui/widgets/__init__.py

@@ -0,0 +1,8 @@
+"""
+GUI widgets package.
+"""
+
+__all__ = ['PositionListWidget', 'SmartInputWidget']
+
+from .position_list import PositionListWidget
+from .smart_input import SmartInputWidget