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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlite-opus
-Version: 0.2.0
+Version: 0.2.1
 Summary: A Flask-based web dashboard for SQLite database query and management
 Author-email: Your Name <hungle2048@gmail.com>
 License: MIT

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sqlite-opus"
-version = "0.2.0"
+version = "0.2.1"
 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.2.1}/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.2.1"
 
 # 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.2.1}/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
@@ -201,6 +203,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.2.0 → sqlite_opus-0.2.1}/sqlite_opus/static/app.js

@@ -65,8 +65,6 @@ document.getElementById('tables-list').addEventListener('click', async (e) => {
     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');
@@ -137,6 +135,10 @@ document.getElementById('execute-btn').addEventListener('click', async () => {
         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);
@@ -146,9 +148,14 @@ document.getElementById('execute-btn').addEventListener('click', async () => {
     }
 });
 
-// Clear query
+// 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
@@ -165,15 +172,45 @@ document.getElementById('query-results-area').addEventListener('click', async (e
     }
 });
 
-// Export selected table as CSV via API
+// Export result of last executed query as CSV (uses same query as the results table)
 async function exportTableToCsv() {
-    if (!selectedTableName) {
-        if (typeof showStatus === 'function') showStatus('Select a table first', 'error');
+    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;
-    // call api/table/${encodeURIComponent(selectedTableName)}/export
+    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');
@@ -197,6 +234,9 @@ function showStatus(message, type) {
 window.addEventListener('load', async () => {
     const status = await apiRequest('api/status');
     if (status.connected) {
-        document.getElementById('execute-btn').disabled = false;
+        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.2.1}/sqlite_opus/static/style.css

@@ -312,7 +312,6 @@ body {
     margin-top: 0;
 }
 
-.table-columns-panel,
 .table-indexes-panel {
     margin-top: 1.5rem;
 }

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

@@ -108,6 +108,8 @@
                                     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 +119,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>

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlite-opus
-Version: 0.2.0
+Version: 0.2.1
 Summary: A Flask-based web dashboard for SQLite database query and management
 Author-email: Your Name <hungle2048@gmail.com>
 License: MIT