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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vector-inspector
-Version: 0.3.7
+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
@@ -31,13 +31,40 @@ Requires-Dist: pgvector>=0.4.2
 Description-Content-Type: text/markdown
 
 # Latest updates
-* Added automatic update notification system:
-	- Checks for new releases on GitHub once per launch/day
-	- Shows update indicator in the status bar and Help menu
-	- Clickable indicator opens a modal with release notes and update instructions
-	- Manual Check for Update in Help menu
-	- Version detection now uses installed package metadata for accuracy
-* Fixed bug where data browser row disappeared post-edit
+
+- 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
+
 ---
 
 # Vector Inspector
@@ -45,7 +72,7 @@ Description-Content-Type: text/markdown
 > **Disclaimer:** This tool is currently under active development and is **not production ready**. Not all features have been thoroughly tested and code is released frequently. Use with caution in critical or production environments.
 
 [![CI](https://github.com/anthonypdawson/vector-inspector/actions/workflows/ci-tests.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/ci-tests.yml)
-[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish.yml)
+[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml)
 
 [![PyPI Version](https://img.shields.io/pypi/v/vector-inspector.svg?cacheSeconds=300)](https://pypi.org/project/vector-inspector/)
 [![PyPI Downloads](https://static.pepy.tech/personalized-badge/vector-inspector?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/vector-inspector)
@@ -74,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.7 → vector_inspector-0.3.9}/README.md

@@ -1,11 +1,38 @@
 # Latest updates
-* Added automatic update notification system:
-	- Checks for new releases on GitHub once per launch/day
-	- Shows update indicator in the status bar and Help menu
-	- Clickable indicator opens a modal with release notes and update instructions
-	- Manual Check for Update in Help menu
-	- Version detection now uses installed package metadata for accuracy
-* Fixed bug where data browser row disappeared post-edit
+
+- 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
+
 ---
 
 # Vector Inspector
@@ -13,7 +40,7 @@
 > **Disclaimer:** This tool is currently under active development and is **not production ready**. Not all features have been thoroughly tested and code is released frequently. Use with caution in critical or production environments.
 
 [![CI](https://github.com/anthonypdawson/vector-inspector/actions/workflows/ci-tests.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/ci-tests.yml)
-[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish.yml)
+[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml)
 
 [![PyPI Version](https://img.shields.io/pypi/v/vector-inspector.svg?cacheSeconds=300)](https://pypi.org/project/vector-inspector/)
 [![PyPI Downloads](https://static.pepy.tech/personalized-badge/vector-inspector?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/vector-inspector)
@@ -42,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.7 → vector_inspector-0.3.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "vector-inspector"
-version = "0.3.7"
+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.7 → 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/core/provider_factory.py

@@ -0,0 +1,97 @@
+"""Factory for creating vector database connections from provider configs."""
+
+from typing import Dict, Any
+from vector_inspector.core.connections.base_connection import VectorDBConnection
+from vector_inspector.core.connections.chroma_connection import ChromaDBConnection
+from vector_inspector.core.connections.qdrant_connection import QdrantConnection
+from vector_inspector.core.connections.pinecone_connection import PineconeConnection
+from vector_inspector.core.connections.pgvector_connection import PgVectorConnection
+
+
+class ProviderFactory:
+    """Factory for creating database connections from configuration."""
+
+    @staticmethod
+    def create(
+        provider: str, config: Dict[str, Any], credentials: Dict[str, Any] = None
+    ) -> VectorDBConnection:
+        """Create a connection object for the specified provider.
+
+        Args:
+            provider: Provider type (chromadb, qdrant, pinecone, pgvector)
+            config: Provider-specific configuration
+            credentials: Optional credentials (API keys, passwords, etc.)
+
+        Returns:
+            VectorDBConnection instance
+
+        Raises:
+            ValueError: If provider is unsupported or configuration is invalid
+        """
+        credentials = credentials or {}
+
+        if provider == "chromadb":
+            return ProviderFactory._create_chroma(config, credentials)
+        elif provider == "qdrant":
+            return ProviderFactory._create_qdrant(config, credentials)
+        elif provider == "pinecone":
+            return ProviderFactory._create_pinecone(config, credentials)
+        elif provider == "pgvector":
+            return ProviderFactory._create_pgvector(config, credentials)
+        else:
+            raise ValueError(f"Unsupported provider: {provider}")
+
+    @staticmethod
+    def _create_chroma(config: Dict[str, Any], credentials: Dict[str, Any]) -> ChromaDBConnection:
+        """Create a ChromaDB connection."""
+        conn_type = config.get("type")
+
+        if conn_type == "persistent":
+            return ChromaDBConnection(path=config.get("path"))
+        elif conn_type == "http":
+            return ChromaDBConnection(host=config.get("host"), port=config.get("port"))
+        else:  # ephemeral
+            return ChromaDBConnection()
+
+    @staticmethod
+    def _create_qdrant(config: Dict[str, Any], credentials: Dict[str, Any]) -> QdrantConnection:
+        """Create a Qdrant connection."""
+        conn_type = config.get("type")
+        api_key = credentials.get("api_key")
+
+        if conn_type == "persistent":
+            return QdrantConnection(path=config.get("path"))
+        elif conn_type == "http":
+            return QdrantConnection(
+                host=config.get("host"), port=config.get("port"), api_key=api_key
+            )
+        else:  # ephemeral
+            return QdrantConnection()
+
+    @staticmethod
+    def _create_pinecone(config: Dict[str, Any], credentials: Dict[str, Any]) -> PineconeConnection:
+        """Create a Pinecone connection."""
+        api_key = credentials.get("api_key")
+        if not api_key:
+            raise ValueError("Pinecone requires an API key")
+
+        return PineconeConnection(api_key=api_key)
+
+    @staticmethod
+    def _create_pgvector(config: Dict[str, Any], credentials: Dict[str, Any]) -> PgVectorConnection:
+        """Create a PgVector/Postgres connection."""
+        conn_type = config.get("type")
+
+        if conn_type == "http":
+            host = config.get("host", "localhost")
+            port = int(config.get("port", 5432))
+            database = config.get("database")
+            user = config.get("user")
+            # Prefer password from credentials
+            password = credentials.get("password")
+
+            return PgVectorConnection(
+                host=host, port=port, database=database, user=user, password=password
+            )
+
+        raise ValueError("Unsupported connection type for PgVector profile")

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.7 → 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.7 → vector_inspector-0.3.9}/src/vector_inspector/ui/components/splash_window.py

@@ -34,10 +34,22 @@ class SplashWindow(QDialog):
         layout.addWidget(github)
 
         # About info (reuse About dialog text)
-        from vector_inspector.ui.main_window import get_about_html
+        from vector_inspector.utils.version import get_app_version
 
         about = QTextBrowser()
-        about.setHtml(get_about_html())
+        version = get_app_version()
+        version_html = (
+            f"<h2>Vector Inspector {version}</h2>" if version else "<h2>Vector Inspector</h2>"
+        )
+        about_text = (
+            version_html + "<p>A comprehensive desktop application for visualizing, "
+            "querying, and managing multiple vector databases simultaneously.</p>"
+            '<p><a href="https://github.com/anthonypdawson/vector-inspector" style="color:#2980b9;">GitHub Project Page</a></p>'
+            "<hr />"
+            "<p>Built with PySide6</p>"
+            "<p><b>New:</b> Pinecone support!</p>"
+        )
+        about.setHtml(about_text)
         about.setOpenExternalLinks(True)
         about.setMaximumHeight(160)
         layout.addWidget(about)

vector_inspector-0.3.9/src/vector_inspector/ui/controllers/__init__.py

@@ -0,0 +1 @@
+"""UI controllers for managing application logic."""