sqlite-opus 0.2.0__tar.gz → 0.3.0__tar.gz

{sqlite_opus-0.2.0/sqlite_opus.egg-info → sqlite_opus-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlite-opus
-Version: 0.2.0
+Version: 0.3.0
 Summary: A Flask-based web dashboard for SQLite database query and management
 Author-email: Your Name <hungle2048@gmail.com>
 License: MIT
@@ -99,9 +99,22 @@ dashboard.bind(
 ### Configuration Options
 
 - `url_prefix`: URL prefix for dashboard routes (default: `"sqlite-opus"`)
-- `max_query_results`: Maximum number of query results to return (default: `1000`)
-- `query_results_per_page`: Rows per page for paginated SELECT results (default: `50`)
+- `db_path`: Path to a SQLite database file for auto-connect on startup
 - `enable_cors`: Enable CORS support (default: `True`)
+- `auth_user` / `auth_password`: HTTP Basic Auth for all dashboard routes (optional). When both are set, every request must supply valid credentials.
+- `allow_dml`: If `True`, allow write queries (INSERT/UPDATE/DELETE/CREATE/…). Default: `False` (read-only).
+
+**Security (production):** Use Basic Auth and keep `allow_dml` disabled in production for a more secure setup. Example:
+
+```python
+dashboard.bind(
+    app,
+    auth_user="admin",
+    auth_password="your-strong-password",
+    allow_dml=False,  # read-only
+    db_path="data.db",
+)
+```
 
 ## Features
 

{sqlite_opus-0.2.0 → sqlite_opus-0.3.0}/README.md

@@ -63,9 +63,22 @@ dashboard.bind(
 ### Configuration Options
 
 - `url_prefix`: URL prefix for dashboard routes (default: `"sqlite-opus"`)
-- `max_query_results`: Maximum number of query results to return (default: `1000`)
-- `query_results_per_page`: Rows per page for paginated SELECT results (default: `50`)
+- `db_path`: Path to a SQLite database file for auto-connect on startup
 - `enable_cors`: Enable CORS support (default: `True`)
+- `auth_user` / `auth_password`: HTTP Basic Auth for all dashboard routes (optional). When both are set, every request must supply valid credentials.
+- `allow_dml`: If `True`, allow write queries (INSERT/UPDATE/DELETE/CREATE/…). Default: `False` (read-only).
+
+**Security (production):** Use Basic Auth and keep `allow_dml` disabled in production for a more secure setup. Example:
+
+```python
+dashboard.bind(
+    app,
+    auth_user="admin",
+    auth_password="your-strong-password",
+    allow_dml=False,  # read-only
+    db_path="data.db",
+)
+```
 
 ## Features
 

{sqlite_opus-0.2.0 → sqlite_opus-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sqlite-opus"
-version = "0.2.0"
+version = "0.3.0"
 description = "A Flask-based web dashboard for SQLite database query and management"
 readme = "README.md"
 requires-python = ">=3.10"

{sqlite_opus-0.2.0 → sqlite_opus-0.3.0}/sqlite_opus/__init__.py

@@ -16,7 +16,7 @@ from flask import Blueprint
 from sqlite_opus.core import Config, get_templates_path, get_static_path
 from sqlite_opus.database import DatabaseManager
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"
 
 # Module-level configuration
 config = Config()
@@ -31,20 +31,34 @@ blueprint = Blueprint(
 )
 
 
-def bind(app, url_prefix: str = None, enable_cors: bool = True, max_query_results: int = 1000, query_results_per_page: int = None):
+def bind(
+    app,
+    url_prefix: str = None,
+    enable_cors: bool = True,
+    max_query_results: int = 1000,
+    query_results_per_page: int = None,
+    auth_user: str = None,
+    auth_password: str = None,
+    allow_dml: bool = None,
+    db_path: str = None,
+):
     """
     Bind SQLite Opus dashboard to a Flask application.
-    
+
     This function should be called after creating your Flask app but before
     running it. It will register all dashboard routes and initialize the
     database manager.
-    
+
     Args:
         app: Flask application instance to bind the dashboard to
         url_prefix: URL prefix for dashboard routes (default: "sqlite-opus")
         enable_cors: Enable CORS support (default: True)
         max_query_results: Maximum number of query results to return (default: 1000)
         query_results_per_page: Rows per page for paginated SELECT results (default: 50)
+        auth_user: Basic Auth username for dashboard routes (optional). If set with auth_password, enables HTTP Basic Auth.
+        auth_password: Basic Auth password for dashboard routes (optional).
+        allow_dml: If True, allow DML (INSERT/UPDATE/DELETE/...) in query API (default: False).
+        db_path: Path to SQLite database file for auto-connect (optional). Can also set via config.db_path before bind().
 
     Example:
         >>> from flask import Flask
@@ -52,10 +66,13 @@ def bind(app, url_prefix: str = None, enable_cors: bool = True, max_query_result
         >>> app = Flask(__name__)
         >>> dashboard.bind(app)
         >>> app.run()
+
+    Example with Basic Auth (works when package is installed in other projects):
+        >>> dashboard.bind(app, auth_user="admin", auth_password="secret", db_path="db.sqlite3")
     """
     # Store app reference in config
     config.app = app
-    
+
     # Update configuration
     if url_prefix is not None:
         config.url_prefix = url_prefix
@@ -63,6 +80,14 @@ def bind(app, url_prefix: str = None, enable_cors: bool = True, max_query_result
     config.max_query_results = max_query_results
     if query_results_per_page is not None:
         config.query_results_per_page = query_results_per_page
+    if auth_user is not None:
+        config.auth_user = auth_user
+    if auth_password is not None:
+        config.auth_password = auth_password
+    if allow_dml is not None:
+        config.allow_dml = allow_dml
+    if db_path is not None:
+        config.db_path = db_path
 
     # Initialize database manager and attach to app
     if not hasattr(app, "sqlite_opus_db_manager"):

{sqlite_opus-0.2.0 → sqlite_opus-0.3.0}/sqlite_opus/routes.py

@@ -1,5 +1,7 @@
 """Flask routes for SQLite Opus dashboard."""
 
+import csv
+import io
 import re
 from functools import wraps
 from flask import Blueprint, render_template, request, jsonify, Flask, Response
@@ -83,18 +85,6 @@ def register_routes(bp: Blueprint, app: Flask):
         tables = db_manager.get_tables()
         return jsonify({"success": True, "tables": tables})
     
-    @bp.route("/api/table/<table_name>", methods=["GET"])
-    def get_table_info(table_name):
-        """Get schema, columns, and indexes for a specific table (single hash)."""
-        db_manager = app.sqlite_opus_db_manager
-        if not db_manager.is_connected():
-            return jsonify({"success": False, "error": "Not connected"}), 400
-        
-        schema = db_manager.get_table_schema(table_name)
-        if not schema.get("success"):
-            return jsonify(schema), 404
-        return jsonify(schema)
-
     @bp.route("/api/table/<table_name>/columns", methods=["GET"])
     def get_table_columns_partial(table_name):
         """Return HTML partial for table columns (for HTMX or fetch-and-inject)."""
@@ -121,6 +111,24 @@ def register_routes(bp: Blueprint, app: Flask):
             indexes=indexes,
         )
 
+    @bp.route("/api/table/<table_name>/", methods=["GET"])
+    def get_table_info_partial(table_name):
+        """Return HTML with out-of-band swaps for columns, indexes, and schema (one request, three panel updates)."""
+        db_manager = app.sqlite_opus_db_manager
+        if not db_manager.is_connected() or not table_name:
+            return "", 400
+        columns = db_manager.get_all_columns(table_name)
+        indexes = db_manager.get_indexes(table_name)
+        schema_result = db_manager.get_table_schema(table_name)
+        schema = (schema_result.get("schema") or "").strip() if schema_result.get("success") else ""
+        return render_template(
+            "sqlite_opus/partials/table_info.html",
+            table_name=table_name,
+            columns=columns,
+            indexes=indexes,
+            schema=schema,
+        )
+
     def get_query_result(query, page=None, per_page=None):
         """Run query and return result dict for the partial template."""
         db_manager = app.sqlite_opus_db_manager
@@ -201,6 +209,37 @@ def register_routes(bp: Blueprint, app: Flask):
             page_numbers=page_numbers,
         )
 
+    @bp.route("/api/query/export", methods=["POST"])
+    def export_query_csv():
+        """Run the current SELECT query and return results as CSV download."""
+        data = request.get_json() or {}
+        query = (data.get("query") or "").strip()
+        if not query:
+            return jsonify({"success": False, "error": "Query required"}), 400
+        if not query.upper().startswith("SELECT"):
+            return jsonify({"success": False, "error": "Only SELECT queries can be exported as CSV"}), 400
+        if contains_dml(query) and not config.allow_dml:
+            return jsonify({
+                "success": False,
+                "error": "DML queries are not allowed. Set config.allow_dml = True to enable.",
+            }), 400
+        result = get_query_result(query, page=None, per_page=None)
+        if not result.get("success"):
+            return jsonify({"success": False, "error": result.get("error", "Query failed")}), 400
+        columns = result.get("columns", [])
+        results = result.get("results", [])
+        buf = io.StringIO()
+        writer = csv.writer(buf)
+        writer.writerow(columns)
+        for row in results:
+            writer.writerow([row.get(col) for col in columns])
+        csv_str = buf.getvalue()
+        return Response(
+            csv_str,
+            mimetype="text/csv",
+            headers={"Content-Disposition": "attachment; filename=export.csv"},
+        )
+
 def basic_auth_required(f):
     """Require HTTP Basic Auth if config.auth_user and config.auth_password are set."""
     @wraps(f)

sqlite_opus-0.3.0/sqlite_opus/static/app.js

@@ -0,0 +1,217 @@
+// Basic JavaScript for SQLite Opus Dashboard
+
+// API helper functions
+async function apiRequest(url, method = 'GET', data = null) {
+    const options = {
+        method: method,
+        headers: {
+            'Content-Type': 'application/json',
+        }
+    };
+    
+    if (data) {
+        options.body = JSON.stringify(data);
+    }
+    
+    const response = await fetch(url, options);
+    return response.json();
+}
+
+// Connection management (only if connection panel exists)
+const statusBanner = document.getElementById('app-status-banner');
+const statusMessageEl = document.getElementById('app-status-message');
+
+// Currently selected table (for export)
+let selectedTableName = null;
+
+// Query type select: insert template into query editor
+const queryTypeSnippets = {
+    select: 'SELECT * FROM table_name;',
+    insert: 'INSERT INTO table_name (column1, column2) VALUES (?, ?);',
+    update: 'UPDATE table_name SET column1 = ? WHERE ;',
+    delete: 'DELETE FROM table_name WHERE ;',
+    truncate: 'DELETE FROM table_name;',
+    replace: 'REPLACE INTO table_name (column1) VALUES (?);',
+};
+
+const queryTypeSelect = document.getElementById('query-type-select');
+const queryEditorEl = document.getElementById('query-editor');
+if (queryTypeSelect && queryEditorEl) {
+    queryTypeSelect.addEventListener('change', function () {
+        const value = this.value;
+        if (!value || !queryTypeSnippets[value]) return;
+        let snippet = queryTypeSnippets[value];
+        const table = selectedTableName || 'table_name';
+        snippet = snippet.replace(/table_name/g, table);
+        queryEditorEl.value = snippet;
+        queryEditorEl.focus();
+        queryTypeSelect.value = '';
+    });
+}
+
+const loadingMsg = '<p class="empty-message"><i class="fas fa-spinner fa-spin"></i> Loading...</p>';
+
+// HTMX: before table info request — set selected table, query editor, show loading, flag for tab switch
+let pendingTableInfoLoad = false;
+document.body.addEventListener('htmx:beforeRequest', (e) => {
+    const elt = e.detail?.elt;
+    if (!elt?.classList?.contains('table-item') || !elt?.getAttribute?.('hx-get')) return;
+    pendingTableInfoLoad = true;
+    const tableName = elt.dataset?.tableName;
+    if (tableName) {
+        selectedTableName = tableName;
+        const queryEditor = document.getElementById('query-editor');
+        if (queryEditor) queryEditor.value = `SELECT * FROM ${tableName};`;
+    }
+    const schemaContainer = document.getElementById('table-schema-container');
+    const columnsContainer = document.getElementById('table-columns-container');
+    const indexesContainer = document.getElementById('table-indexes-container');
+    if (schemaContainer) schemaContainer.innerHTML = loadingMsg;
+    if (columnsContainer) columnsContainer.innerHTML = loadingMsg;
+    if (indexesContainer) indexesContainer.innerHTML = loadingMsg;
+});
+document.body.addEventListener('htmx:afterSettle', () => {
+    if (!pendingTableInfoLoad) return;
+    pendingTableInfoLoad = false;
+    const schemaTab = document.getElementById('schema-tab');
+    const isSchemaActive = schemaTab && schemaTab.classList.contains('active');
+    if (schemaTab && isSchemaActive) schemaTab.click();
+});
+
+// Query results via Flask partial
+let lastQuery = '';
+let lastPerPage = 10;
+
+async function fetchQueryPartial(query, page, perPage) {
+    const res = await fetch('api/query/', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ query: query, page: page || 1, per_page: perPage || 50 }),
+    });
+    const html = await res.text();
+    return html;
+}
+
+function renderQueryResults(html) {
+    const area = document.getElementById('query-results-area');
+    if (area) area.innerHTML = html;
+}
+
+// Execute query (page 1) – fetch HTML partial and inject
+document.getElementById('execute-btn').addEventListener('click', async () => {
+    const query = document.getElementById('query-editor').value.trim();
+    if (!query) {
+        showStatus('Please enter a query', 'error');
+        const area = document.getElementById('query-results-area');
+        if (area) {
+            area.innerHTML = '<div id="results-container" class="results-container"><p class="empty-message">Please enter a query above.</p></div><div id="pagination-bar" class="pagination-bar" style="display: none;"></div>';
+        }
+        return;
+    }
+    lastQuery = query;
+    const hiddenLastQuery = document.getElementById('last-executed-query');
+    if (hiddenLastQuery) {
+        hiddenLastQuery.value = query;
+    }
+    lastPerPage = 10;
+    try {
+        const html = await fetchQueryPartial(query, 1, lastPerPage);
+        renderQueryResults(html);
+    } catch (err) {
+        showStatus('Request failed: ' + err.message, 'error');
+    }
+});
+
+// Clear query (also clear last executed query so export uses fresh results)
+document.getElementById('clear-btn').addEventListener('click', () => {
+    document.getElementById('query-editor').value = '';
+    lastQuery = '';
+    const hiddenLastQuery = document.getElementById('last-executed-query');
+    if (hiddenLastQuery) {
+        hiddenLastQuery.value = '';
+    }
+});
+
+// Pagination: delegate on query-results-area so it works after partial inject
+document.getElementById('query-results-area').addEventListener('click', async (e) => {
+    const btn = e.target.closest('.pagination-btn');
+    if (!btn || !lastQuery) return;
+    const page = parseInt(btn.dataset.page, 10);
+    if (isNaN(page)) return;
+    try {
+        const html = await fetchQueryPartial(lastQuery, page, lastPerPage);
+        renderQueryResults(html);
+    } catch (err) {
+        showStatus('Request failed: ' + err.message, 'error');
+    }
+});
+
+// Export result of last executed query as CSV (uses same query as the results table)
+async function exportTableToCsv() {
+    const hiddenLastQuery = document.getElementById('last-executed-query');
+    const query = hiddenLastQuery ? hiddenLastQuery.value.trim() : '';
+    if (!query) {
+        if (typeof showStatus === 'function') showStatus('Execute a query first to export results', 'error');
+        return;
+    }
+    if (!query.toUpperCase().startsWith('SELECT')) {
+        if (typeof showStatus === 'function') showStatus('Only SELECT queries can be exported as CSV', 'error');
+        return;
+    }
+    const exportBtn = document.getElementById('export-csv-btn');
+    if (exportBtn) exportBtn.disabled = true;
+    try {
+        const res = await fetch('api/query/export', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ query }),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({}));
+            if (typeof showStatus === 'function') showStatus(err.error || 'Export failed', 'error');
+            return;
+        }
+        const blob = await res.blob();
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        const csvFilename = selectedTableName ? `${selectedTableName}_export.csv` : 'export.csv';
+        a.download = csvFilename;
+        a.click();
+        URL.revokeObjectURL(url);
+        if (typeof showStatus === 'function') showStatus('CSV exported successfully', 'success');
+    } catch (err) {
+        if (typeof showStatus === 'function') showStatus('Export failed: ' + err.message, 'error');
+    } finally {
+        if (exportBtn) exportBtn.disabled = false;
+    }
+}
+
+const exportCsvBtn = document.getElementById('export-csv-btn');
+if (exportCsvBtn) {
+    exportCsvBtn.addEventListener('click', exportTableToCsv);
+}
+
+// Show status message in top banner (only visible when called; hides after 5s or on dismiss)
+function showStatus(message, type) {
+    if (!statusBanner || !statusMessageEl) return;
+    statusMessageEl.textContent = message;
+    statusBanner.className = `app-status-banner app-status-banner--${type}`;
+    statusBanner.hidden = false;
+    const hide = () => {
+        statusBanner.hidden = true;
+    };
+    clearTimeout(showStatus._timeout);
+    showStatus._timeout = setTimeout(hide, 5000);
+}
+
+// Check connection status on load
+window.addEventListener('load', async () => {
+    const status = await apiRequest('api/status');
+    if (status.connected) {
+        const executeBtn = document.getElementById('execute-btn');
+        const exportCsvBtn = document.getElementById('export-csv-btn');
+        if (executeBtn) executeBtn.disabled = false;
+        if (exportCsvBtn) exportCsvBtn.disabled = false;
+    }
+});

{sqlite_opus-0.2.0 → sqlite_opus-0.3.0}/sqlite_opus/static/style.css

@@ -263,25 +263,27 @@ body {
     cursor: not-allowed;
 }
 
-.status-message {
-    padding: 10px;
-    border-radius: 4px;
-    margin-top: 10px;
-    display: none;
+.app-status-banner {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 12px;
+    padding: 12px 16px;
+    width: 100%;
+    box-sizing: border-box;
 }
-
-.status-message.success {
-    background-color: #d4edda;
-    color: #155724;
-    border: 1px solid #c3e6cb;
-    display: block;
+.app-status-banner[hidden] {
+    display: none !important;
 }
-
-.status-message.error {
+.app-status-banner--error {
     background-color: #f8d7da;
     color: #721c24;
-    border: 1px solid #f5c6cb;
-    display: block;
+    border-bottom: 1px solid #f5c6cb;
+}
+.app-status-banner--success {
+    background-color: #d4edda;
+    color: #155724;
+    border-bottom: 1px solid #c3e6cb;
 }
 
 .tables-list {
@@ -312,7 +314,6 @@ body {
     margin-top: 0;
 }
 
-.table-columns-panel,
 .table-indexes-panel {
     margin-top: 1.5rem;
 }

{sqlite_opus-0.2.0 → sqlite_opus-0.3.0}/sqlite_opus/templates/sqlite_opus/index.html

@@ -41,7 +41,13 @@
                     <div id="tables-list" class="tables-list">
                         {% if tables %}
                         {% for table in tables %}
-                        <div class="table-item" data-table-name="{{ table }}" title="Click to view schema"><i class="fas fa-table"></i> {{ table }}</div>
+                        <div class="table-item"
+                             data-table-name="{{ table }}"
+                             title="Click to view schema"
+                             hx-get="{{ url_for(blueprint_name ~ '.get_table_info_partial', table_name=table) }}"
+                             hx-trigger="click"
+                             hx-target="body"
+                             hx-swap="none"><i class="fas fa-table"></i> {{ table }}</div>
                         {% endfor %}
                         {% else %}
                         <p class="empty-message">Connect to a database to see tables</p>
@@ -62,6 +68,9 @@
                 {% endif %}
 
                 {% if has_preconfigured_db %}
+                    <div id="app-status-banner" class="app-status-banner" role="alert" aria-live="polite" hidden>
+                        <span id="app-status-message"></span>
+                    </div>
                     <!-- Tabs: Table Schema | Query & Results -->
                     <ul class="nav nav-tabs mb-3" id="dashboardTabs" role="tablist">
                         <li class="nav-item" role="presentation">
@@ -102,12 +111,25 @@
                         <!-- Tab 2: Query & Results -->
                         <div class="tab-pane show active" id="query-pane" role="tabpanel" aria-labelledby="query-tab">
                             <section class="panel query-panel">
-                                <h2>Query Editor</h2>
+                                <div class="panel-header panel-header--with-actions">
+                                    <h2>Query Editor</h2>
+                                    <select id="query-type-select" class="form-select form-select-sm" style="width: auto; min-width: 140px;" aria-label="Insert query template">
+                                        <option value="">Select query...</option>
+                                        <option value="select">SELECT</option>
+                                        <option value="insert">INSERT</option>
+                                        <option value="update">UPDATE</option>
+                                        <option value="delete">DELETE</option>
+                                        <option value="truncate">TRUNCATE</option>
+                                        <option value="replace">REPLACE</option>
+                                    </select>
+                                </div>
                                 <textarea 
                                     id="query-editor" 
                                     placeholder="Enter your SQL query here..."
                                     rows="9"
                                 ></textarea>
+                                <!-- Hidden field to store last executed query for export/persistence -->
+                                <input type="hidden" id="last-executed-query" value="">
                                 <div class="button-group">
                                     <button id="execute-btn" class="btn btn-primary" disabled>Execute Query</button>
                                     <button id="clear-btn" class="btn btn-secondary">Clear</button>
@@ -117,7 +139,7 @@
                             <section class="panel results-panel mt-2">
                                 <div class="panel-header panel-header--with-actions">
                                     <h2>Query Results</h2>
-                                    <button type="button" id="export-csv-btn" class="btn btn-outline-primary btn-sm" disabled title="Export selected table to CSV">
+                                    <button type="button" id="export-csv-btn" class="btn btn-outline-primary btn-sm" disabled title="Export current SELECT query result as CSV">
                                         <i class="fas fa-file-csv me-1"></i> Export CSV
                                     </button>
                                 </div>
@@ -135,6 +157,8 @@
         </div>
     </div>
 
+    <!-- HTMX 2.x -->
+    <script src="https://unpkg.com/htmx.org@2.0.4/dist/htmx.min.js" crossorigin="anonymous"></script>
     <!-- Bootstrap 5 JS bundle (for tabs) -->
     <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/js/bootstrap.bundle.min.js" crossorigin="anonymous"></script>
     <script src="{{ url_for(blueprint_name ~ '.static', filename='app.js') }}"></script>

sqlite_opus-0.3.0/sqlite_opus/templates/sqlite_opus/partials/table_info.html

@@ -0,0 +1,11 @@
+{# Combined HTMX response: one no-op main swap + three out-of-band swaps for columns, indexes, schema #}
+<div></div>
+<div id="table-columns-container" hx-swap-oob="true" class="table-columns-container">
+    {% include "sqlite_opus/partials/table_columns.html" %}
+</div>
+<div id="table-indexes-container" hx-swap-oob="true" class="table-indexes-container">
+    {% include "sqlite_opus/partials/table_indexes.html" %}
+</div>
+<div id="table-schema-container" hx-swap-oob="true" class="table-schema-container">
+    {% include "sqlite_opus/partials/table_schema.html" %}
+</div>

sqlite_opus-0.3.0/sqlite_opus/templates/sqlite_opus/partials/table_schema.html

@@ -0,0 +1,7 @@
+{# Flask partial: table schema (CREATE statement) #}
+<p class="schema-table-name"><strong>{{ table_name }}</strong></p>
+{% if not schema or not schema.strip() %}
+<p class="empty-message">No schema information</p>
+{% else %}
+<pre class="schema-sql"><code>{{ schema.strip() | e }}</code></pre>
+{% endif %}

{sqlite_opus-0.2.0 → sqlite_opus-0.3.0/sqlite_opus.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlite-opus
-Version: 0.2.0
+Version: 0.3.0
 Summary: A Flask-based web dashboard for SQLite database query and management
 Author-email: Your Name <hungle2048@gmail.com>
 License: MIT
@@ -99,9 +99,22 @@ dashboard.bind(
 ### Configuration Options
 
 - `url_prefix`: URL prefix for dashboard routes (default: `"sqlite-opus"`)
-- `max_query_results`: Maximum number of query results to return (default: `1000`)
-- `query_results_per_page`: Rows per page for paginated SELECT results (default: `50`)
+- `db_path`: Path to a SQLite database file for auto-connect on startup
 - `enable_cors`: Enable CORS support (default: `True`)
+- `auth_user` / `auth_password`: HTTP Basic Auth for all dashboard routes (optional). When both are set, every request must supply valid credentials.
+- `allow_dml`: If `True`, allow write queries (INSERT/UPDATE/DELETE/CREATE/…). Default: `False` (read-only).
+
+**Security (production):** Use Basic Auth and keep `allow_dml` disabled in production for a more secure setup. Example:
+
+```python
+dashboard.bind(
+    app,
+    auth_user="admin",
+    auth_password="your-strong-password",
+    allow_dml=False,  # read-only
+    db_path="data.db",
+)
+```
 
 ## Features
 

{sqlite_opus-0.2.0 → sqlite_opus-0.3.0}/sqlite_opus.egg-info/SOURCES.txt

@@ -18,4 +18,6 @@ sqlite_opus/static/style.css
 sqlite_opus/templates/sqlite_opus/index.html
 sqlite_opus/templates/sqlite_opus/partials/query_results.html
 sqlite_opus/templates/sqlite_opus/partials/table_columns.html
-sqlite_opus/templates/sqlite_opus/partials/table_indexes.html
+sqlite_opus/templates/sqlite_opus/partials/table_indexes.html
+sqlite_opus/templates/sqlite_opus/partials/table_info.html
+sqlite_opus/templates/sqlite_opus/partials/table_schema.html

sqlite_opus-0.2.0/sqlite_opus/static/app.js

@@ -1,202 +0,0 @@
-// Basic JavaScript for SQLite Opus Dashboard
-
-// API helper functions
-async function apiRequest(url, method = 'GET', data = null) {
-    const options = {
-        method: method,
-        headers: {
-            'Content-Type': 'application/json',
-        }
-    };
-    
-    if (data) {
-        options.body = JSON.stringify(data);
-    }
-    
-    const response = await fetch(url, options);
-    return response.json();
-}
-
-// Connection management (only if connection panel exists)
-const statusEl = document.getElementById('connection-status');
-
-async function loadTableInfo(table_name) {
-    const result = await apiRequest(`api/table/${encodeURIComponent(table_name)}`, 'GET');
-    if (result.success) {
-        return result;
-    }
-    return null;
-}
-
-function displayTableSchema(schemaString, tableName) {
-    const container = document.getElementById('table-schema-container');
-    if (!container) return;
-
-    if (!schemaString || typeof schemaString !== 'string') {
-        container.innerHTML = '<p class="empty-message">No schema information</p>';
-        return;
-    }
-
-    const trimmed = schemaString.trim();
-    if (!trimmed) {
-        container.innerHTML = '<p class="empty-message">No schema information</p>';
-        return;
-    }
-
-    let html = `<p class="schema-table-name"><strong>${escapeHtml(tableName)}</strong></p>`;
-    html += '<pre class="schema-sql"><code>' + escapeHtml(trimmed) + '</code></pre>';
-    container.innerHTML = html;
-}
-
-function escapeHtml(text) {
-    const div = document.createElement('div');
-    div.textContent = text;
-    return div.innerHTML;
-}
-
-// Currently selected table (for export)
-let selectedTableName = null;
-
-// Click on table name: load and display schema, columns, indexes
-document.getElementById('tables-list').addEventListener('click', async (e) => {
-    const item = e.target.closest('.table-item');
-    if (!item) return;
-    const tableName = item.dataset.tableName;
-    if (!tableName) return;
-
-    selectedTableName = tableName;
-    const exportBtn = document.getElementById('export-csv-btn');
-    if (exportBtn) exportBtn.disabled = false;
-
-    // Insert SELECT query into query editor when user clicks a table
-    const queryEditor = document.getElementById('query-editor');
-    if (queryEditor) {
-        queryEditor.value = `SELECT * FROM ${tableName};`;
-    }
-
-    const loadingMsg = '<p class="empty-message"><i class="fas fa-spinner fa-spin"></i> Loading...</p>';
-    const schemaContainer = document.getElementById('table-schema-container');
-    const columnsContainer = document.getElementById('table-columns-container');
-    const indexesContainer = document.getElementById('table-indexes-container');
-    if (schemaContainer) schemaContainer.innerHTML = loadingMsg;
-    if (columnsContainer) columnsContainer.innerHTML = loadingMsg;
-    if (indexesContainer) indexesContainer.innerHTML = loadingMsg;
-
-    // Only switch to schema tab if it is not already active
-    const schemaTab = document.getElementById('schema-tab');
-    const isSchemaActive = schemaTab && schemaTab.classList.contains('active');
-    if (schemaTab && isSchemaActive) {
-        schemaTab.click();
-    }
-
-    const [info, columnsHtml, indexesHtml] = await Promise.all([
-        loadTableInfo(tableName),
-        fetch(`api/table/${encodeURIComponent(tableName)}/columns`).then(r => r.ok ? r.text() : ''),
-        fetch(`api/table/${encodeURIComponent(tableName)}/indexes`).then(r => r.ok ? r.text() : ''),
-    ]);
-
-    if (columnsContainer) columnsContainer.innerHTML = columnsHtml || '<p class="error-message">Failed to load columns</p>';
-    if (indexesContainer) indexesContainer.innerHTML = indexesHtml || '<p class="error-message">Failed to load indexes</p>';
-
-    if (info === null) {
-        const errMsg = '<p class="error-message">Failed to load table info</p>';
-        if (schemaContainer) schemaContainer.innerHTML = errMsg;
-    } else {
-        displayTableSchema(info.schema ?? null, tableName);
-    }
-});
-
-// Query results via Flask partial
-let lastQuery = '';
-let lastPerPage = 10;
-
-async function fetchQueryPartial(query, page, perPage) {
-    const res = await fetch('api/query/', {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ query: query, page: page || 1, per_page: perPage || 50 }),
-    });
-    const html = await res.text();
-    return html;
-}
-
-function renderQueryResults(html) {
-    const area = document.getElementById('query-results-area');
-    if (area) area.innerHTML = html;
-}
-
-// Execute query (page 1) – fetch HTML partial and inject
-document.getElementById('execute-btn').addEventListener('click', async () => {
-    const query = document.getElementById('query-editor').value.trim();
-    if (!query) {
-        showStatus('Please enter a query', 'error');
-        const area = document.getElementById('query-results-area');
-        if (area) {
-            area.innerHTML = '<div id="results-container" class="results-container"><p class="empty-message">Please enter a query above.</p></div><div id="pagination-bar" class="pagination-bar" style="display: none;"></div>';
-        }
-        return;
-    }
-    lastQuery = query;
-    lastPerPage = 10;
-    try {
-        const html = await fetchQueryPartial(query, 1, lastPerPage);
-        renderQueryResults(html);
-    } catch (err) {
-        showStatus('Request failed: ' + err.message, 'error');
-    }
-});
-
-// Clear query
-document.getElementById('clear-btn').addEventListener('click', () => {
-    document.getElementById('query-editor').value = '';
-});
-
-// Pagination: delegate on query-results-area so it works after partial inject
-document.getElementById('query-results-area').addEventListener('click', async (e) => {
-    const btn = e.target.closest('.pagination-btn');
-    if (!btn || !lastQuery) return;
-    const page = parseInt(btn.dataset.page, 10);
-    if (isNaN(page)) return;
-    try {
-        const html = await fetchQueryPartial(lastQuery, page, lastPerPage);
-        renderQueryResults(html);
-    } catch (err) {
-        showStatus('Request failed: ' + err.message, 'error');
-    }
-});
-
-// Export selected table as CSV via API
-async function exportTableToCsv() {
-    if (!selectedTableName) {
-        if (typeof showStatus === 'function') showStatus('Select a table first', 'error');
-        return;
-    }
-    // const exportBtn = document.getElementById('export-csv-btn');
-    // if (exportBtn) exportBtn.disabled = true;
-    // call api/table/${encodeURIComponent(selectedTableName)}/export
-}
-
-const exportCsvBtn = document.getElementById('export-csv-btn');
-if (exportCsvBtn) {
-    exportCsvBtn.addEventListener('click', exportTableToCsv);
-}
-
-// Show status message
-function showStatus(message, type) {
-    if (statusEl) {
-        statusEl.textContent = message;
-        statusEl.className = `status-message ${type}`;
-        
-        setTimeout(() => {
-            statusEl.className = 'status-message';
-        }, 5000);
-    }
-}
-
-// Check connection status on load
-window.addEventListener('load', async () => {
-    const status = await apiRequest('api/status');
-    if (status.connected) {
-        document.getElementById('execute-btn').disabled = false;
-    }
-});