search-api-webui 0.1.1__tar.gz → 0.1.2__tar.gz

{search_api_webui-0.1.1 → search_api_webui-0.1.2}/.gitignore

@@ -19,8 +19,11 @@ backend/static/
 user_config.json
 
 # IDE
-.idea/
-.vscode/
+.id*/
+.vs*/
+.co*/
+.tr*/
+.hi*/
 
 # Build artifacts
 build/

search_api_webui-0.1.2/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: search-api-webui
+Version: 0.1.2
+Summary: A Search API WebUI for Querit, You, and other search providers.
+Project-URL: Homepage, https://github.com/querit-ai/search-api-webui
+Project-URL: Repository, https://github.com/querit-ai/search-api-webui.git
+Project-URL: Issues, https://github.com/querit-ai/search-api-webui/issues
+Author: querit.ai
+License: MIT
+License-File: LICENSE
+Keywords: api,llm,querit,search,tool,webui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Flask
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.7
+Requires-Dist: flask-cors
+Requires-Dist: flask>=2.0.0
+Requires-Dist: jmespath
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: querit
+Requires-Dist: requests>=2.25.0
+Description-Content-Type: text/markdown
+
+# Search API WebUI
+
+A lightweight, local WebUI for testing and visualizing Search APIs (Querit, YDC, etc.).
+
+(images)
+
+## Features
+
+**Search**: Support for Querit, You.com, and generic Search APIs via configuration.
+**Performance Metrics**: Real-time display of request latency and payload size.
+**Visual Rendering**: Renders standard search results (Title, Snippet, URL) in a clean card layout.
+**Configurable**: Easy-to-edit providers.yaml to add or modify search providers.
+**Secure**: API Keys are stored locally in user_config.json and never committed.
+## Installation
+
+Use this method if you just want to run the tool without modifying the code.
+
+### Prerequisites
+
+Python 3.7+
+### Install via Pip
+
+```
+pip install search-api-webui
+```
+
+### Run the Server
+
+```
+search-api-webui
+```
+
+Open your browser at http://localhost:8889.
+
+## Development
+
+Use this method if you want to contribute to the code or build from source.
+
+### Prerequisites
+
+Python 3.7+
+Node.js & npm (for building the frontend)
+### Setup Steps
+
+**Clone the repository**
+```
+git clone https://github.com/querit-ai/search-api-webui.git
+cd search-api-webui
+```
+
+**Build Frontend**
+```
+cd frontend
+npm install
+npm run build
+cd …
+```
+
+**Install Backend (Editable Mode)**
+```
+pip install -e .
+```
+
+**Run the Server**
+```
+python -m backend.app
+```
+
+## Configuration
+
+### Add API Keys
+
+Open the WebUI settings page (click the gear icon).
+Enter your API Key for the selected provider (e.g., Querit).
+Keys are saved locally in user_config.json.
+### Add New Providers
+
+Edit providers.yaml in the root directory to add custom API endpoints. The system uses JMESPath to map JSON responses to the UI.
+
+```
+my_custom_search:
+url: “https://api.example.com/search”
+method: “GET”
+headers:
+Authorization: “Bearer {api_key}”
+params:
+q: “{query}”
+response_mapping:
+root_path: “data.items”
+fields:
+title: “title”
+url: “link”
+snippet: “snippet”
+```
+
+## License
+
+MIT License. See LICENSE for details.

search_api_webui-0.1.2/README.md

@@ -0,0 +1,98 @@
+# Search API WebUI
+
+A lightweight, local WebUI for testing and visualizing Search APIs (Querit, YDC, etc.).
+
+(images)
+
+## Features
+
+**Search**: Support for Querit, You.com, and generic Search APIs via configuration.
+**Performance Metrics**: Real-time display of request latency and payload size.
+**Visual Rendering**: Renders standard search results (Title, Snippet, URL) in a clean card layout.
+**Configurable**: Easy-to-edit providers.yaml to add or modify search providers.
+**Secure**: API Keys are stored locally in user_config.json and never committed.
+## Installation
+
+Use this method if you just want to run the tool without modifying the code.
+
+### Prerequisites
+
+Python 3.7+
+### Install via Pip
+
+```
+pip install search-api-webui
+```
+
+### Run the Server
+
+```
+search-api-webui
+```
+
+Open your browser at http://localhost:8889.
+
+## Development
+
+Use this method if you want to contribute to the code or build from source.
+
+### Prerequisites
+
+Python 3.7+
+Node.js & npm (for building the frontend)
+### Setup Steps
+
+**Clone the repository**
+```
+git clone https://github.com/querit-ai/search-api-webui.git
+cd search-api-webui
+```
+
+**Build Frontend**
+```
+cd frontend
+npm install
+npm run build
+cd …
+```
+
+**Install Backend (Editable Mode)**
+```
+pip install -e .
+```
+
+**Run the Server**
+```
+python -m backend.app
+```
+
+## Configuration
+
+### Add API Keys
+
+Open the WebUI settings page (click the gear icon).
+Enter your API Key for the selected provider (e.g., Querit).
+Keys are saved locally in user_config.json.
+### Add New Providers
+
+Edit providers.yaml in the root directory to add custom API endpoints. The system uses JMESPath to map JSON responses to the UI.
+
+```
+my_custom_search:
+url: “https://api.example.com/search”
+method: “GET”
+headers:
+Authorization: “Bearer {api_key}”
+params:
+q: “{query}”
+response_mapping:
+root_path: “data.items”
+fields:
+title: “title”
+url: “link”
+snippet: “snippet”
+```
+
+## License
+
+MIT License. See LICENSE for details.

{search_api_webui-0.1.1 → search_api_webui-0.1.2}/backend/app.py

@@ -1,5 +1,6 @@
 import json
 import os
+from pathlib import Path
 from flask import Flask, request, jsonify, send_from_directory
 from flask_cors import CORS
 from backend.providers import load_providers

{search_api_webui-0.1.1 → search_api_webui-0.1.2}/backend/providers/__init__.py

@@ -26,7 +26,7 @@ def load_providers(file_path='providers.yaml'):
         provider_type = conf.get('type', 'generic')
 
         # Instantiate specific provider based on type or name
-        if name == 'querit' or provider_type == 'querit_sdk':
+        if provider_type == 'querit_sdk':
             providers[name] = QueritSdkProvider(conf)
         else:
             providers[name] = GenericProvider(conf)

{search_api_webui-0.1.1 → search_api_webui-0.1.2}/backend/providers/generic.py

@@ -17,6 +17,9 @@ class GenericProvider(BaseProvider):
             config (dict): Configuration containing url, headers, params, and mapping rules.
         """
         self.config = config
+        self.session = requests.Session()  # Persistent connection session
+        self._connection_ready = False     # Connection ready status
+        self._last_url = None              # Last used URL tracker
 
     def _fill_template(self, template_obj, **kwargs):
         """
@@ -42,6 +45,31 @@ class GenericProvider(BaseProvider):
             return {k: self._fill_template(v, **kwargs) for k, v in template_obj.items()}
         return template_obj
 
+    def _ensure_connection(self, url, headers):
+        """
+        Pre-warm HTTPS connection and verify availability.
+        Uses lightweight HEAD request to verify connection without fetching response body.
+
+        Args:
+            url (str): Target URL
+            headers (dict): Request headers
+
+        Returns:
+            bool: Whether connection is ready
+        """
+        # Re-warm if URL changed or connection not ready
+        if url != self._last_url or not self._connection_ready:
+            try:
+                # Verify connection using HEAD request (no response body)
+                self.session.head(url, headers=headers, timeout=5)
+                self._connection_ready = True
+                self._last_url = url
+                print(f'  [Connection Pool] Connected to: {url}')
+            except Exception as e:
+                self._connection_ready = False
+                print(f'  [Connection Pool] Connection warm-up failed: {e}')
+                raise
+
     def search(self, query, api_key, **kwargs):
         # 1. Extract parameters with defaults
         limit = kwargs.get('limit', '10')
@@ -69,6 +97,18 @@ class GenericProvider(BaseProvider):
         print(f'[{self.config.get("name", "Unknown")}] Search:')
         print(f'  URL: {url} | Method: {method}')
         
+        # Ensure connection is pre-warmed (use HEAD request to verify availability)
+        # Pre-warming is not counted in request latency, only verifies connection
+        try:
+            self._ensure_connection(url, headers)
+        except Exception as e:
+            print(f"Connection Warm-up Error: {e}")
+            return {
+                "error": f"Connection failed: {str(e)}",
+                "results": [],
+                "metrics": {"latency_ms": 0, "size_bytes": 0}
+            }
+
         start_time = time.time()
 
         try:
@@ -78,10 +118,11 @@ class GenericProvider(BaseProvider):
             if json_body:
                 req_args['json'] = json_body
 
+            # Use Session to send request (connection is reused)
             if method.upper() == 'GET':
-                response = requests.get(url, **req_args)
+                response = self.session.get(url, **req_args)
             else:
-                response = requests.post(url, **req_args)
+                response = self.session.post(url, **req_args)
 
             response.raise_for_status()
         except Exception as e:

{search_api_webui-0.1.1 → search_api_webui-0.1.2}/providers.yaml

@@ -1,7 +1,18 @@
 querit:
-  type: "querit_sdk"
-  description: "Official Querit Search via Python SDK"
-  default_limit: 10
+  url: "https://api.querit.ai/v1/search"
+  method: "POST"
+  headers:
+    "Accept": "application/json"
+    "Authorization": "Bearer {api_key}"
+    "Content-Type": "application/json"
+  payload:
+    query: "{query}"
+  response_mapping:
+    root_path: "results.result"
+    fields:
+      title: "title"
+      url: "url"
+      snippet: "snippet"
 
 ydc_search:
   url: "https://ydc-index.io/v1/search"
@@ -17,3 +28,8 @@ ydc_search:
       title: "title"
       url: "url"
       snippet: "snippets[0] || description"
+
+querit_sdk:
+  type: "querit_sdk"
+  description: "Official Querit Search via Python SDK"
+  default_limit: 10

{search_api_webui-0.1.1 → search_api_webui-0.1.2}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "search-api-webui"
-version = "0.1.1"
+version = "0.1.2"
 description = "A Search API WebUI for Querit, You, and other search providers."
 readme = "README.md"
 requires-python = ">=3.7"
 license = { text = "MIT" }
 authors = [
-    { name = "Search API WebUI Team" }
+    { name = "querit.ai" }
 ]
 keywords = ["search", "api", "webui", "querit", "llm", "tool"]
 classifiers = [

search_api_webui-0.1.1/PKG-INFO

@@ -1,93 +0,0 @@
-Metadata-Version: 2.4
-Name: search-api-webui
-Version: 0.1.1
-Summary: A Search API WebUI for Querit, You, and other search providers.
-Project-URL: Homepage, https://github.com/querit-ai/search-api-webui
-Project-URL: Repository, https://github.com/querit-ai/search-api-webui.git
-Project-URL: Issues, https://github.com/querit-ai/search-api-webui/issues
-Author: Search API WebUI Team
-License: MIT
-License-File: LICENSE
-Keywords: api,llm,querit,search,tool,webui
-Classifier: Development Status :: 3 - Alpha
-Classifier: Framework :: Flask
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.7
-Requires-Dist: flask-cors
-Requires-Dist: flask>=2.0.0
-Requires-Dist: jmespath
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: querit
-Requires-Dist: requests>=2.25.0
-Description-Content-Type: text/markdown
-
-# Search API WebUI
-
-A lightweight, local WebUI for testing and visualizing Search APIs (Querit, YDC, etc.).
-
-## Features
-
-- 🔍 **Search**: Support for Querit, You.com, and generic Search APIs via configuration.
-- ⚡ **Performance Metrics**: Real-time display of request latency and payload size.
-- 🎨 **Visual Rendering**: Renders standard search results (Title, Snippet, URL) in a clean card layout.
-- 🛠️ **Configurable**: Easy-to-edit `providers.yaml` to add or modify search providers.
-- 🔒 **Secure**: API Keys are stored locally in `user_config.json` and never committed.
-
-## Quick Start
-
-### Prerequisites
-
-- Python 3.7+
-- Node.js & npm (for building the frontend)
-
-### Installation
-
-1. **Clone the repository**
-   ```bash
-   git clone https://github.com/querit-ai/search-api-webui.git
-   cd search-api-webui
-   ```
-2. **Build Frontend**
-   ```bash
-   cd frontend
-   npm install
-   npm run build
-   cd ..
-   ```
-3. **Install Backend**
-   ```bash
-   pip install -e .
-   ```
-
-### Usage
-**Run the server:**
-   ```bash
-   python -m backend.app
-   ```
-Or if you installed via pip:
-   ```bash
-   search-api-webui
-   ```
-
-Open your browser at http://localhost:8889.
-
-## Configuration
-### Add API Keys
-1. Open the WebUI settings page.
-2. Enter your API Key for the selected provider (e.g., Querit).
-3. Keys are saved locally in user_config.json.
-
-### Add New Providers
-Edit providers.yaml to add custom API endpoints. The system uses JMESPath to map JSON responses to the UI.
-```yaml
-my_custom_search:
-      url: "https://api.example.com/search"
-      method: "GET"
-      ...
-```
-## Development
-Backend: Flask (in backend/)
-Frontend: React + Vite (in frontend/)
-## License
-MIT License. See LICENSE for details.

search_api_webui-0.1.1/README.md

@@ -1,69 +0,0 @@
-# Search API WebUI
-
-A lightweight, local WebUI for testing and visualizing Search APIs (Querit, YDC, etc.).
-
-## Features
-
-- 🔍 **Search**: Support for Querit, You.com, and generic Search APIs via configuration.
-- ⚡ **Performance Metrics**: Real-time display of request latency and payload size.
-- 🎨 **Visual Rendering**: Renders standard search results (Title, Snippet, URL) in a clean card layout.
-- 🛠️ **Configurable**: Easy-to-edit `providers.yaml` to add or modify search providers.
-- 🔒 **Secure**: API Keys are stored locally in `user_config.json` and never committed.
-
-## Quick Start
-
-### Prerequisites
-
-- Python 3.7+
-- Node.js & npm (for building the frontend)
-
-### Installation
-
-1. **Clone the repository**
-   ```bash
-   git clone https://github.com/querit-ai/search-api-webui.git
-   cd search-api-webui
-   ```
-2. **Build Frontend**
-   ```bash
-   cd frontend
-   npm install
-   npm run build
-   cd ..
-   ```
-3. **Install Backend**
-   ```bash
-   pip install -e .
-   ```
-
-### Usage
-**Run the server:**
-   ```bash
-   python -m backend.app
-   ```
-Or if you installed via pip:
-   ```bash
-   search-api-webui
-   ```
-
-Open your browser at http://localhost:8889.
-
-## Configuration
-### Add API Keys
-1. Open the WebUI settings page.
-2. Enter your API Key for the selected provider (e.g., Querit).
-3. Keys are saved locally in user_config.json.
-
-### Add New Providers
-Edit providers.yaml to add custom API endpoints. The system uses JMESPath to map JSON responses to the UI.
-```yaml
-my_custom_search:
-      url: "https://api.example.com/search"
-      method: "GET"
-      ...
-```
-## Development
-Backend: Flask (in backend/)
-Frontend: React + Vite (in frontend/)
-## License
-MIT License. See LICENSE for details.