siftcode 0.3.0__py3-none-any.whl

siftcode/gui/app.py

@@ -0,0 +1,252 @@
+"""
+Gtk.Application entry point for Siftcode.
+
+Creates the application, loads CSS, and opens the main window.
+All metadata comes from siftcode._version.
+"""
+
+from __future__ import annotations
+
+import logging
+import platform
+import sys
+from pathlib import Path
+
+import gi
+
+gi.require_version("Gtk", "4.0")
+gi.require_version("Adw", "1")
+
+from gi.repository import Adw, Gdk, Gio, Gtk  # noqa: E402
+
+from siftcode._version import (  # noqa: E402
+    APP_ID,
+    APP_NAME,
+    AUTHOR_NAME,
+    COPYRIGHT,
+    DESCRIPTION,
+    HOMEPAGE_URL,
+    ISSUES_URL,
+    __status__,
+    __version__,
+)
+from siftcode.gui.window import MainWindow  # noqa: E402
+
+
+logger = logging.getLogger(__name__)
+
+
+# ---------------------------------------------------------------------------
+# Paths
+# ---------------------------------------------------------------------------
+
+DATA_DIR = Path(__file__).parent.parent / "data"
+LOGO_PATH = DATA_DIR / "siftcode-logo.png"
+
+
+# ---------------------------------------------------------------------------
+# CSS
+# ---------------------------------------------------------------------------
+
+CSS = """
+.welcome-title {
+    font-size: 24pt;
+    font-weight: 300;
+    margin-bottom: 12px;
+}
+
+.welcome-subtitle {
+    font-size: 12pt;
+    color: alpha(currentColor, 0.6);
+}
+
+.welcome-icon {
+    color: alpha(currentColor, 0.4);
+    margin-bottom: 24px;
+}
+
+.stat-value {
+    font-size: 20pt;
+    font-weight: bold;
+}
+
+.stat-label {
+    font-size: 10pt;
+    color: alpha(currentColor, 0.6);
+}
+
+/* Log view colors */
+.log-info    { color: #5e5c64; }
+.log-success { color: #26a269; }
+.log-warning { color: #e5a50a; }
+.log-error   { color: #c01c28; }
+
+/* Logo in About dialog */
+.about-logo {
+    border-radius: 16px;
+}
+"""
+
+
+# ---------------------------------------------------------------------------
+# Application
+# ---------------------------------------------------------------------------
+
+class SiftcodeApplication(Adw.Application):
+    """The main Gtk.Application for Siftcode."""
+
+    def __init__(self) -> None:
+        super().__init__(
+            application_id=APP_ID,
+            flags=Gio.ApplicationFlags.DEFAULT_FLAGS,
+        )
+        self.window: MainWindow | None = None
+        self._about_dialog: Adw.AboutDialog | None = None
+
+    # ------------------------------------------------------------------
+    # Application lifecycle
+    # ------------------------------------------------------------------
+
+    def do_startup(self) -> None:
+        Adw.Application.do_startup(self)
+        logger.info(f"{APP_NAME} {__version__} ({__status__}) starting")
+
+        self._load_css()
+
+        # Actions
+        about_action = Gio.SimpleAction.new("about", None)
+        about_action.connect("activate", self._on_about)
+        self.add_action(about_action)
+
+        quit_action = Gio.SimpleAction.new("quit", None)
+        quit_action.connect("activate", lambda *_: self.quit())
+        self.add_action(quit_action)
+
+        # Keyboard shortcuts
+        self.set_accels_for_action("app.quit", ["<Ctrl>q"])
+        self.set_accels_for_action("app.about", ["F1"])
+
+    def do_activate(self) -> None:
+        win = self.props.active_window
+        if not win:
+            win = MainWindow(application=self)
+        win.present()
+
+    # ------------------------------------------------------------------
+    # CSS
+    # ------------------------------------------------------------------
+
+    def _load_css(self) -> None:
+        provider = Gtk.CssProvider()
+        provider.load_from_string(CSS)
+        Gtk.StyleContext.add_provider_for_display(
+            Gdk.Display.get_default(),
+            provider,
+            Gtk.STYLE_PROVIDER_PRIORITY_APPLICATION,
+        )
+
+    # ------------------------------------------------------------------
+    # Logo lookup
+    # ------------------------------------------------------------------
+
+    def _find_logo(self) -> Path | None:
+        """Find the Siftcode logo PNG (packaged or source tree)."""
+        try:
+            import siftcode.data as data_pkg
+            packaged = Path(data_pkg.__file__).parent / "siftcode-logo.png"
+            if packaged.exists():
+                return packaged
+        except ImportError:
+            pass
+
+        source = Path(__file__).parent.parent / "data" / "siftcode-logo.png"
+        if source.exists():
+            return source
+
+        legacy = Path(__file__).parent / "assets" / "siftcode-logo.png"
+        if legacy.exists():
+            return legacy
+
+        return None
+
+    def _register_logo_icon_theme(self) -> None:
+        """Register the logo's directory as an icon theme search path."""
+        logo_path = self._find_logo()
+        if logo_path is None:
+            return
+        try:
+            display = Gdk.Display.get_default()
+            theme = Gtk.IconTheme.get_for_display(display)
+            theme.add_search_path(str(logo_path.parent))
+            logger.debug(f"Added icon search path: {logo_path.parent}")
+        except Exception as e:
+            logger.warning(f"Could not register icon theme path: {e}")
+
+    # ------------------------------------------------------------------
+    # Actions
+    # ------------------------------------------------------------------
+
+    def _on_about(self, _action, _param) -> None:
+        # Avoid opening multiple About dialogs
+        if self._about_dialog is not None:
+            return
+
+        # Register the logo directory so "siftcode-logo" is available
+        self._register_logo_icon_theme()
+
+        about = Adw.AboutDialog(
+            application_name=APP_NAME,
+            application_icon="siftcode-logo",
+            version=__version__,
+            developer_name=AUTHOR_NAME,
+            license_type=Gtk.License.GPL_3_0,
+            comments=DESCRIPTION,
+            website=HOMEPAGE_URL,
+            issue_url=ISSUES_URL,
+            copyright=COPYRIGHT,
+        )
+
+        # "Built with" acknowledgement section
+        about.add_acknowledgement_section(
+            "Built with",
+            [
+                "GTK4 https://gtk.org",
+                "libadwaita https://gnome.pages.gitlab.gnome.org/libadwaita/",
+                "Ollama https://ollama.com",
+                "Python https://python.org",
+            ],
+        )
+
+        # Runtime info section
+        about.add_legal_section(
+            title="Runtime",
+            copyright=f"Python {platform.python_version()}",
+            license_type=Gtk.License.UNKNOWN,
+        )
+
+        self._about_dialog = about
+        about.connect("closed", self._on_about_closed)
+        about.present(self.props.active_window)
+
+    def _on_about_closed(self, _dialog) -> None:
+        """Called when the About dialog is closed."""
+        self._about_dialog = None
+
+
+# ---------------------------------------------------------------------------
+# Entry point for `siftcode-gui`
+# ---------------------------------------------------------------------------
+
+def main(argv: list[str] | None = None) -> int:
+    """Launch the GTK application."""
+    logging.basicConfig(
+        level=logging.INFO,
+        format="%(asctime)s - %(levelname)s - %(message)s",
+        datefmt="%H:%M:%S",
+    )
+    app = SiftcodeApplication()
+    return app.run(argv if argv is not None else sys.argv)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

siftcode/gui/guide_window.py

@@ -0,0 +1,88 @@
+"""
+GuideWindow — a standalone window that renders a Markdown guide
+using the MarkdownView widget.
+"""
+
+from __future__ import annotations
+
+import subprocess
+from pathlib import Path
+
+import gi
+
+gi.require_version("Gtk", "4.0")
+gi.require_version("Adw", "1")
+
+from gi.repository import Adw, Gtk  # noqa: E402
+
+from siftcode.gui.widgets.markdown_view import MarkdownView  # noqa: E402
+
+
+class GuideWindow(Adw.Window):
+    """A window that displays a Markdown file with a preview."""
+
+    def __init__(self, parent, title: str, guide_path: Path) -> None:
+        super().__init__()
+        self.set_transient_for(parent)
+        self.set_modal(False)
+        self.set_title(title)
+        self.set_default_size(900, 700)
+
+        self._guide_path = guide_path
+
+        toolbar = Adw.ToolbarView()
+        header = Adw.HeaderBar()
+
+        subtitle = guide_path.parent.name if guide_path.parent else ""
+        header.set_title_widget(
+            Adw.WindowTitle(title=title, subtitle=subtitle)
+        )
+
+        # "Open in external editor" button
+        open_btn = Gtk.Button.new_from_icon_name("document-open-symbolic")
+        open_btn.set_tooltip_text("Open in external editor")
+        open_btn.connect("clicked", self._on_open_external)
+        header.pack_end(open_btn)
+
+        toolbar.add_top_bar(header)
+
+        # Content
+        self._view = MarkdownView()
+        try:
+            self._view.load_file(guide_path)
+        except Exception as e:
+            error_label = Gtk.Label(label=f"Could not load guide:\n{e}")
+            error_label.set_margin_top(24)
+            error_label.set_margin_start(24)
+            error_label.set_margin_end(24)
+            toolbar.set_content(error_label)
+            self.set_content(toolbar)
+            return
+
+        toolbar.set_content(self._view)
+        self.set_content(toolbar)
+
+        # Close on Escape
+        key_controller = Gtk.EventControllerKey()
+        key_controller.connect("key-pressed", self._on_key_pressed)
+        self.add_controller(key_controller)
+
+    # ------------------------------------------------------------------
+
+    def _on_key_pressed(self, _ctrl, keyval, _keycode, _state) -> bool:
+        # Escape closes the window
+        if keyval == 0xFF1B:  # GDK_KEY_Escape
+            self.close()
+            return True
+        return False
+
+    def _on_open_external(self, _button) -> None:
+        """Open the guide in the system's default Markdown viewer."""
+        try:
+            subprocess.Popen(
+                ["xdg-open", str(self._guide_path)],
+                stdout=subprocess.DEVNULL,
+                stderr=subprocess.DEVNULL,
+            )
+        except Exception:
+            pass

siftcode/gui/project_list.py

@@ -0,0 +1,160 @@
+"""
+Project list view — shows all saved projects and lets the user add new ones.
+"""
+
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+import gi
+
+gi.require_version("Gtk", "4.0")
+gi.require_version("Adw", "1")
+
+from gi.repository import Adw, Gio, Gtk  # noqa: E402
+
+from siftcode.core.config import (
+    ProjectConfig,
+    delete_project,
+    list_projects,
+    save_project,
+)
+from siftcode.gui.widgets.project_row import ProjectRow  # noqa: E402
+
+
+logger = logging.getLogger(__name__)
+
+
+class ProjectListView(Adw.Bin):
+    """A scrollable list of saved projects, plus a button to add new ones."""
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._on_project_activated = None
+        self._on_project_deleted = None
+
+        # Root layout: an Adw.StatusPage when empty, or a ListBox when full
+        self._stack = Gtk.Stack()
+        self._stack.set_transition_type(Gtk.StackTransitionType.CROSSFADE)
+
+        # Empty state
+        self._empty_page = Adw.StatusPage(
+            title="No projects yet",
+            description="Click the + button in the header to add a project.",
+            icon_name="folder-open-symbolic",
+        )
+        self._stack.add_named(self._empty_page, "empty")
+
+        # List view
+        self._list_box = Gtk.ListBox()
+        self._list_box.set_selection_mode(Gtk.SelectionMode.SINGLE)
+        self._list_box.add_css_class("boxed-list")
+        self._list_box.set_margin_top(12)
+        self._list_box.set_margin_bottom(12)
+        self._list_box.set_margin_start(12)
+        self._list_box.set_margin_end(12)
+        self._list_box.connect("row-activated", self._on_row_activated)
+
+        scrolled = Gtk.ScrolledWindow()
+        scrolled.set_vexpand(True)
+        scrolled.set_child(self._list_box)
+        self._stack.add_named(scrolled, "list")
+
+        self.set_child(self._stack)
+
+        # Load projects on construction
+        self.refresh()
+
+    # ------------------------------------------------------------------
+    # Public API
+    # ------------------------------------------------------------------
+
+    def set_on_project_activated(self, callback) -> None:
+        """Set a callback invoked when a project row is activated.
+
+        The callback receives the ProjectConfig of the activated row.
+        """
+        self._on_project_activated = callback
+
+    def set_on_project_deleted(self, callback) -> None:
+        """Set a callback invoked after a project is deleted.
+
+        Receives the deleted ProjectConfig.
+        """
+        self._on_project_deleted = callback
+
+    def refresh(self) -> None:
+        """Reload the project list from disk."""
+        # Clear existing rows
+        while (row := self._list_box.get_row_at_index(0)) is not None:
+            self._list_box.remove(row)
+
+        projects = list_projects()
+
+        if not projects:
+            self._stack.set_visible_child_name("empty")
+            return
+
+        for config in projects:
+            row = ProjectRow(config)
+            self._list_box.append(row)
+
+        self._stack.set_visible_child_name("list")
+
+    def activate_row(self, row) -> None:
+        """Programmatically activate a row (same as double-click)."""
+        if self._on_project_activated:
+            config = getattr(row, "config", None)
+            if config:
+                self._on_project_activated(config)
+
+    def request_delete_row(self, row) -> None:
+        """Ask the user to confirm, then delete the row's project."""
+        config = getattr(row, "config", None)
+        if config is None:
+            return
+
+        dialog = Adw.MessageDialog.new(
+            self.get_root(),
+            "Delete project?",
+            f"Are you sure you want to delete '{config.name}'?\n\n"
+            f"This removes the saved configuration, not the project files.",
+        )
+        dialog.add_response("cancel", "Cancel")
+        dialog.add_response("delete", "Delete")
+        dialog.set_response_appearance(
+            "delete", Adw.ResponseAppearance.DESTRUCTIVE
+        )
+        dialog.set_default_response("cancel")
+        dialog.set_close_response("cancel")
+
+        dialog.connect("response", self._on_delete_response, config)
+        dialog.present()
+
+    # ------------------------------------------------------------------
+    # Signals
+    # ------------------------------------------------------------------
+
+    def _on_row_activated(self, _list_box, row) -> None:
+        config = getattr(row, "config", None)
+        if config and self._on_project_activated:
+            self._on_project_activated(config)
+
+    def _on_delete_response(self, _dialog, response_id: str, config) -> None:
+        if response_id != "delete":
+            return
+
+        if delete_project(config.name):
+            logger.info(f"Deleted project: {config.name}")
+            self.refresh()
+            if self._on_project_deleted:
+                self._on_project_deleted(config)
+        else:
+            error = Adw.MessageDialog.new(
+                self.get_root(),
+                "Could not delete",
+                f"Project '{config.name}' was not found on disk.",
+            )
+            error.add_response("ok", "OK")
+            error.present()