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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vector-inspector
-Version: 0.3.7
+Version: 0.3.8
 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,31 @@ 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
+
+## 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
+
 ---
 
 # Vector Inspector
@@ -45,7 +63,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)

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

@@ -1,11 +1,29 @@
 # 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
+
+## 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
+
 ---
 
 # Vector Inspector
@@ -13,7 +31,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)

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

@@ -1,6 +1,6 @@
 [project]
 name = "vector-inspector"
-version = "0.3.7"
+version = "0.3.8"
 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/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.7 → vector_inspector-0.3.8}/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.8/src/vector_inspector/ui/controllers/__init__.py

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

vector_inspector-0.3.8/src/vector_inspector/ui/controllers/connection_controller.py

@@ -0,0 +1,177 @@
+"""Controller for managing connection lifecycle and threading."""
+
+from typing import Dict, Optional
+from PySide6.QtCore import QObject, Signal, QThread
+from PySide6.QtWidgets import QMessageBox, QWidget
+
+from vector_inspector.core.connection_manager import ConnectionManager, ConnectionState
+from vector_inspector.core.connections.base_connection import VectorDBConnection
+from vector_inspector.core.provider_factory import ProviderFactory
+from vector_inspector.services.profile_service import ProfileService
+from vector_inspector.ui.components.loading_dialog import LoadingDialog
+
+
+class ConnectionThread(QThread):
+    """Background thread for connecting to database."""
+
+    finished = Signal(bool, list, str)  # success, collections, error_message
+
+    def __init__(self, connection: VectorDBConnection):
+        super().__init__()
+        self.connection = connection
+
+    def run(self):
+        """Connect to database and get collections."""
+        try:
+            success = self.connection.connect()
+            if success:
+                collections = self.connection.list_collections()
+                self.finished.emit(True, collections, "")
+            else:
+                self.finished.emit(False, [], "Connection failed")
+        except Exception as e:
+            self.finished.emit(False, [], str(e))
+
+
+class ConnectionController(QObject):
+    """Controller for managing connection operations and lifecycle.
+
+    This handles:
+    - Creating connections from profiles
+    - Starting connection threads
+    - Handling connection results
+    - Managing loading dialogs
+    - Emitting signals for UI updates
+    """
+
+    connection_completed = Signal(
+        str, bool, list, str
+    )  # connection_id, success, collections, error
+
+    def __init__(
+        self,
+        connection_manager: ConnectionManager,
+        profile_service: ProfileService,
+        parent: Optional[QWidget] = None,
+    ):
+        super().__init__(parent)
+        self.connection_manager = connection_manager
+        self.profile_service = profile_service
+        self.parent_widget = parent
+
+        # State
+        self._connection_threads: Dict[str, ConnectionThread] = {}
+        self.loading_dialog = LoadingDialog("Loading...", parent)
+
+    def connect_to_profile(self, profile_id: str) -> bool:
+        """Connect to a profile.
+
+        Args:
+            profile_id: ID of the profile to connect to
+
+        Returns:
+            True if connection initiated successfully, False otherwise
+        """
+        profile_data = self.profile_service.get_profile_with_credentials(profile_id)
+        if not profile_data:
+            QMessageBox.warning(self.parent_widget, "Error", "Profile not found.")
+            return False
+
+        # Check connection limit
+        if self.connection_manager.get_connection_count() >= ConnectionManager.MAX_CONNECTIONS:
+            QMessageBox.warning(
+                self.parent_widget,
+                "Connection Limit",
+                f"Maximum number of connections ({ConnectionManager.MAX_CONNECTIONS}) reached. "
+                "Please close a connection first.",
+            )
+            return False
+
+        # Create connection
+        provider = profile_data["provider"]
+        config = profile_data["config"]
+        credentials = profile_data.get("credentials", {})
+
+        try:
+            # Create connection object using factory
+            connection = ProviderFactory.create(provider, config, credentials)
+
+            # Register with connection manager, using profile_id as connection_id for persistence
+            connection_id = self.connection_manager.create_connection(
+                name=profile_data["name"],
+                provider=provider,
+                connection=connection,
+                config=config,
+                connection_id=profile_data["id"],
+            )
+
+            # Update state to connecting
+            self.connection_manager.update_connection_state(
+                connection_id, ConnectionState.CONNECTING
+            )
+
+            # Connect in background thread
+            thread = ConnectionThread(connection)
+            thread.finished.connect(
+                lambda success, collections, error: self._on_connection_finished(
+                    connection_id, success, collections, error
+                )
+            )
+            self._connection_threads[connection_id] = thread
+            thread.start()
+
+            # Show loading dialog
+            self.loading_dialog.show_loading(f"Connecting to {profile_data['name']}...")
+            return True
+
+        except Exception as e:
+            QMessageBox.critical(
+                self.parent_widget, "Connection Error", f"Failed to create connection: {e}"
+            )
+            return False
+
+    def _on_connection_finished(
+        self, connection_id: str, success: bool, collections: list, error: str
+    ):
+        """Handle connection thread completion."""
+        self.loading_dialog.hide_loading()
+
+        # Clean up thread
+        thread = self._connection_threads.pop(connection_id, None)
+        if thread:
+            thread.wait()  # Wait for thread to fully finish
+            thread.deleteLater()
+
+        if success:
+            # Update state to connected
+            self.connection_manager.update_connection_state(
+                connection_id, ConnectionState.CONNECTED
+            )
+
+            # Mark connection as opened first (will show in UI)
+            self.connection_manager.mark_connection_opened(connection_id)
+
+            # Then update collections (UI item now exists to receive them)
+            self.connection_manager.update_collections(connection_id, collections)
+        else:
+            # Update state to error
+            self.connection_manager.update_connection_state(
+                connection_id, ConnectionState.ERROR, error
+            )
+
+            QMessageBox.warning(
+                self.parent_widget, "Connection Failed", f"Failed to connect: {error}"
+            )
+
+            # Remove the failed connection
+            self.connection_manager.close_connection(connection_id)
+
+        # Emit signal for UI updates
+        self.connection_completed.emit(connection_id, success, collections, error)
+
+    def cleanup(self):
+        """Clean up connection threads on shutdown."""
+        for thread in list(self._connection_threads.values()):
+            if thread.isRunning():
+                thread.quit()
+                thread.wait(1000)  # Wait up to 1 second