vector-inspector 0.3.8__tar.gz → 0.3.9__tar.gz

{vector_inspector-0.3.8 → vector_inspector-0.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vector-inspector
-Version: 0.3.8
+Version: 0.3.9
 Summary: A comprehensive desktop application for visualizing, querying, and managing vector database data
 Author-Email: Anthony Dawson <anthonypdawson+github@gmail.com>
 License: MIT
@@ -32,29 +32,38 @@ Description-Content-Type: text/markdown
 
 # Latest updates
 
-## Vector Inspector 2026.01 Release Notes
-
-### Major Refactor and Studio-Ready Architecture
-- Refactored main window into modular components:
-  - InspectorShell: reusable UI shell (splitter, tabs, layout)
-  - ProviderFactory: centralized connection creation
-  - DialogService: dialog management
-  - ConnectionController: connection lifecycle and threading
-  - InspectorTabs: pluggable tab registry
-- MainWindow now inherits from InspectorShell and is fully reusable as a widget
-- Bootstrap logic is separated from UI logic—Studio can host Inspector as a component
-- Tab system is now pluggable: Studio and Inspector can add, remove, or override tabs via TabDefinition
-- All Inspector UI logic is self-contained; Studio can extend without modifying Inspector code
-
-### Data Browser Improvements
-- Added a checkbox: Generate embeddings on edit (default: checked)
-  - When unchecked, editing a row skips embedding regeneration
-  - Setting is persisted per user
-
-### Developer and Architecture Notes
-- All modules pass syntax checks and are ready for Studio integration
-- No breaking changes for existing Inspector users
-- Inspector is now a true UI module, not just an application
+- Major refactor and studio-ready architecture
+  - Refactored main window into modular components (InspectorShell, ProviderFactory, DialogService, ConnectionController, InspectorTabs)
+  - MainWindow is reusable as a widget; tab system is pluggable so Studio can extend or override tabs
+
+- Data browser improvements
+  - Added Generate embeddings on edit (persisted per user)
+
+- Settings / Preferences
+  - SettingsService persists preferences and exposes typed accessors (breadcrumb, search defaults, auto-embed, window geometry)
+  - SettingsService emits a setting_changed Qt signal so UI reacts immediately
+  - SettingsDialog (modal) added with add_section API and hook integration for extension panels
+  - Breadcrumb controls moved out of core so Pro (Vector Studio) injects them via the settings_panel_hook
+
+- Extension hook for settings panels
+  - *settings_panel_hook* added to *vector_inspector.extensions*; Vector Studio registers breadcrumb controls at startup
+
+- Breadcrumb and UI improvements
+  - Breadcrumb label now elides long trails (left/middle) and shows full trail on hover
+  - SearchView supports runtime elide-mode changes and responds to settings signals
+
+- Window geometry persistence
+  - Main window saves/restores geometry when window.restore_geometry is enabled
+
+- Pro (Vector Studio) features
+  - *Search Similar* (Pro): right-click any row in Data Browser or Search Results to run a vector-to-vector similarity search
+  - *table_context_menu* handler hardened for many embedding/id formats and includes fallbacks
+  - Vector Studio injects breadcrumb controls into Settings dialog via *settings_panel_hook*
+
+- Tests and CI
+  - Added *tests/test_settings_injection.py* to assert settings panel hook registration
+  - Updated context-menu tests to use *log_info* and *assert* for pytest
+  - Local test run: 5 tests passed; GUI-heavy suite ~9s due to PySide6 startup
 
 ---
 
@@ -92,6 +101,8 @@ Vector Inspector bridges the gap between vector databases and user-friendly data
 
 ## Key Features
 
+> **Note:** Some features listed below may be not started or currently in progress.
+
 ### 1. **Multi-Provider Support**
 - Connect to vector databases:
   - ChromaDB (persistent local storage)

{vector_inspector-0.3.8 → vector_inspector-0.3.9}/README.md

@@ -1,28 +1,37 @@
 # Latest updates
 
-## Vector Inspector 2026.01 Release Notes
-
-### Major Refactor and Studio-Ready Architecture
-- Refactored main window into modular components:
-  - InspectorShell: reusable UI shell (splitter, tabs, layout)
-  - ProviderFactory: centralized connection creation
-  - DialogService: dialog management
-  - ConnectionController: connection lifecycle and threading
-  - InspectorTabs: pluggable tab registry
-- MainWindow now inherits from InspectorShell and is fully reusable as a widget
-- Bootstrap logic is separated from UI logic—Studio can host Inspector as a component
-- Tab system is now pluggable: Studio and Inspector can add, remove, or override tabs via TabDefinition
-- All Inspector UI logic is self-contained; Studio can extend without modifying Inspector code
-
-### Data Browser Improvements
-- Added a checkbox: Generate embeddings on edit (default: checked)
-  - When unchecked, editing a row skips embedding regeneration
-  - Setting is persisted per user
-
-### Developer and Architecture Notes
-- All modules pass syntax checks and are ready for Studio integration
-- No breaking changes for existing Inspector users
-- Inspector is now a true UI module, not just an application
+- Major refactor and studio-ready architecture
+  - Refactored main window into modular components (InspectorShell, ProviderFactory, DialogService, ConnectionController, InspectorTabs)
+  - MainWindow is reusable as a widget; tab system is pluggable so Studio can extend or override tabs
+
+- Data browser improvements
+  - Added Generate embeddings on edit (persisted per user)
+
+- Settings / Preferences
+  - SettingsService persists preferences and exposes typed accessors (breadcrumb, search defaults, auto-embed, window geometry)
+  - SettingsService emits a setting_changed Qt signal so UI reacts immediately
+  - SettingsDialog (modal) added with add_section API and hook integration for extension panels
+  - Breadcrumb controls moved out of core so Pro (Vector Studio) injects them via the settings_panel_hook
+
+- Extension hook for settings panels
+  - *settings_panel_hook* added to *vector_inspector.extensions*; Vector Studio registers breadcrumb controls at startup
+
+- Breadcrumb and UI improvements
+  - Breadcrumb label now elides long trails (left/middle) and shows full trail on hover
+  - SearchView supports runtime elide-mode changes and responds to settings signals
+
+- Window geometry persistence
+  - Main window saves/restores geometry when window.restore_geometry is enabled
+
+- Pro (Vector Studio) features
+  - *Search Similar* (Pro): right-click any row in Data Browser or Search Results to run a vector-to-vector similarity search
+  - *table_context_menu* handler hardened for many embedding/id formats and includes fallbacks
+  - Vector Studio injects breadcrumb controls into Settings dialog via *settings_panel_hook*
+
+- Tests and CI
+  - Added *tests/test_settings_injection.py* to assert settings panel hook registration
+  - Updated context-menu tests to use *log_info* and *assert* for pytest
+  - Local test run: 5 tests passed; GUI-heavy suite ~9s due to PySide6 startup
 
 ---
 
@@ -60,6 +69,8 @@ Vector Inspector bridges the gap between vector databases and user-friendly data
 
 ## Key Features
 
+> **Note:** Some features listed below may be not started or currently in progress.
+
 ### 1. **Multi-Provider Support**
 - Connect to vector databases:
   - ChromaDB (persistent local storage)

{vector_inspector-0.3.8 → vector_inspector-0.3.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "vector-inspector"
-version = "0.3.8"
+version = "0.3.9"
 description = "A comprehensive desktop application for visualizing, querying, and managing vector database data"
 authors = [
     { name = "Anthony Dawson", email = "anthonypdawson+github@gmail.com" },

{vector_inspector-0.3.8 → vector_inspector-0.3.9}/src/vector_inspector/core/connections/pgvector_connection.py

@@ -5,6 +5,8 @@ import json
 import psycopg2
 from psycopg2 import sql
 
+from vector_inspector.core.logging import log_info
+
 ## No need to import register_vector; pgvector extension is enabled at table creation
 from vector_inspector.core.connections.base_connection import VectorDBConnection
 from vector_inspector.core.logging import log_error, log_info
@@ -1043,12 +1045,35 @@ class PgVectorConnection(VectorDBConnection):
         Returns:
             List of floats
         """
+        log_info("[pgvector] _parse_vector raw value: %r (type: %s)", vector_str, type(vector_str))
         if isinstance(vector_str, list):
+            log_info("[pgvector] _parse_vector: already list, len=%d", len(vector_str))
             return vector_str
+        # Handle numpy arrays
+        try:
+            import numpy as np
+
+            if isinstance(vector_str, np.ndarray):
+                log_info("[pgvector] _parse_vector: numpy array, shape=%s", vector_str.shape)
+                return vector_str.tolist()
+        except ImportError:
+            pass
         if isinstance(vector_str, str):
             # Remove brackets and split by comma
             vector_str = vector_str.strip("[]")
-            return [float(x) for x in vector_str.split(",")]
+            if not vector_str:
+                log_info("[pgvector] _parse_vector: empty string after strip")
+                return []
+            try:
+                parsed = [float(x) for x in vector_str.split(",")]
+                log_info("[pgvector] _parse_vector: parsed list of len %d", len(parsed))
+                return parsed
+            except Exception as e:
+                log_info(
+                    "[pgvector] _parse_vector: failed to parse '%s' with error: %s", vector_str, e
+                )
+                return []
+        log_info("[pgvector] _parse_vector: unhandled type %s, returning []", type(vector_str))
         return []
 
     def compute_embeddings_for_documents(

vector_inspector-0.3.9/src/vector_inspector/extensions/__init__.py

@@ -0,0 +1,105 @@
+"""Extension points for Vector Inspector.
+
+This module provides hooks and callbacks that allow pro versions
+or plugins to extend core functionality without modifying the base code.
+"""
+
+from typing import Any, ClassVar
+from collections.abc import Callable
+from PySide6.QtWidgets import QMenu, QTableWidget
+
+
+class TableContextMenuHook:
+    """Hook for adding custom context menu items to table widgets."""
+
+    _handlers: ClassVar[list[Callable]] = []
+
+    @classmethod
+    def register(cls, handler: Callable):
+        """Register a context menu handler.
+
+        Args:
+            handler: Callable that takes (menu: QMenu, table: QTableWidget, row: int, data: Dict)
+                    and adds menu items to the menu.
+        """
+        if handler not in cls._handlers:
+            cls._handlers.append(handler)
+
+    @classmethod
+    def unregister(cls, handler: Callable):
+        """Unregister a context menu handler."""
+        if handler in cls._handlers:
+            cls._handlers.remove(handler)
+
+    @classmethod
+    def trigger(
+        cls,
+        menu: QMenu,
+        table: QTableWidget,
+        row: int,
+        data: dict[str, Any] | None = None,
+    ):
+        """Trigger all registered handlers.
+
+        Args:
+            menu: The QMenu to add items to
+            table: The QTableWidget that was right-clicked
+            row: The row number that was clicked
+            data: Optional data dictionary with context (ids, documents, metadatas, etc.)
+        """
+        for handler in cls._handlers:
+            try:
+                handler(menu, table, row, data)
+            except Exception as e:
+                # Log but don't break if a handler fails
+                from vector_inspector.core.logging import log_error
+
+                log_error("Context menu handler error: %s", e)
+
+    @classmethod
+    def clear(cls):
+        """Clear all registered handlers."""
+        cls._handlers.clear()
+
+
+# Global singleton instance
+table_context_menu_hook = TableContextMenuHook()
+
+
+class SettingsPanelHook:
+    """Hook for adding custom sections to the Settings/Preferences dialog."""
+
+    _handlers: ClassVar[list[Callable]] = []
+
+    @classmethod
+    def register(cls, handler: Callable):
+        """Register a settings panel provider.
+
+        Handler signature: (parent_layout, settings_service, dialog)
+        where `parent_layout` is a QLayout the handler can add widgets to.
+        """
+        if handler not in cls._handlers:
+            cls._handlers.append(handler)
+
+    @classmethod
+    def unregister(cls, handler: Callable):
+        if handler in cls._handlers:
+            cls._handlers.remove(handler)
+
+    @classmethod
+    def trigger(cls, parent_layout, settings_service, dialog=None):
+        for handler in cls._handlers:
+            try:
+                handler(parent_layout, settings_service, dialog)
+            except Exception as e:
+                from vector_inspector.core.logging import log_error
+
+                log_error("Settings panel handler error: %s", e)
+
+    @classmethod
+    def clear(cls):
+        cls._handlers.clear()
+
+
+# Global singleton instance
+settings_panel_hook = SettingsPanelHook()

{vector_inspector-0.3.8 → vector_inspector-0.3.9}/src/vector_inspector/services/settings_service.py

@@ -1,6 +1,8 @@
 """Service for persisting application settings."""
 
 import json
+import base64
+from PySide6.QtCore import QObject, Signal
 from pathlib import Path
 from typing import Dict, Any, Optional, List
 from vector_inspector.core.cache_manager import invalidate_cache_on_settings_change
@@ -12,6 +14,18 @@ class SettingsService:
 
     def __init__(self):
         """Initialize settings service."""
+
+        # Expose a shared QObject-based signal emitter so UI can react to
+        # settings changes without polling.
+        class _Signals(QObject):
+            setting_changed = Signal(str, object)
+
+        # singleton-like per-process signals instance
+        try:
+            self.signals
+        except Exception:
+            self.signals = _Signals()
+
         self.settings_dir = Path.home() / ".vector-inspector"
         self.settings_file = self.settings_dir / "settings.json"
         self.settings: Dict[str, Any] = {}
@@ -51,6 +65,62 @@ class SettingsService:
         """Get a setting value."""
         return self.settings.get(key, default)
 
+    # Convenience accessors for common settings
+    def get_breadcrumb_enabled(self) -> bool:
+        return bool(self.settings.get("breadcrumb.enabled", True))
+
+    def set_breadcrumb_enabled(self, enabled: bool):
+        self.set("breadcrumb.enabled", bool(enabled))
+
+    def get_breadcrumb_elide_mode(self) -> str:
+        return str(self.settings.get("breadcrumb.elide_mode", "left"))
+
+    def set_breadcrumb_elide_mode(self, mode: str):
+        if mode not in ("left", "middle"):
+            mode = "left"
+        self.set("breadcrumb.elide_mode", mode)
+
+    def get_default_n_results(self) -> int:
+        return int(self.settings.get("search.default_n_results", 10))
+
+    def set_default_n_results(self, n: int):
+        self.set("search.default_n_results", int(n))
+
+    def get_auto_generate_embeddings(self) -> bool:
+        return bool(self.settings.get("embeddings.auto_generate", True))
+
+    def set_auto_generate_embeddings(self, enabled: bool):
+        self.set("embeddings.auto_generate", bool(enabled))
+
+    def get_window_restore_geometry(self) -> bool:
+        return bool(self.settings.get("window.restore_geometry", True))
+
+    def set_window_restore_geometry(self, enabled: bool):
+        self.set("window.restore_geometry", bool(enabled))
+
+    def set_window_geometry(self, geometry_bytes: bytes):
+        """Save window geometry as base64 string."""
+        try:
+            if isinstance(geometry_bytes, str):
+                # assume base64 already
+                b64 = geometry_bytes
+            else:
+                b64 = base64.b64encode(bytes(geometry_bytes)).decode("ascii")
+            self.set("window.geometry", b64)
+        except Exception as e:
+            log_error("Failed to set window geometry: %s", e)
+
+    def get_window_geometry(self) -> Optional[bytes]:
+        """Return geometry bytes or None."""
+        try:
+            b64 = self.settings.get("window.geometry")
+            if not b64:
+                return None
+            return base64.b64decode(b64)
+        except Exception as e:
+            log_error("Failed to get window geometry: %s", e)
+            return None
+
     def get_cache_enabled(self) -> bool:
         """Get whether caching is enabled (default: True)."""
         return self.settings.get("cache_enabled", True)
@@ -74,6 +144,12 @@ class SettingsService:
         # Invalidate cache when settings change (only if cache is enabled)
         if key != "cache_enabled":  # Don't invalidate when toggling cache itself
             invalidate_cache_on_settings_change()
+        # Emit change signal for UI/reactive components
+        try:
+            # Emit the raw python object (value) for convenience
+            self.signals.setting_changed.emit(key, value)
+        except Exception:
+            pass
 
     def clear(self):
         """Clear all settings."""

vector_inspector-0.3.9/src/vector_inspector/ui/dialogs/settings_dialog.py

@@ -0,0 +1,124 @@
+from PySide6.QtWidgets import (
+    QDialog,
+    QVBoxLayout,
+    QHBoxLayout,
+    QLabel,
+    QCheckBox,
+    QComboBox,
+    QSpinBox,
+    QPushButton,
+)
+from PySide6.QtCore import Qt
+
+from vector_inspector.services.settings_service import SettingsService
+from vector_inspector.extensions import settings_panel_hook
+
+
+class SettingsDialog(QDialog):
+    """Modal settings dialog backed by SettingsService."""
+
+    def __init__(self, settings_service: SettingsService = None, parent=None):
+        super().__init__(parent)
+        self.setWindowTitle("Preferences")
+        self.settings = settings_service or SettingsService()
+        self._init_ui()
+        self._load_values()
+
+    def _init_ui(self):
+        layout = QVBoxLayout(self)
+
+        # Breadcrumb controls are provided by pro extensions (vector-studio)
+        # via the settings_panel_hook. Core does not add breadcrumb options.
+
+        # Search defaults
+        search_layout = QHBoxLayout()
+        search_layout.addWidget(QLabel("Default results:"))
+        self.default_results = QSpinBox()
+        self.default_results.setMinimum(1)
+        self.default_results.setMaximum(1000)
+        search_layout.addWidget(self.default_results)
+        layout.addLayout(search_layout)
+
+        # Embeddings
+        self.auto_embed_checkbox = QCheckBox("Auto-generate embeddings for new text")
+        layout.addWidget(self.auto_embed_checkbox)
+
+        # Window geometry
+        self.restore_geometry_checkbox = QCheckBox("Restore window size/position on startup")
+        layout.addWidget(self.restore_geometry_checkbox)
+
+        # Buttons
+        btn_layout = QHBoxLayout()
+        self.apply_btn = QPushButton("Apply")
+        self.ok_btn = QPushButton("OK")
+        self.cancel_btn = QPushButton("Cancel")
+        self.reset_btn = QPushButton("Reset to defaults")
+        btn_layout.addWidget(self.reset_btn)
+        btn_layout.addStretch()
+        btn_layout.addWidget(self.apply_btn)
+        btn_layout.addWidget(self.ok_btn)
+        btn_layout.addWidget(self.cancel_btn)
+        # Allow external extensions to add sections before the buttons
+        try:
+            # Handlers receive (parent_layout, settings_service, dialog)
+            settings_panel_hook.trigger(layout, self.settings, self)
+        except Exception:
+            pass
+
+        layout.addLayout(btn_layout)
+
+        # Signals
+        self.apply_btn.clicked.connect(self._apply)
+        self.ok_btn.clicked.connect(self._ok)
+        self.cancel_btn.clicked.connect(self.reject)
+        self.reset_btn.clicked.connect(self._reset_defaults)
+
+        # Immediate apply on change for some controls
+        self.default_results.valueChanged.connect(lambda v: self.settings.set_default_n_results(v))
+        self.auto_embed_checkbox.stateChanged.connect(
+            lambda s: self.settings.set_auto_generate_embeddings(bool(s))
+        )
+        self.restore_geometry_checkbox.stateChanged.connect(
+            lambda s: self.settings.set_window_restore_geometry(bool(s))
+        )
+
+        # Container for programmatic sections
+        self._extra_sections = []
+
+    def add_section(self, widget_or_layout):
+        """Programmatically add a section (widget or layout) to the dialog.
+
+        `widget_or_layout` can be a QWidget or QLayout. It will be added
+        immediately to the dialog's main layout.
+        """
+        try:
+            if hasattr(widget_or_layout, "setParent"):
+                # QWidget
+                self.layout().addWidget(widget_or_layout)
+            else:
+                # Assume QLayout
+                self.layout().addLayout(widget_or_layout)
+            self._extra_sections.append(widget_or_layout)
+        except Exception:
+            pass
+
+    def _load_values(self):
+        # Breadcrumb controls are not present in core dialog.
+        self.default_results.setValue(self.settings.get_default_n_results())
+        self.auto_embed_checkbox.setChecked(self.settings.get_auto_generate_embeddings())
+        self.restore_geometry_checkbox.setChecked(self.settings.get_window_restore_geometry())
+
+    def _apply(self):
+        # Values are already applied on change; ensure persistence and close
+        self.settings._save_settings()
+
+    def _ok(self):
+        self._apply()
+        self.accept()
+
+    def _reset_defaults(self):
+        # Reset to recommended defaults
+        self.default_results.setValue(10)
+        self.auto_embed_checkbox.setChecked(True)
+        self.restore_geometry_checkbox.setChecked(True)
+        self._apply()